Sign in

v4

latestOpenAPI 3.1.0Redoclyraw.githubusercontent.com2026-06-05101533.8 KB
Tasks

Process next job

Retrieve and start the next available job.

post/orgs/{orgId}/projects/{projectId}/scout/tasks

Path parameters

orgIdstring required
Example:acme-inc

Organization ID.

projectIdstring required
Example:my-project

Project ID.

Headers

x-redocly-scout-versionstring
Example:1.0.0

Scout version.

Response

OK.

idstring ulid required

ID of the job.

status'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' required

Job status.

type'PROCESS_GIT_REPO' | 'UPDATE_STATUS' required

Type of job.

organizationIdstring required

Organization ID.

projectIdstring required

Project ID.

providerIdstring

Git provider identifier (appId for GitHub).

providerType'GITHUB_CLOUD' | 'GITHUB_SERVER' | 'GITLAB_CLOUD' | 'GITLAB_SELF_MANAGED' | 'BITBUCKET_CLOUD' | 'BITBUCKET_DATACENTER' | 'AZURE' required

Git provider type.

namespaceIdstring required

Git repo namespace id (organization login for GitHub).

repositoryIdstring required

Git repo id.

branchstring required

Git branch name.

commitShastring required

Git commit SHA.

isMainBranchboolean

True if branch is main.

prIdstring

Git pull request ID.

attemptsinteger required

Number of attempts to process the job.

parentJobIdstring ulid

ID of the parent job, if any.

startedAtstring date-time

Job start date.

createdAtstring date-time required

Job creation date.

updatedAtstring date-time required

Job last update date.

Example response

{
  "id": "sjob_01h2t9ksv7vmsvbhh5ty40zctw",
  "parentJobId": "sjob_01h2t9ksv7vmsvbhh5ty40zctw",
  "checks": [
    {
      "name": "Scorecard - Compliance API"
    }
  ],
  "metadata": {
    "scoutVersion": "1.0.0"
  }
}