Close out a preparation because the prepared external work was actually sent. Requires executedAt (when it left the external system, not when Forbiz learned about it). This records preparation state only — the execution itself must still be recorded via POST /actions/{id}/execute or POST /outreach/{id}/executions.

post/actions/{id}/preparations/mark-executed

Request

  • Base URL: https://forbiz.io/api/public/agent
  • URL: https://forbiz.io/api/public/agent/actions/{id}/preparations/mark-executed
  • Auth: HTTP bearer

Path parameters

idstring required

Headers

Idempotency-Keystring

Recommended on every mutating request. A replay with the same key is NOT applied twice: the server answers { ok, idempotent_replay: true, first_seen_at, status } describing the first attempt.

Request body

preparationIdstring
executedAtstring date-time

Response

Transitioned

okboolean
duplicate_preparation_rejectedboolean
action_unchangedobject

Changes

No recorded changes to this operation across all 1 revision of this API.