agency-board
POST /v1/agency/client/boards/{boardId}/requests
Raise a request with the agency.
Authentication
Send an API key as a bearer token. The endpoint checks agency.board.client_view; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/agency/client/boards/{boardId}/requests \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "title": <string> }'Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
⚖️ Owner ruling 2026-08-31 — a client may raise a card, in the board's single intake column and nowhere else. The request body carries a title and a body and nothing that could steer it elsewhere: the column and the visibility are set by the engine, not accepted and overridden, because a field accepted and overridden is a field somebody later stops overriding.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
boardId (path) | Uuid | Yes | Project board ID (UUIDv7). |
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
title | string | Yes | — |
body | string | No | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
id | Uuid | Yes | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
column_id | Uuid | Yes | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
title | string | Yes | — |
body | string | No | — |
due_at | string | No | — |
raised_by_us | boolean | No | Whether the client raised this card. Named from the READER's side, because this payload is only ever read by the client. |
created_at | string | No | — |
updated_at | string | No | — |
Errors this endpoint can return
401 · 403 · 404 · 422