Spaces

Run a scheduled job now

Requests one of the live version's declared cron paths on this space's default hostname, right now, and returns what it answered. Requires write access to the space, because a cron handler can mutate state — the same authority wp-cli and db console require. target is a declared key or path — anything else is rejected, and no request is made. Headers are not passed through and redirects are not followed; use sf crons run --header for a handler that checks a secret. The platform's x-spacefast-cron header is never carried, so a handler gated on it will refuse.

post/v1/spaces/{spaceId}/crons/run

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/spaces/{spaceId}/crons/run
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.spacefast.com/v1/auth/oauth2/authorize, token URL https://api.spacefast.com/v1/auth/oauth2/token; client credentials, token URL https://api.spacefast.com/v1/auth/oauth2/token, scopes: spaces:write)

Path parameters

spaceIdstring required

Request body

targetstring required

Key or path of a scheduled job the live version declares.

Response

Response for status 200

$schemastring uri

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

Changes

No recorded changes to this operation across all 1 revision of this API.