A job is an object used to perform long-running tasks. For example, closing 10k tickets, exporting 500k tickets, and more.

Jobs are processed asynchronously, meaning that once a job is created, it will run in background on Gorgias's servers. According to the type and size of the task, a job can take a few minutes or several hours to be executed. You can use our API to check the status of the job.

Jobs can be canceled at any time but be aware that if a job already started, changes done by this one won't be reverted. For example, if you created a job to close 10k tickets and you cancel it at some point, the already closed tickets won't be reopened.

Job properties

id

integer

ID of the job.

cancel_requested_datetime

ISO 8601 datetime

When the job cancellation was requested.

cancelled_datetime

ISO 8601 datetime

When the job was canceled.

created_datetime

ISO 8601 datetime

When the job was created.

ended_datetime

ISO 8601 datetime

When the job ended.

failed_datetime

ISO 8601 datetime

When the job failed.

info

object

Data concerning the progress of the job. E.g: how many objects the job has already processed.

locked_datetime

ISO 8601 datetime

When the job was locked. A job is only locked while it's actively running.

meta

object | null

Metadata associated with the job. You can use this parameter to store structured information (key-value data) about the job. This field is not used by Gorgias.

params

object

The parameters of the job.

scheduled_datetime

ISO 8601 datetime

When the job was scheduled to be started. A job cannot be scheduled more than 60 minutes in the future. If unspecified, the job is queued for execution immediately after creation.

started_datetime

ISO 8601 datetime

When the job started.

status

string

The status of the job. Options: cancel_requested, canceled, done, errored, fatal_errored, pending, running, scheduled

type

string

The type of the job. Options: applyMacro, deleteTicket, exportTicket, importMacro, exportMacro, updateTicket, exportTicketDrilldown, exportConvertCampaignSalesDrilldown

user_id

integer

The ID of the user who created this job.

uri

string

URI of the job.

Job example object

{
  "id": 1234,
  "cancel_requested_datetime": "2019-11-23T16:31:00.966927",
  "cancelled_datetime": "2019-11-23T16:32:00.966927",
  "created_datetime": "2019-11-23T16:00:00.966927",
  "ended_datetime": "2019-11-23T16:32:00.966927",
  "failed_datetime": "2019-11-23T15:59:41.966927",
  "info": {
    "progress_count": 123
  },
  "locked_datetime": "2019-11-23T16:30:01.966927",
  "meta": {
    "description": "This job closes all tickets created in 2018"
  },
  "params": {
    "apply_and_close": true,
    "end_datetime": "2019-11-24T15:59:41.966927",
    "macro_id": 47,
    "start_datetime": "2019-11-23T15:59:41.966927",
    "ticket_ids": [
      1,
      2,
      3
    ],
    "url": "https://example.com/file.csv",
    "updates": {
      "status": "open"
    },
    "view": {
      "filters": "eq(ticket.status, \"open\")"
    },
    "view_id": 123,
    "context": {
      "channel_connection_external_ids": [
        "12",
        "34"
      ]
    }
  },
  "scheduled_datetime": "2019-11-23T16:30:00.966927",
  "started_datetime": "2019-11-23T16:30:01.966927",
  "status": "canceled",
  "type": "updateTicket",
  "user_id": 42
}