Skip to main content
GET
Get a runtime operation

Authorizations

Authorization
string
header
required

Pass a user JWT or a oag_ User API Key on the Authorization: Bearer <token> header. Both are validated by openapi-gateway against the Auth service.

Both credential types are user-scoped: every key (and every JWT) is bound to exactly one owner, and every route grants the caller full access to that owner's own resources. Cross-tenant access is denied by owner-ACL inside the handlers — there is no per-route scope vocabulary on this API.

Removed in v1.1.0: the legacy agents:* / tasks:* / files:* / instances:* scope set has been dropped together with the 403 insufficient_scope error. Existing oag_ keys automatically gain full owner-level access and do not need to be re-issued. SDK calls that previously passed scopes to createAPIKey should drop the argument. See the changelog at the bottom of this spec for the full migration note.

Path Parameters

instanceId
string
required
Maximum string length: 128
operationId
string<uuid>
required

Response

Reduced durable operation snapshot

id
string<uuid>
required
instanceId
string
required
target
object
required
method
enum<string>
required
Available options:
session/set_mode,
agent/create,
agent/update,
agent/delete,
agent/applyTemplate,
skills/list,
skills/install,
skills/uninstall,
skills/update,
models/list,
cron/list,
cron/status,
cron/add,
cron/update,
cron/remove,
cron/run,
cron/runs,
mcp/list,
mcp/prepare,
mcp/set,
mcp/unset,
session/clear,
session/set_model,
session/cancel
capability
enum<string>
required
Available options:
agents.lifecycle,
skills,
models,
cron,
mcp,
conversation.control
transport
enum<string>
required
Available options:
service
sequence
string
required
Pattern: ^(0|[1-9][0-9]*)$
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
status
enum<string>
required
Available options:
queued,
running,
runtime_committed,
projection_pending,
projection_blocked,
succeeded,
failed,
cancelled,
expired,
outcome_unknown
effectState
enum<string>
required
Available options:
queued,
running,
committed,
failed,
cancelled,
expired,
outcome_unknown
terminal
boolean
required
cursor
string
Pattern: ^(0|[1-9][0-9]*)$
progress
object
cancelRequest
object
projection
object
result
any
error
object