---
title: "List operations"
method: GET
path: "/v1/operations"
tags: ["Activity"]
---

# List operations

`GET /v1/operations`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/operations`
- Auth: HTTP bearer

Returns your workflow operations, newest first. The feed includes publishes, builds, domain and webhook activity, integration releases, agent runs, and approvals. Internal system operations stay out of this feed. Operations your credential cannot reach stay out of this feed. Filter by resource to follow one thread, or by `spaceId` for everything about one Space.

## Query parameters

- `limit` integer: Page size.
- `cursor` string: Opaque cursor from the previous page's `nextCursor`.
- `resourceType` string: Filter to operations touching one resource type, for example `space`.
- `resourceId` string: Filter to operations touching one resource.
- `spaceId` string: Filter to operations for one Space: its own operations plus those of its versions and builds. The Space must be readable by the caller.

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object[], required
    - `id` string, required
    - `kind` 'version_finalize' | 'version_promote_live' | 'version_delete' | 'build_start' | 'domain_check' | 'domain_ssl_retry' | 'domain_registration_submit' | 'domain_transfer_submit' | 'domain_dns_apply' | 'domain_lifecycle' | 'webhook_deliver' | 'integration_release', required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
    - `resources` object[], required
      - `type` string, required
      - `id` string, required
    - `progress` object
      - `total` integer, required
      - `completed` integer, required
      - `failed` integer, required
    - `diagnostics` object[]
      - `code` string, required: Stable snake_case diagnostic code naming the public contract that produced it.
      - `severity` 'info' | 'warning' | 'error', required: How actionable the diagnostic is.
      - `message` string, required: Human-readable explanation with enough detail to act on.
      - `path` string, nullable: Artifact path the diagnostic points at, for example "_headers:12", when one exists.
      - `provider` 'infra' | 'dns' | 'registrar' | 'runtime', nullable: Upstream system the diagnostic originated from, when not Spacefast itself.
      - `details` object, nullable: Machine-readable context for the diagnostic code.
      - `fix` string, nullable: Concrete, agent-actionable remediation hint, when one can be derived.
      - `retryable` boolean, nullable: Whether retrying the same operation can resolve this diagnostic without the caller changing anything.
    - `createdAt` string, date-time, required
    - `finishedAt` string, date-time
    - `versionSource` 'direct_upload' | 'git' | 'settings': Version provenance for version operations; settings marks a settings publish, while direct_upload and git mark content publishes. Omitted for legacy rows.
    - `integrationRelease` object: Release environment for an integration tag pointer flip.
      - `environment` 'production' | 'preview' | 'development', required
  - `pagination` object, required
    - `nextCursor` string, nullable, required: Opaque cursor for the next page; null when there are no more results.
    - `hasMore` boolean, required: Whether another page exists after this one.

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)