GetItDoneGetItDone Docs
API ReferenceAttachments

Register an uploaded attachment

POST
/v1/tasks/{task_id}/attachments

Phase 2 of the two-phase upload: attaches the uploaded file (by its file_key) to the task's CURRENT version — exactly how the in-app flow registers uploads after the presigned PUT. Supports the optional Idempotency-Key header for exactly-once retries.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A gid_ API key (Profile → API Keys) or an OAuth 2.1 access token.

Path Parameters

task_id*string

Task short id, e.g. T-123 (a bare 123 is also accepted on input).

Match^(?:T-)?[0-9]{1,12}$

Header Parameters

Idempotency-Key?string

Optional client-generated key (1-255 visible ASCII characters; a UUID works) making this POST safely retryable. Retrying with the SAME key and byte-identical body within 24h replays the stored first response (marked Idempotency-Replayed: true, never re-executed, never charged against quota). The same key with a different body answers 422 idempotency_key_reused; a retry racing the first execution answers 409 idempotency_in_progress. Omitting the header executes normally with no idempotency guarantee.

Length1 <= length <= 255

Request Body

application/json
  1. body

Phase 2 of the two-phase upload: register the uploaded file on the task.

file_name*string
Length1 <= length <= 255
file_key*string

The file_key returned by the upload endpoint.

Length1 <= length <= 1024
content_type*string
Length1 <= length <= 255
size*integer

File size in bytes as uploaded.

Range1 <= value <= 9007199254740991

Response Body

The registered attachment.

application/json
  1. response

A file attached to a task's current version. Fetch its bytes via the download-url endpoint.

id*string

Stable opaque attachment id.

file_name*string
content_type*string
size*integer

File size in bytes.

Range-9007199254740991 <= value <= 9007199254740991
created_at*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
Example Request
curl -X POST 'https://app.nowgetitdone.com/v1/tasks/T-123/attachments' \  -H 'Content-Type: application/json' \  -d '{  "file_name": "string",  "file_key": "string",  "content_type": "string",  "size": 1}'
Example Response
{  "id": "string",  "file_name": "screenshot.png",  "content_type": "image/png",  "size": 248312,  "created_at": "2019-08-24T14:15:22Z"}

List task attachments GET

Cursor-paginated attachments of the task's CURRENT version, newest first (metadata only — mint download URLs per attachment via the download-url endpoint).

Start an attachment upload POST

Phase 1 of the two-phase upload (the SAME presign flow the in-app uploader uses): declares the file and answers a short-lived presigned PUT URL plus the…