Post a thread

POST /api/v1/community/spaces/{spaceId}/threads

Posts a new thread in a space, as the key's holder. Attachments uploaded beforehand are attached in the same call.

Authorization

Path parameters

Request headers

Request body

Example

curl -X POST "$COHORTE_API_BASE_URL/api/v1/community/spaces/$SPACE_ID/threads" \
  -H "x-api-key: $COHORTE_API_KEY" \
  -H "Idempotency-Key: thread-welcome-autumn" \
  -H "Content-Type: application/json" \
  -d '{"title": "Welcome to the autumn cohort", "body": "Introduce yourself below."}'

Response

• 201 Created — the thread.
• 200 OK — replayed: true: the key was already used, the original thread comes back.
• 400 Bad Request — missing Idempotency-Key, invalid JSON, a title or body out of bounds, an archived space, or attachments that cannot be attached.
• 401 Unauthorized — missing, unknown or expired key.
• 403 Forbidden — the bearer has no enrollment in progress in the space's scope.
• 404 Not Found — the space is unknown or belongs to another school.

Response fields

Example response

{
  "success": true,
  "replayed": false,
  "data": {
    "id": "2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
    "spaceId": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
    "title": "Welcome to the autumn cohort",
    "body": "Introduce yourself below.",
    "authorUserId": "22222222-2222-4222-8222-222222222222",
    "createdAt": "2026-10-01T08:30:00.000Z"
  },
  "correlationId"

Notes

• community_thread.created is delivered to your webhook subscriptions.
• The thread is posted under the name of the key's holder: an agent posts as the person who created its key.

Related

• Reply to a thread
• Link a thread
• Upload an attachment