---
title: "List a space's scheduled jobs"
method: GET
path: "/v1/spaces/{spaceId}/crons"
tags: ["Spaces"]
---

# List a space's scheduled jobs

`GET /v1/spaces/{spaceId}/crons`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/spaces/{spaceId}/crons`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the scheduled jobs the live version declares in its config, each with its most recent failures. Read-only: crons are declared in sf.jsonc, so publishing is the only way to change them.

## Path parameters

- `spaceId` string, required

## 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
    - `versionId` string, nullable, required: Live version these declarations come from, or null before the first publish.
    - `crons` object[], required
      - `key` string, required: Stable identifier for this entry, derived from its path.
      - `path` string, required: Path on this space that gets requested.
      - `schedule` string, required: Schedule as declared, verbatim: named, an Nh/Nd/Nw interval, or a five-field crontab expression.
      - `recentFailures` object[], required: Most recent failures reported for this entry, newest first. Empty when it has not failed.
        - `id` string, required: Failure report id.
        - `occurredAt` string, date-time, required: Instant the failure was reported.
        - `exitCode` integer, nullable, required: Exit status the platform reported for the run. Null when the failure report did not carry one.
        - `reason` string, nullable, required: What the exit status means on this runtime, when it maps to a known failure mode. Null when unknown.
    - `unattributedFailures` object[], required: Failures that could not be tied to one entry, newest first. A cron removed from the config can still have failed while it was live.
      - `id` string, required: Failure report id.
      - `occurredAt` string, date-time, required: Instant the failure was reported.
      - `exitCode` integer, nullable, required: Exit status the platform reported for the run. Null when the failure report did not carry one.
      - `reason` string, nullable, required: What the exit status means on this runtime, when it maps to a known failure mode. Null when unknown.
      - `key` string, nullable, required: Key the failure report named — an entry the live config no longer declares — or null when the report carried none.

## 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)