agency-board
POST /v1/agency/boards/{boardId}/members
Put somebody on a board, or invite them by email.
Tabbatar da Asali
Aiko da maɓallin API a matsayin bearer token. Wannan ma'anar ba ta bayyana takamaiman izini ba a cikin ƙayyadaddun bayanai, don haka ba wa maɓallin ku mafi ƙarancin abin da yake buƙata kuma ku bincika amsar maimakon yin zato.
Wannan wurin ƙarewa ba ya buƙatar ID na ƙungiya. Maɓallin ku ya riga ya gano ƙungiyar da yake ciki, kuma an iyakance amsa a kanta.
Gwada
May gurbin komai da ke cikin kusurwa da ƙimar ka, kuma may gurbin maballi da maballi daga allon sarrafa ka.
curl -X POST https://api.zinndigital.com/v1/agency/boards/{boardId}/members \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "role": <string<manager, member, client>> }'An shiga? Na'urar sarrafa API da ke cikin sashin kulawarka tana cika ainihin lambar ƙungiyarka da maɓallinka naka, sannan tana gudanar da buƙatar a kan ainihin API don haka zaka iya ganin amsar gaske. Buɗe wannan tashar a cikin na'urar kula da API
Bayani
Give `user_id` for somebody who already has an account, or `email` to invite somebody who does not — the invitation goes through `tenancy.Invitation` and the person joins on acceptance, authenticated by Keycloak with no secret token in the flow. ⛔ A `client` seat may only be given to a member of the board's own client organisation, and **no seat is written for a pending invite**: a client's authorisation is a live membership of that organisation, re-read on every request, so a seat created before acceptance would look like access and confer none.
Sigogi
| Suna | Nau'i | Ana buƙata | Abin da yake |
|---|---|---|---|
boardId (path) | Uuid | Eh | Project board ID (UUIDv7). |
Jikin buƙata
| Suna | Nau'i | Ana buƙata | Abin da yake |
|---|---|---|---|
user_id | string | A'a | Somebody who already has an account. Give this **or** `email`, not both. |
email | string | A'a | Invite somebody who does not have an account yet. |
role | string<manager, member, client> | Eh | — |
member_org_id | string | A'a | Which organisation this seat belongs to. Ignored for a `client` seat, which is always the board's own client organisation. |
Martani
| Suna | Nau'i | Ana buƙata | Abin da yake |
|---|---|---|---|
id | Uuid | Eh | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
board_id | Uuid | Eh | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
user_id | Uuid | Eh | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
member_org_id | Uuid | Eh | The organisation this seat belongs to — the agency's, or the client's. |
role | string<manager, member, client> | Eh | — |
last_read_at | string | A'a | — |
created_at | string | A'a | — |
user | AgencyBoardActor | A'a | Who holds this seat, by name. ⛔ Render THIS, never `user_id` — the People drawer printed the id at a colleague's name until 2026-09-01 (`docs/425`). |
invited_by | AgencyBoardActor | A'a | — |
Kuskuren da wannan matsaya za ta iya maido wa
401 · 403 · 404 · 422