Job

Gets a job by its id.

get/job/{jobId}

Path parameters

jobIdstring required

The id of the job to retrieve.

Response

OK

jobIdstring required

The job id.

namestring required

The job name.

definitionIdstring required

The job definition id.

audienceIdstring required

The audience id.

revisionNumberinteger required

The revision number.

pipelineIdstring required

The pipeline id.

campaignIdstring nullable

The job's campaign id. Null when the pipeline did not yield exactly one campaign.

audienceNamestring nullable

The audience name, or null when the job's audience has since been deleted (jobs outlive their audience).

state'Submitted' | 'Running' | 'Completed' | 'Failed' | 'ManualApproval' | 'Queued' | 'Paused' | 'StaleResults' | 'SpendLimited' required
isPublicboolean required

Whether the job (and its results) is shared publicly.

audienceDeletedboolean required

Whether the audience backing this job was deleted, meaning the job can never run.

completedAtstring date-time nullable

The timestamp when the job was completed.

resultFileNamestring nullable

The file name of the result.

failedAtstring date-time nullable

The timestamp when the job failed.

failureMessagestring nullable

The failure message.

reviewReason'ContentFlagged' | 'UnsupportedContentType' | 'CheckErrored' | 'ClassificationTimedOut' | 'null' nullable

Why the job was routed to manual review, when it is (or was) in ManualApproval. Null when no customer-facing reason applies.

createdAtstring date-time required

The creation timestamp.

ownerIdstring uuid required

The owner id.

ownerMailstring required

The owner email.

organizationIdstring required

The id of the organization that owns the entity.

Changes

Changed in 2 of the 5 revisions of this API.33

    • added the optional property audienceName to the response with the 200 status

      response-optional-property-added

    • added the optional property campaignId to the response with the 200 status

      response-optional-property-added

  • d779de93a5ee31See the full diff
    • the response property reviewReason became nullable for the status 200

      response-property-became-nullable

    • added ReviewReason to the reviewReason response property oneOf list for the response status 200

      response-property-one-of-added

    • the reviewReason response's property type/format changed from / to string/ for status 200

      response-property-type-changed

    • removed ReviewReason from the reviewReason response property allOf list for the response status 200

      response-property-all-of-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog