Submit one bounded action

Returns 202 with a durable job. Actions with sideEffect true start as awaiting_approval and execute only after a signed-in workspace owner releases the exact preview in the dashboard; other actions start as queued. integration.execute optionally accepts input.executeBefore, a UTC latest-dispatch timestamp bound to approval; expired writes fail without dispatch and need a new proposal and approval. Already-sent writes may finish later. It also accepts input.ifMatch, a single strong quoted ETag bound to approval and sent as If-Match. A provider 412 fails the job without retry and requires a fresh read and new proposal; the provider must enforce conditional writes. See each action's inputSchema in the action catalog.

post/v1/actions/{action}

Request

  • Base URL: https://actiondock.app
  • URL: https://actiondock.app/v1/actions/{action}
  • Auth: HTTP bearer

Path parameters

action'document.analyze' | 'data.extract' | 'data.validate' | 'research.web' | 'integration.fetch' | 'integration.execute' | 'report.create' required

Headers

Idempotency-Keystring

Deduplicates this submission within the workspace; it does not guarantee exactly-once execution by the provider.

Request body

inputobject required

Action input validated against the action's inputSchema from GET /v1/actions.

workflowIdstring

Shared across related jobs so the owner can inspect the sequence.

workflowNamestring
idempotencyKeystring

Alternative to the Idempotency-Key header; the header wins when both are present.

Response

Job accepted

idstring uuid required

Job identifier.

workspaceIdstring uuid required

Workspace that owns the job.

actionstring required

Catalog action name, for example integration.execute.

workflowIdstring nullable required

Caller-supplied workflow identifier shared across related jobs.

workflowNamestring nullable required

Caller-supplied workflow name shown in the dashboard.

status'awaiting_approval' | 'queued' | 'running' | 'succeeded' | 'failed' | 'rejected' | 'execution_unknown' required

awaiting_approval, queued, and running are non-terminal; succeeded, failed, rejected, and execution_unknown are terminal. An owner may revoke a queued approval, producing rejected with both approval and rejection evidence.

inputobject required

Validated action input exactly as submitted.

outputunknown required
errorstring nullable required

Failure, execution_unknown or queued approval revocation explanation; null otherwise.

sideEffectboolean required

True when the action writes to an external system and therefore required owner approval.

idempotencyKeystring nullable required

Idempotency key that deduplicates this submission within the workspace.

approvedAtstring date-time nullable required

When a signed-in workspace owner released the write.

approvedBystring nullable required

Owner who approved the write.

rejectedAtstring date-time nullable required

When a signed-in workspace owner rejected the write.

rejectedBystring nullable required

Owner who rejected the write.

createdAtstring date-time required

Creation time.

updatedAtstring date-time required

Last status change.

Changes

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