> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.sevalla.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > This is the Sevalla REST API reference. Base URL: https://api.sevalla.com/v3. Authenticate with an API key in the Authorization header as a Bearer token. > The OpenAPI spec is at https://api.sevalla.com/v3/openapi.json. Concepts and dashboard guides are at https://docs.sevalla.com (index: https://docs.sevalla.com/llms.txt). > To act on a Sevalla account from an AI agent, prefer the Sevalla MCP server (https://mcp.sevalla.com/mcp, see https://docs.sevalla.com/ai-agents/overview.md) or the Sevalla CLI (https://api-docs.sevalla.com/v3/cli.md). # List cron runs > Retrieve the run history of a cron process, newest first. Each run shows when it was due, when it started and finished, its outcome, the failure reason and exit code, how many times it was retried, and whether it was scheduled or triggered manually. Runs are kept for 30 days. Processes of other types have no runs. ## OpenAPI ````yaml https://api.sevalla.com/v3/openapi.json get /applications/{id}/processes/{process_id}/runs openapi: 3.1.0 info: title: Sevalla API docs version: 1.0.0 servers: - url: https://api.sevalla.com/v3 security: - bearerAuth: [] paths: /applications/{id}/processes/{process_id}/runs: get: tags: - Applications summary: List cron runs description: >- Retrieve the run history of a cron process, newest first. Each run shows when it was due, when it started and finished, its outcome, the failure reason and exit code, how many times it was retried, and whether it was scheduled or triggered manually. Runs are kept for 30 days. Processes of other types have no runs. operationId: listProcessCronRunsV3 parameters: - schema: default: 25 example: 25 type: integer minimum: 1 maximum: 100 in: query name: limit required: false description: Maximum number of items per page - schema: default: 0 example: 0 type: integer minimum: 0 maximum: 10000 in: query name: offset required: false description: Number of items to skip - schema: example: fb5e5168-4281-4bec-94c5-0d1584e9e657 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ in: path name: id required: true description: Application identifier - schema: example: fb5e5168-4281-4bec-94c5-0d1584e9e657 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ in: path name: process_id required: true description: Process identifier responses: '200': description: Default Response content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: Cron run identifier example: b3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d process_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: Cron process the run belongs to example: fb5e5168-4281-4bec-94c5-0d1584e9e657 job_name: type: string description: >- Name of the Kubernetes Job of the run. Its pods, and their runtime logs, start with this name. example: my-app-abc12-cleanup-29512345 trigger: type: string enum: - scheduled - manual description: >- How the run started. `scheduled` - started by the cron schedule. `manual` - started on demand, for example with the trigger cron job endpoint. example: scheduled status: type: string enum: - running - succeeded - failed description: >- Outcome of the run. `running` - the run has not finished yet. `succeeded` - the command exited with code 0. `failed` - the run gave up, see `reason` and `exit_code`. example: succeeded reason: description: >- Why a failed run failed, null otherwise. `BackoffLimitExceeded` - the command kept failing after its retry. `DeadlineExceeded` - the run took longer than the maximum run time of the process. `Deleted` - the run was stopped before it finished, for example replaced by the next run when the concurrency policy is `Replace`. example: BackoffLimitExceeded type: - string - 'null' exit_code: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Exit code of the last attempt, or null while the first attempt is still running. 0 - success, 1 - error, 137 - killed, often for running out of memory, 143 - terminated. example: 0 retries: type: integer minimum: 0 maximum: 9007199254740991 description: >- Number of times the command was restarted after it failed within this run example: 0 scheduled_at: type: string description: >- When the run was due, in ISO 8601 format. For manual runs, when it was triggered. example: '2026-10-29T10:00:00.000Z' started_at: description: >- When the run started, in ISO 8601 format, or null if it has not started yet example: '2026-10-29T10:00:00.000Z' type: - string - 'null' finished_at: description: >- When the run succeeded or failed, in ISO 8601 format, or null while it is running example: '2026-10-29T10:00:00.000Z' type: - string - 'null' required: - id - process_id - job_name - trigger - status - reason - exit_code - retries - scheduled_at - started_at - finished_at additionalProperties: false description: List of items total: type: integer minimum: 0 maximum: 10000 description: Total number of items matching the query example: 42 offset: type: integer minimum: 0 maximum: 10000 description: Current pagination offset example: 0 limit: type: integer minimum: 1 maximum: 100 description: Current pagination limit example: 25 required: - data - total - offset - limit additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Unauthorized status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 401 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '403': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: >- This API key is missing the : permission. Grant it to the key or use a key that has it. status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 403 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Not found status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 404 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '429': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Too many requests status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 429 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '500': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Internal Server Error status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 500 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authentication. Pass your API key as a Bearer token in the Authorization header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.