agency-board
GET /v1/agency/boards/{boardId}/automations/{ruleId}/runs
Every time this rule was considered — and why it did or did not fire.
認証
ベアラー トークンとして API キーを送信します。このエンドポイントでは仕様に特定の権限が記載されていないため、キーに必要な最小限の権限を付与し、推測するのではなくレスポンスを確認してください。
このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。
試してみる
アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。
curl -X GET https://api.zinndigital.com/v1/agency/boards/{boardId}/automations/{ruleId}/runs \
-H "Authorization: Bearer zdk_live_…"ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く
詳細
A row is written whenever the rule was **considered**, not only when it fired, and each carries the result of every condition with the value it actually saw. ⛔ That is the whole point of the endpoint. A rule that does not fire otherwise leaves the customer with an absence, which is indistinguishable from "the trigger never happened", from "it is disabled" and from "the platform is down".
パラメータ
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
boardId (path) | Uuid | はい | Project board ID (UUIDv7). |
ruleId (path) | Uuid | はい | Automation rule ID (UUIDv7). |
limit (query) | integer | いいえ | Maximum items to return (page size). |
cursor (query) | string | いいえ | Opaque cursor from a previous page's `page.next_cursor`. |
返信
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
data | BoardAutomationRun[] | はい | — |
page | PageMeta | はい | — |
このエンドポイントが返すエラー
401 · 403 · 404