---
title: "Jobs"
description: "<p>Create and manage data import and export jobs.</p>"
url: "https://www.contentstack.com/docs/developers/apis/lytics-api/jobs"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-11-05"
---

# Jobs

Create and manage data import and export jobs.

## Get jobs

### Get jobs

**GET** `/v2/job`

Get a list of all jobs in an account

#### Query Parameters

- **account_id** (optional)
  The account ID. Defaults to the user's default account.
- **workflow** (optional)
  Optional workflow filter
- **auth_ids** (optional)
  Optional auth IDs filter
- **show_completed** (optional)
  Include completed jobs in the response
- **show_deleted** (optional)
  Include deleted jobs in the response

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "_meta": {},
  "data": [
    {
      "account_id": "string",
      "anomaly_rule": {
        "aid": 0,
        "checks": [
          {
            "allowable_violations": 0,
            "interval": "string",
            "lookback_count": 0,
            "max_threshold": 0,
            "metric_type": "string",
            "min_threshold": 0,
            "type": "string",
            "variance_pct": 0
          }
        ],
        "created": "string",
        "id": "string",
        "subject_id": "string",
        "subject_type": "string",
        "updated": "string"
      },
      "api_token_auth_id": "string",
      "auth_ids": [
        "string"
      ],
      "config": {},
      "created": "string",
      "deleted": true,
      "description": "string",
      "drop_events_during_quiet_window": true,
      "expires_at": "2019-08-24T14:15:22Z",
      "id": "string",
      "meta": {},
      "monitoring": {},
      "name": "string",
      "quiet_period": 0,
      "quiet_time_of_day": "string",
      "quiet_timezone": "string",
      "sleep_until": "string",
      "status": "runnable",
      "updated": "string",
      "user_id": "string",
      "workflow": "string",
      "workflow_id": "string"
    }
  ],
  "request_id": "string",
  "status": 0
}
```

## Bounce job

### Bounce job

**POST** `/v2/job/{id}/bounce`

Bounce a job

#### URL Parameters

- **id** (required)
  The Job ID

#### Query Parameters

- **account_id** (optional)
  The account ID. Defaults to the user's default account.

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {},
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}
```

## Terminate job

### Terminate job

**POST** `/v2/job/{id}/kill`

Terminate a job

#### URL Parameters

- **id** (required)
  The Job ID

#### Query Parameters

- **account_id** (optional)
  The account ID. Defaults to the user's default account.

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {},
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}
```

## Get job logs

### Get job logs

**GET** `/v2/job/{id}/logs`

Retrieve log messages for a job

#### URL Parameters

- **id** (required)
  The Job ID

#### Query Parameters

- **account_id** (optional)
  The account ID. Defaults to the user's default account.

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "_meta": {},
  "data": [
    {
      "code": "UNKNOWN-000",
      "context": {},
      "job_id": "string",
      "level": "string",
      "message": "string",
      "timestamp": "2019-08-24T14:15:22Z"
    }
  ],
  "request_id": "string",
  "status": 0
}
```

## Pause job

### Pause job

**POST** `/v2/job/{id}/pause`

Pause a job

#### URL Parameters

- **id** (required)
  The Job ID

#### Query Parameters

- **account_id** (optional)
  The account ID. Defaults to the user's default account.

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {},
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}
```

## Resume job

### Resume job

**POST** `/v2/job/{id}/resume`

Resume a paused job

#### URL Parameters

- **id** (required)
  The Job ID

#### Query Parameters

- **account_id** (optional)
  The account ID. Defaults to the user's default account.

#### Headers

- **Authorization** (optional)

#### Sample Response

```json
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {},
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}
```