Fetch one attachment, returning content shaped by its kind.
Recognized config keys: * include_content (bool, default True): set False to fetch only metadata * max_bytes (int, default 2 MB, hard cap 10 MB): guards binary payloads * force_binary (bool, default False): return base64 even for text/PDF * page_limit (int, default 50): for PDF text extraction
User APIhttps://productivity.mattering.io/api/user/v1/attachments/{attachment_id}/
Path parameters
Name
Type
attachment_id
str
Body keys (JSON)
Key
Required
Default
config
optional or conditional
none
space_id
optional or conditional
none
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Pagination
Accepts limit and offset and the server caps limit at 500. Check the response for a total or count field.
Recognized config keys: limit (optional, default 200, max 1000).
URL
User APIhttps://productivity.mattering.io/api/user/v1/tasks/{task_id}/attachments/
Path parameters
Name
Type
task_id
str
Body keys (JSON)
Key
Required
Default
config
optional or conditional
none
space_id
optional or conditional
none
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Pagination
Accepts limit and offset and the server caps limit at 1000. Check the response for a total or count field.
POSTtasks/{task_id}/attachments/request-upload/User API
Create a signed, time-limited upload URL for direct file upload.
Returns a URL that accepts a multipart POST with a file field. The URL embeds a signed token valid for 10 minutes: no JWT or session cookie is needed on the upload request itself.
This enables MCP / AI agents to upload files via a plain HTTP POST (e.g. curl -F file=@path) instead of passing base64 through tool-call arguments, which are corrupted by MCP transport past ~5 KB.
This read is not paginated. It returns at most 12 rows and does not report a total, so a result of exactly 12 may be truncated.
URL
User APIhttps://productivity.mattering.io/api/user/v1/tasks/{task_id}/attachments/request-upload/
Path parameters
Name
Type
task_id
str
Body keys (JSON)
Key
Required
Default
config
optional or conditional
none
space_id
optional or conditional
none
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Upload a file attachment from base64-encoded bytes.
Recognized config keys: * filename (required): original filename including extension * mime_type (optional): inferred from filename when omitted * data_base64 (required): base64-encoded file bytes (max ~10 MB)
This read is not paginated. It returns at most 8 rows and does not report a total, so a result of exactly 8 may be truncated.
URL
User APIhttps://productivity.mattering.io/api/user/v1/tasks/{task_id}/attachments/upload/
Path parameters
Name
Type
task_id
str
Body keys (JSON)
Key
Required
Default
config
optional or conditional
none
space_id
optional or conditional
none
user_id
optional or conditional
none
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
List comments on a task in chronological order (oldest first).
Recognized config keys: limit (optional, default 200), order (optional, "asc" for oldest-first or "desc" for newest-first; default "asc").
URL
User APIhttps://productivity.mattering.io/api/user/v1/tasks/{task_id}/comments/
Path parameters
Name
Type
task_id
str
Body keys (JSON)
Key
Required
Default
config
optional or conditional
none
space_id
optional or conditional
none
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Pagination
Accepts limit and offset and the server caps limit at 1000. Check the response for a total or count field.
List screen/video recordings on a task (metadata only).
Recordings are a DISTINCT model from attachments: the in-app screen recorder and the task-card video uploader write TaskRecording rows, which the attachment endpoints never surface. This is the read path that makes those uploads visible to MCP clients and lets automations resolve a worker-fetchable gcs_uri for each one.
Recognized config keys: limit (optional, default 200, max 1000).
URL
User APIhttps://productivity.mattering.io/api/user/v1/tasks/{task_id}/recordings/list/
Path parameters
Name
Type
task_id
str
Body keys (JSON)
Key
Required
Default
config
optional or conditional
none
space_id
optional or conditional
none
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Pagination
Accepts limit and offset and the server caps limit at 1000. Check the response for a total or count field.
We use strictly necessary cookies to run this site. With your permission we also use analytics cookies
(Google Analytics and our own visit tracking) to see which pages work. Read the
Cookie notice.