List runs

Returns the team’s runs, newest first. status=awaiting_approval is the approvals inbox query.

GET /v1/connectors/runs

Authorization

• Authorization Bearer token · header required

`Authorization: Bearer ` with an API key (sfa_ prefix), an OAuth access token, a session token, or a Space machine credential (sfm_ prefix).

• Authorization OAuth2 access token · header required

OAuth 2.0 with Spacefast scopes. People use the authorization code flow; machines use client credentials.

Scopes: connectors:read

Query parameters

• limit integer required
  • min 1 · max 100 · default: 20
• cursor string
  • min length 1 · max length 4096
• status string
  • Allowed: running, awaiting_approval, succeeded, failed, expired
• connection string
  • min length 1
• team string
  • min length 1 · max length 255

Responses

200 Response for status 200

• $schema string
  • Canonical JSON Schema URL for this response body.
• data object[] required
  • Array of object
    • id string required
      • Run id (cxr_).
    • input object required
      • What the run was asked to do, without echoing arguments that may carry customer data.
      • kind string required
        • tool is one call; code is a program that may make many. Same endpoint, same id space, same resume.
        • Allowed: tool, code
      • address string | any required
        • Tool address for a tool run; null for a code program.
      • digest string required
        • Content digest of the submitted input, so a retry can be recognized without replaying it.
    • usage object required
      • What this run has spent. Budgets are enforced against these numbers.
      • toolCalls integer required
        • Tool calls made so far.
      • egressBytes integer required
        • Bytes read from third-party APIs so far.
      • durationMs integer required
        • Wall-clock time spent executing so far.
    • createdAt string required
    • status string required

Pagination

• nextCursor string | any required
  • Opaque cursor for the next page; null when there are no more results.
• hasMore boolean required
  • Whether another page exists after this one.