mark_executed: record that a planned action was actually performed. TEMPORAL CONTRACT — executed_at is when it happened in the real world, recorded_at is when Forbiz wrote it down. Supply executedAt for historical / reconciled work (e.g. an email sent yesterday); omit it for normal live execution and the server stamps now. recorded_at is server-owned and can never be supplied. Retrying with the same Idempotency-Key changes neither timestamp. Optionally set the first review date in the same call; without it the action lands in needs_review_date and the response carries warnings[] with code no_review_date. Idempotent — re-executing returns already_executed: true and leaves both timestamps intact.

post/actions/{id}/execute

Request

  • Base URL: https://forbiz.io/api/public/agent
  • URL: https://forbiz.io/api/public/agent/actions/{id}/execute
  • 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

executedAtstring date-time

Real-world occurrence time. Validated: must parse as ISO 8601, may not be more than 5 minutes in the future (clock skew) and may not be more than a year in the past. Alias: occurredAt. Omit for live execution.

expectedSignalAtstring date-time

Response

Executed, with new timing state. executed_at is the real-world time, recorded_at the Forbiz write time, backdated true when a past executedAt was applied.

okboolean
already_executedboolean
executed_atstring date-time nullable
recorded_atstring date-time nullable
backdatedboolean

Changes

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