Attach to a thread

POST /api/v1/community/threads/{threadId}/attachments

Attaches files you already uploaded to a thread. An attachment can be attached once: a second call on the same id is refused.

Authorization

Role in the organization	This endpoint
`OWNER`	Allowed
`ADMIN`	Allowed
`MEMBER`	Conditional — the space must be in scope, and participation in progress

Requirement	Rule for this endpoint
Business role	None
Resource scope	Thread of the school attached to the API key
Participation	Same rule as posting in that space
Resource state	An archived space answers `400`

Path parameters

Parameter	Type	Required	Description
`threadId`	UUID	yes	Thread visible from the key's school

Request headers

Header	Required	Description
`x-api-key`	yes	API key created for this school
`Idempotency-Key`	yes	Caller-generated key
`X-Correlation-Id`	no	Caller correlation id, returned or generated

Request body

Field	Type	Required	Description
`attachmentIds`	UUID[]	yes	Ids returned by the upload endpoint, 5 per post at most

Example

bash

curl -X POST "$COHORTE_API_BASE_URL/api/v1/community/threads/$THREAD_ID/attachments" \
  -H "x-api-key: $COHORTE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"attachmentIds":["0f1c6d8a-2a5e-4f51-9d1e-7c4b2a9f3e10"]}'

Response

200 OK — the attachments are attached.
400 Bad Request — a missing or malformed attachmentIds, an archived space, an unknown or already attached id, or more than 5 attachments on the post.
403 Forbidden — the bearer cannot post in that space.
404 Not Found — the thread is unknown or belongs to another school.

Response fields

Field	Type	Nullable	Description
`data.threadId`	UUID	no	The thread that now carries them
`data.attached`	integer	no	Number of attachments attached

Example response

json

{
  "success": true,
  "data": {
    "threadId": "3f7b2c91-1d3e-4a77-b0a1-6c8d5e4f2a09", "attached": 1
  },
  "correlationId": "1b1f7a1e-6d54-4f0c-8f97-2b2a1a7f5d33"
}

Notes

The school comes from the verified key. An attachment id from another school matches nothing and the call is refused.
Attaching to a comment is not exposed: do it from the screen.

Upload an attachment

POST /api/v1/community/threads/{threadId}/attachments

Attaches files you already uploaded to a thread. An attachment can be attached once: a second call on the same id is refused.

Authorization

Role in the organization	This endpoint
`OWNER`	Allowed
`ADMIN`	Allowed
`MEMBER`	Conditional — the space must be in scope, and participation in progress

Requirement	Rule for this endpoint
Business role	None
Resource scope	Thread of the school attached to the API key
Participation	Same rule as posting in that space
Resource state	An archived space answers `400`

Path parameters

Parameter	Type	Required	Description
`threadId`	UUID	yes	Thread visible from the key's school

Request headers

Header	Required	Description
`x-api-key`	yes	API key created for this school
`Idempotency-Key`	yes	Caller-generated key
`X-Correlation-Id`	no	Caller correlation id, returned or generated

Request body

Field	Type	Required	Description
`attachmentIds`	UUID[]	yes	Ids returned by the upload endpoint, 5 per post at most

Example

bash

curl -X POST "$COHORTE_API_BASE_URL/api/v1/community/threads/$THREAD_ID/attachments" \
  -H "x-api-key: $COHORTE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"attachmentIds":["0f1c6d8a-2a5e-4f51-9d1e-7c4b2a9f3e10"]}'

Response

200 OK — the attachments are attached.
400 Bad Request — a missing or malformed attachmentIds, an archived space, an unknown or already attached id, or more than 5 attachments on the post.
403 Forbidden — the bearer cannot post in that space.
404 Not Found — the thread is unknown or belongs to another school.

Response fields

Field	Type	Nullable	Description
`data.threadId`	UUID	no	The thread that now carries them
`data.attached`	integer	no	Number of attachments attached

Example response

json

{
  "success": true,
  "data": {
    "threadId": "3f7b2c91-1d3e-4a77-b0a1-6c8d5e4f2a09", "attached": 1
  },
  "correlationId": "1b1f7a1e-6d54-4f0c-8f97-2b2a1a7f5d33"
}

Notes

The school comes from the verified key. An attachment id from another school matches nothing and the call is refused.
Attaching to a comment is not exposed: do it from the screen.

Upload an attachment

Attach to a thread

Attach to a thread

Authorization

Path parameters

Request headers

Request body

Example

Response

Response fields

Example response

Notes

Related

Authorization

Path parameters

Request headers

Request body

Example

Response

Response fields

Example response

Notes

Related