Skip to main content
GET
Get agent refresh status

Authorizations

Authorization
string
header
required

Bearer token in the Authorization header. Two token types are accepted:

  • Organization API key (sk_...) issued via the dashboard. Org-scoped, long-lived, for server-to-server use.
  • User JWT obtained via the OAuth 2.1 authorization code flow with PKCE. User-scoped, short-lived. Discover the authorization server at /.well-known/oauth-authorization-server and the protected-resource metadata at /.well-known/oauth-protected-resource/api.

Path Parameters

encodedUrl
string
required

URL-encoded agent URL

operationId
string<uuid>
required

Response

Durable refresh lifecycle

refresh_operation_id
string<uuid>
required
test_session_id
string
required
agent_url
string<uri>
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed
attempts
integer
required
requested_at
string<date-time>
required
started_at
string<date-time> | null
required
completed_at
string<date-time> | null
required
result
object | null
required
error
object | null
required