ai
POST /v1/ai/proposals/{proposalId}/revert
Put an applied change back.
Նույնականացում
Ուղարկեք API բանալին որպես bearer թոքեն։ Այս վերջնակետը բնութագրում չի նշում որոշակի թույլտվության մասին, ուստի տվեք ձեր բանալուն նվազագույն անհրաժեշտը և ենթադրություններ անելու փոխարեն ստուգեք պատասխանը:
Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:
Փորձել
Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:
curl -X POST https://api.zinndigital.com/v1/ai/proposals/{proposalId}/revert \
-H "Authorization: Bearer zdk_live_…"Մուտք գործե՞լ եք: Ձեր վահանակի API վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ API-ի դեմ, որպեսզի կարողանաք տեսնել փաստացի պատասխանը: Բացեք այս վերջնակետը API վահանակում
Մանրամասներ
Undoes a proposal that has been applied, restoring the values captured before it ran. Gated exactly as approving is — the caller must hold the action's own permission in the proposal's organization — because undoing a change is not a lesser act than making it. ⛔ An action whose effect clears on its own (a cache purge) is a 422 saying so, not a silent success: there is nothing to put back, and reporting one would be a claim that something happened. ⭐ This is also what earns a capability its rung 2. revert_verified_at is stamped by a revert that actually RAN, never by a form — the authority ladder wants an event rather than an intention.
Պարամետրեր
| Անուն | Տեսակ | Պահանջվում է | Ինչ է դա |
|---|---|---|---|
proposalId (path) | Uuid | Այո | — |
Պատասխան
| Անուն | Տեսակ | Պահանջվում է | Ինչ է դա |
|---|---|---|---|
id | Uuid | Այո | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
action | string | Այո | — |
conversation_id | Uuid | Ոչ | The AI conversation this came out of, or null for one raised by a scheduled review. ⭐ Lets a chat surface show its own suggestions without a second endpoint, and lets /ai say… |
action_title | string | Այո | — |
target_label | string | Ոչ | — |
rationale | string | Ոչ | Why, citing the measurement. This is what a person reads before approving. |
state | AgentProposalState | Այո | — |
mode | AgentProposalMode | Այո | How an approved proposal executes — decided by the authority ladder at the moment of approval, never frozen when the proposal was written. attended is a person clicking;… |
reversibility | string<automatic, self_healing, manual> | Ոչ | Whether this change can be put back, carried on the proposal itself so a client rendering an undo control does not have to join this list against the capability catalogue — a… |
approval_means | string | Ոչ | — |
outcome | string | Ոչ | — |
proposed_by | string | Ոչ | — |
created_at | string | Այո | — |
decided_at | object | Ոչ | — |
applied_at | object | Ոչ | — |
reverted | boolean | Ոչ | — |
Այս վերջնակետի կողմից վերադարձվող սխալները
401 · 404 · 422 · 429