Attach files to a run

POST

/projects/:projectId/playbook-runs/:runId/files/attach

Links one or more pooled files to a playbook run (optionally a specific task). The body carries fileIds and an optional taskId. Returns which file ids attached vs. were skipped (missing / being deleted / pending approval). Requires file:write on the project.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Path parameters

projectIdstringRequired

runIdstringRequired

Request

This endpoint expects an object.

fileIdslist of stringsRequired

The pooled file ids to attach to the run.

taskIdstringOptional

Attach the files to a specific task.

Response

The attach outcome.

attachedlist of strings

skippedlist of strings

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

503

Service Unavailable Error

1	curl -X POST https:/https://api/projects/projectId/playbook-runs/runId/files/attach \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"fileIds": [
6	"f3a1c9e2-7b4d-4a2e-9f1c-2d3e4b5a6c7d",
7	"a9b8c7d6-e5f4-3a2b-1c0d-9e8f7a6b5c4d"
8	]
9	}'

1	{
2	"attached": [
3	"f3a1c9e2-7b4d-4a2e-9f1c-2d3e4b5a6c7d"
4	],
5	"skipped": [
6	"a9b8c7d6-e5f4-3a2b-1c0d-9e8f7a6b5c4d"
7	]
8	}