Skip to main content
GET
/
projects
/
{project_reference}
/
jobs
List Jobs
curl --request GET \
  --url https://api.veryfront.com/projects/{project_reference}/jobs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "canonical_run_id": "<string>",
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "branch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "cron_job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "status": "submitted",
      "target": "<string>",
      "config": {},
      "context_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "timeout_seconds": 123,
      "backoff_limit": 123,
      "exit_code": 123,
      "started_at": "<string>",
      "completed_at": "<string>",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "<string>",
      "updated_at": "<string>",
      "kind": "knowledge_ingest",
      "failure_detail": "<string>",
      "result_summary": {
        "kind": "knowledge_ingest",
        "state": "success",
        "requested_count": 1,
        "ingested_count": 1,
        "skipped_count": 1,
        "failed_count": 1
      }
    }
  ],
  "page_info": {
    "self": "<string>",
    "first": null,
    "next": "<string>",
    "prev": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

​
project_reference
string
required

Project slug or UUID

Query Parameters

​
cursor
string

Pagination cursor anchored on a job UUID.

​
limit
number
default:20

Maximum number of jobs to return.

Required range: 1 <= x <= 100
​
status
enum<string>

Filter jobs by lifecycle status.

Available options:
submitted,
working,
completed,
failed,
canceled
​
cron_job_id
string<uuid>

Filter jobs created from a specific cron job UUID.

​
environment_id
string<uuid>

Filter jobs scoped to a specific environment UUID.

​
batch_id
string<uuid>

Filter jobs within a specific batch UUID.

Response

Paginated list of jobs.

​
data
object[]
required
​
page_info
object
required

Pagination cursor values for traversing the result set.