Sign in

v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
Jobs

Retrieve job status

Retrieve the status of job execution.

get/jobs/status/{job_id}

Path parameters

job_idstring required

The unique identifier for the job which is given by Intercom

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Response

Job execution status

type'job'

The type of the object

idstring required

The id of the job that's currently being processed or has completed.

urlstring

API endpoint URL to check the job status.

status'pending' | 'success' | 'failed'

The status of the job execution.

resource_typestring

The type of resource created during job execution.

resource_idstring nullable

The id of the resource created during job execution (e.g. ticket id)

resource_urlstring nullable

The url of the resource created during job exeuction. Use this url to fetch the resource.

Example response

{
  "url": "https://api.intercom.io/jobs/status/20",
  "resource_type": "ticket",
  "resource_url": "http://api.intercom.io/tickets/123"
}