List operations

Returns the operations the caller can reach, most recently updated first. Page with cursor. The feed covers version finalize, promote, and delete, domain checks, registrations, transfers, and lifecycle work, and webhook deliveries; internal system work and anything the credential cannot reach stay out. Filter with resourceType and resourceId to follow one thread, or spaceId for one Space together with its versions and builds.

GET /v1/operations

Authorization

Authorization Bearer token · header required

Authorization: Bearer <token>

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

Query parameters

• limit integer required
  min 1 · max 100 · default: 20
• cursor string
  min length 1 · max length 4096
• resourceType string
  min length 1
• resourceId string
  min length 1
• spaceId string
  min length 1

Responses

200 Response for status 200

{
  "$schema": "string<uri>",
  "data": [
    {
      "id": "string",
      "kind": "string",
      "status": "string",
      "resources": [
        {
          "type": "string",
          "id": "string"
        }
      ],
      "progress": {
        "total": integer,
        "completed": integer,
        "failed": integer
      },
      "diagnostics": [
        {
          "code": "string",
          "severity": "string",
          "message": "string",
          "path": "string",
          "provider": "string",
          "details": {
            "property1": null,
            "property2": null
          },
          "fix": "string",
          "retryable": true
        }
      ],
      "createdAt": "string<date-time>",
      "finishedAt": "string<date-time>",
      "versionSource": "string",
      "integrationRelease": {
        "environment": "string"
      }
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}

Error Responses

{
  "$schema": "string<uri>",
  "type": "string",
  "title": "string",
  "status": integer,
  "detail": "string",
  "code": "string",
  "pointer": "string",
  "details": {
    "property1": null,
    "property2": null
  },
  "suggestions": [
    "string"
  ],
  "next": [
    "string"
  ],
  "requestId": "string"
}

Try it

cURL

curl -X GET "https://api.spacefast.com/v1/operations?limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch("https://api.spacefast.com/v1/operations?limit=20", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Python

import requests

response = requests.get(
    "https://api.spacefast.com/v1/operations?limit=20",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    }
)