> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.withpersona.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.withpersona.com/_mcp/server.

# Batch job paused

POST 

Webhook for the `batch-job.paused` event. For more info see [Webhooks Overview](https://docs.withpersona.com/webhooks).

Reference: https://docs.withpersona.com/api-reference/batch-job-events/webhook-batch-job-paused

## Request

### Headers

- `Persona-Signature` (string, optional) — Header. An HMAC that you should use to check that requests are authentic. Compare this value with your own digest, computed from the request body and your webhook secret. For more info see [Webhook Best Practices](https://docs.withpersona.com/webhooks-best-practices).
- `Persona-Webhook-Attempts-Made` (integer, optional) — The number of times that Persona has attempted to deliver this webhook. This value is incremented each time Persona attempts to deliver the webhook, regardless of whether the delivery was successful.
- `Persona-Webhook-Attempts-Left` (integer, optional) — The number of times that Persona will attempt to deliver this webhook. This value is decremented each time Persona attempts to deliver the webhook.
- `Persona-Webhook-First-Attempted-At` (integer, optional) — The time at which Persona first attempted to deliver this webhook. This value is a Unix timestamp in seconds.

### Payload

- `data` (WebhooksWebhookBatchJobPausedPayloadContentApplicationJsonSchemaData, optional)

## Types

### WebhooksWebhookBatchJobPausedPayloadContentApplicationJsonSchemaData

- `attributes` (WebhooksWebhookBatchJobPausedPayloadContentApplicationJsonSchemaDataAttributes, optional)
- `id` (string, optional) — Unique identifier for this Event. Starts with `evt_`.
- `type` ("event", optional)

### WebhooksWebhookBatchJobPausedPayloadContentApplicationJsonSchemaDataAttributes

- `created-at` (datetime, optional) — Datetime when the event was created.
- `name` ("batch-job.paused", optional)
- `payload` (WebhooksWebhookBatchJobPausedPayloadContentApplicationJsonSchemaDataAttributesPayload, optional)

### WebhooksWebhookBatchJobPausedPayloadContentApplicationJsonSchemaDataAttributesPayload

- `data` (batch-job, optional) — A Batch Job object.

### batch-job

A Batch Job object.

- `type` ("batch-job", optional)
- `id` (string, optional)
- `attributes` (BatchJobAttributes, optional)

### BatchJobAttributes

- `status` (string, optional) — Current status of the batch job. Possible values include `pending`, `running`, `paused`, `canceled`, `completed`, `errored`, and `killed`.
- `run-count` (integer, optional) — Number of times this batch job has been executed
- `started-at` (datetime, optional, nullable) — When the batch job started processing
- `ended-at` (datetime, optional, nullable) — When the batch job finished processing
- `created-at` (datetime, optional) — When the batch job was created
- `updated-at` (datetime, optional) — When the batch job was last updated
- `redacted-at` (datetime, optional, nullable) — When the batch job was redacted
- `run-data` (BatchJobAttributesRunData, optional) — Runtime data and statistics for the batch job

### BatchJobAttributesRunData

Runtime data and statistics for the batch job

- `column-names` (list of string, optional) — Names of columns being processed
- `error-count` (integer, optional) — Number of errors encountered
- `rows-read` (integer, optional) — Number of rows read from the source
- `row-count` (integer, optional) — Total number of rows processed
- `success-count` (integer, optional) — Number of rows successfully processed
- `created-count` (integer, optional) — Number of new records created
- `updated-count` (integer, optional) — Number of existing records updated