agency-board

POST `/v1/agency/boards/{boardId}/members`

Put somebody on a board, or invite them by email.

Autentificare

Trimiteți o cheie API ca token de tip bearer. Acest punct final nu specifică o permisiune anume în specificație, așa că acordați cheii cele mai puține drepturi necesare și verificați răspunsul în loc să faceți presupuneri.

Acest endpoint nu necesită un ID de organizație. Cheia ta identifică deja organizația căreia îi aparține, iar răspunsul este limitat la aceasta.

Încearcă

Înlocuiți tot ce se află între paranteze unghiulare cu propriile valori și substituentul cheie cu o cheie din tabloul de bord.

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>> }'

Autentificat? Consola API din panoul de control îți completează ID-ul real al organizației și propria cheie și rulează cererea în API-ul live, astfel încât să poți vedea răspunsul efectiv. Deschideți acest punct final în consola API

Detalii

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.

Parametri

Nume	Tip	Obligatoriu	Ce este
`boardId (path)`	`Uuid`	Da	Project board ID (UUIDv7).

Corp cerere

Nume	Tip	Obligatoriu	Ce este
`user_id`	`string`	Nu	Somebody who already has an account. Give this or `email`, not both.
`email`	`string`	Nu	Invite somebody who does not have an account yet.
`role`	`string<manager, member, client>`	Da	—
`member_org_id`	`string`	Nu	Which organisation this seat belongs to. Ignored for a `client` seat, which is always the board's own client organisation.

Răspuns

Nume	Tip	Obligatoriu	Ce este
`id`	`Uuid`	Da	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`board_id`	`Uuid`	Da	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`user_id`	`Uuid`	Da	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`member_org_id`	`Uuid`	Da	The organisation this seat belongs to — the agency's, or the client's.
`role`	`string<manager, member, client>`	Da	—
`last_read_at`	`string`	Nu	—
`created_at`	`string`	Nu	—
`user`	`AgencyBoardActor`	Nu	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`	Nu	—

Erori pe care le poate returna acest punct final

401 · 403 · 404 · 422

POST /v1/agency/boards/{boardId}/members