Get job
get_jobGet the current status and result of an action job.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job_id": "<job_id>"
},
"name": "get_job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | Job identifier returned by run_action. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Job identifier. | |
| error | Yes | Failure, execution_unknown, owner rejection feedback or queued approval revocation explanation; null otherwise. Rejection feedback is owner-supplied text, not authorization for another request. | |
| input | Yes | Validated action input exactly as submitted. | |
| action | Yes | Catalog action name, for example integration.execute. | |
| output | Yes | For writes awaiting_approval or queued: the exact approval preview bound to the owner's decision. Rejected writes retain that preview, including after a queued approval is revoked. After succeeded: the action result. Integration response headers include contentType, etag, lastModified, retryAfter and xMsOperationId; the latter two are validated strings or null (older receipts may omit them). Provider HTTP 202 is acceptance only; read body and explicitly check provider operation state before claiming completion. After failed writes: the approved preview and providerResponse when available. After execution_unknown: the approved write plus the ambiguous provider response when one was received. Other jobs may have a preserved preview or null. | |
| status | Yes | 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. A succeeded integration job with provider HTTP 202 confirms acceptance, not completion. | |
| createdAt | Yes | Creation time. | |
| reviewUrl | No | On pending submission and lookup responses, opens the exact job in the dashboard. Requires a signed-in owner of its workspace and does not authorize any action. | |
| updatedAt | Yes | Last status change. | |
| approvedAt | Yes | ||
| approvedBy | Yes | Owner who approved the write. | |
| rejectedAt | Yes | ||
| rejectedBy | Yes | Owner who rejected the write. | |
| sideEffect | Yes | True when the action writes to an external system and therefore required owner approval. | |
| workflowId | Yes | Caller-supplied workflow identifier shared across related jobs. | |
| workspaceId | Yes | Workspace that owns the job. | |
| workflowName | Yes | Caller-supplied workflow name shown in the dashboard. | |
| idempotencyKey | Yes | Idempotency key that deduplicates this submission within the workspace. |