Remove the flow's record action

DELETE 
/v1/flows/:flow_id/record-action

Future completions stop writing records. Existing records and submissions are never touched by this call. The flow's own backing register goes with the action only when the action provisioned it, it holds no record, and nothing else uses it; a register with records, one that belongs to another flow, or one another flow's action writes into stays. Idempotent: an absent action is 204 too. 409 register_in_use when an option list of some flow still reads the register that would go; the detail says which flow, or that it is this flow's own version. Requires flows:write.

Request

Responses

204

Action removed, or there was none. No body.

400

A malformed flow_id (code: invalid_parameter), or an unrecognised query parameter (code: unknown_parameter).

401

Missing, malformed, unknown, revoked, or expired key — one body for all of them (code: unauthorized), with WWW-Authenticate: Bearer realm="hop".

403

The key lacks the scope (code: insufficient_scope), named in WWW-Authenticate: Bearer error="insufficient_scope", scope="…".

404

No such flow: nonexistent or another organisation's.

409

code: register_in_use: an option list still reads the register this action provisioned; the detail says which flow, or that it is this flow's own version.

429

Over a bucket. Obey Retry-After (seconds); RateLimit-* fields are informational.

Response Headers

RateLimit-Limit

Requests allowed in the current window. Informational.

RateLimit-Remaining

Requests left in the current window. Informational.

RateLimit-Reset

Seconds until the window resets. Informational.

Retry-After

Seconds to wait before retrying. The binding contract.