agency-board
POST /v1/agency/client/boards/{boardId}/requests
Raise a request with the agency.
אימות
שלח מפתח API כטוקן Bearer. נקודת קצה זו אינה מציינת הרשאת ספציפית במפרט, לכן הקצה למפתח שלך את המינימום הנדרש ובדוק את התגובה במקום להניח הנחות.
נקודת קצה זו אינה דורשת מזהה ארגון. המפתח שלך כבר מזהה את הארגון שאליו הוא שייך, והתגובה מוגבלת אליו בלבד.
נסה זאת
החלף כל דבר בסוגריים זוויתיים בערכים משלך, ואת מציין מיקום המפתח במפתח מלוח הבקרה שלך.
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> }'מחובר? קונסולת ה-API בלוח הבקרה שלך מזינה את מזהה הארגון האמיתי שלך ואת המפתח שלך, ומריצה את הבקשה מול ה-API הפיזי כך שתוכל לראות את התגובה בפועל. פתח נקודת קצה זו במסוף ה-API
פרטים
⚖️ 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.
פרמטרים
| שם | סוג | נדרש | מה זה |
|---|---|---|---|
boardId (path) | Uuid | כן | Project board ID (UUIDv7). |
גוף הבקשה
| שם | סוג | נדרש | מה זה |
|---|---|---|---|
title | string | כן | — |
body | string | לא | — |
תשובה
| שם | סוג | נדרש | מה זה |
|---|---|---|---|
id | Uuid | כן | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
column_id | Uuid | כן | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
title | string | כן | — |
body | string | לא | — |
due_at | string | לא | — |
raised_by_us | boolean | לא | 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 | לא | — |
updated_at | string | לא | — |
שגיאות שנקודה קצה זו עשויה להחזיר
401 · 403 · 404 · 422