Skip to content
Skip to main content
POST
/v3/grants/{grant_id}/attachment-uploads/{attachment_id}/complete

Complete an attachment upload sessionBeta

Finalize an attachment upload session after the file has been uploaded to the pre-signed URL. Nylas verifies that the upload succeeded in storage and, if size was declared on session creation, that the uploaded byte count matches the declared size.

After completion, reference the attachment in a send or draft request by passing { "id": "<attachment_id>" } in the attachments array.

Retention note: By default, the uploaded file is deleted from storage when expires_at passes (one hour after session creation). Plan your send to occur inside this window. The attachment metadata row is retained for 60 days for observability.

For the full upload flow, see Send large attachments.

ACCESS TOKENNYLAS API KEY

Parameters

Path parameters

grant_id*string

The ID of the grant the upload session belongs to.

attachment_id*string

The ID of the attachment upload session to complete.

Responses

request_idstring
dataobject
POSThttps://api.us.nylas.com/v3/grants/{grant_id}/attachment-uploads/{attachment_id}/complete

Find your API key in the Nylas Dashboard under API Keys in your application settings.

grant_idrequiredstring

The ID of the grant the upload session belongs to.

attachment_idrequiredstring

The ID of the attachment upload session to complete.