Skip to content

Get an operation

GET
/api/v1/teams/{team_slug}/operations/{id}/
curl --request GET \
--url https://example.com/api/v1/teams/example/operations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/ \
--cookie sessionid=<sessionid>

/api/v1/teams/{team}/operations/{id} — poll an async task (docs/58 §5.3).

id
required
string format: uuid
team_slug
required
string
Media type application/json

An async Operation resource (docs/58 §3.11, §5.3) — poll to convergence.

object
id
required
string
kind
required
string
target
required
object
key
additional properties
state
required
string
progress
required
integer
error
required
object
key
additional properties
desiredHash
required
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
self
required
string
nullable
Example generated
{
"id": "example",
"kind": "example",
"target": {
"additionalProperty": "example"
},
"state": "example",
"progress": 1,
"error": {
"additionalProperty": "example"
},
"desiredHash": "example",
"createdAt": "2026-04-15T12:00:00Z",
"updatedAt": "2026-04-15T12:00:00Z",
"self": "example"
}

RFC 7807 problem document

Media type application/json

RFC 7807 application/problem+json — every non-2xx response (docs/58 §5.10).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
code
required

Stable machine code clients switch on

string
instance
required
string
nullable
operationId
required
string
nullable
Example generated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"code": "example",
"instance": "example",
"operationId": "example"
}