Task Attachments

List task attachments

GET/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/attachments

Lists safe attachment metadata for a visible Task.

Required scopes: task:read

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.taskId`required	`string:uuid` Task identifier.
`query.limit`	`integer` Maximum number of records to return. Defaults to 50 and is capped at 200.
`query.cursor`	`string` Cursor returned by page.nextCursor from the previous list response.

`data`	`object[]`
`data[].id`	`string:uuid` Task attachment identifier.
`data[].orgId`	`string:uuid` Organization identifier.
`data[].taskId`	`string:uuid` Parent Task identifier.
`data[].dayId`	`string:uuid` Associated Day identifier used for activity and sync.
`data[].fileName`	`string` Original attachment file name.
`data[].contentType`	`string` Attachment media type.
`data[].sizeBytes`	`integer` Attachment size in bytes.
`data[].createdBy`	`string:uuid` RoadOps user ID that added the attachment.
`data[].createdAt`	`string:date-time` UTC attachment creation timestamp.
`data[].isDeleted`	`boolean` Soft-delete flag.
`data[].version`	`integer` Current attachment aggregate version.
`data[].cursor`	`integer` Latest cursor projected into this attachment.
`page`	`object`
`page.limit`	`integer` Maximum number of records returned in this page.
`page.nextCursor`	`string \| null` Cursor to pass as the next request's cursor query parameter, or null when there are no more results.

POST/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/attachments/uploads

Returns a short-lived private upload URL for a Task attachment.

Required scopes: task:write

`fileName`required	`string` Original attachment file name.
`contentType`required	`string` Attachment media type.
`sizeBytes`required	`integer` Attachment size in bytes.

POST/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/attachments

Registers a successfully uploaded Task attachment.

Required scopes: task:write

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.taskId`required	`string:uuid` Task identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

`fileName`required	`string` Original attachment file name.
`contentType`required	`string` Attachment media type.
`sizeBytes`required	`integer` Attachment size in bytes.
`attachmentId`required	`string:uuid`
`storageKey`required	`string`

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

GET/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/attachments/{attachmentId}/download

Returns a short-lived private download URL.

Required scopes: task:read

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.taskId`required	`string:uuid` Task identifier.
`path.attachmentId`required	`string:uuid` Attachment identifier.

DELETE/v1/teams/{teamId}/days/{dayId}/tasks/{taskId}/attachments/{attachmentId}

Deletes Task attachment metadata.

Required scopes: task:write

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.taskId`required	`string:uuid` Task identifier.
`path.attachmentId`required	`string:uuid` Attachment identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.