# API обробки Bulk

Створіть і управляти файлами на основі YouTube, потім отримайте свої проявляються і результати.

Канонічне посилання: https://flashdata.dev/uk/docs/reference/bulk-processing
Переглянуто: 2026-11-05 від FlashData

<a id="playground"></a>

## Пісочниця API

Виберіть джерело та скопіюйте повну робочу лінію Python або Bash, єдиний запит або відповідь зразка. Код перегляду майданчика; не подає завдання. Повний робочий процес завантаження, перевірки стану та перерозподіл кожного результату.

- [Ауттентифікація та вимоги до файлів](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#prepare)
- [Перегляд кінцевих точок](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#endpoints)
- [Batch або Bulk?](https://flashdata.dev/uk/docs/reference/batch-and-bulk/reference.md)

<a id="endpoints"></a>

## Напрямки

Всі кінцеві точки використовують https://api.flashdata.dev/v2. Створіть роботу → завантажте відео-ID файл → start → монітор → отримати проявляється і кожен результат частина.

| Методологія | Доля | Дія |
| --- | --- | --- |
| POST | /v2/bulk-jobs | Створити роботу Bulk |
| POST | /v2/bulk-jobs/{bulkId}/start | Завантажити і почати |
| GET | /v2/bulk-jobs/{bulkId} | Отримати статус роботи |
| GET | /v2/bulk-jobs | Список робочих місць |
| POST | /v2/bulk-jobs/{bulkId}/pause | Запобігти роботі |
| PATCH | /v2/bulk-jobs/{bulkId} | Оновити параметри роботи |
| POST | /v2/bulk-jobs/{bulkId}/resume | Оформити роботу |
| DELETE | /v2/bulk-jobs/{bulkId} | Скасувати роботу |
| GET | /v2/bulk-jobs/{bulkId}/results | Отримати результат проявляється |
| GET | /v2/bulk-jobs/{bulkId}/results/{partNumber} | Завантажити деталі результату |

- [Batch або Bulk?](https://flashdata.dev/uk/docs/reference/batch-and-bulk/reference.md)
- [End-to-end Bulk керівництво](https://flashdata.dev/uk/docs/guides/bulk/reference.md)
- [Специфікація OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="prepare"></a>

## Ауттентифікація та введення

Встановіть FLASHDATA_API_KEY на ключ з доступом до вибраного джерела. Використовуйте той самий ключ і обліковий запис для створення, управління та результати. Обробка використовує баланс облікового запису та нормалізацію надр. YouTube Download вимагає доступу власника і options.storage.

Створіть робочу папку, яка названа сипучих/ і запустіть ці приклади з неї. Повний ігровий майданчик Python використовує стандартну бібліотеку Python 3.10+; індивідуальні приклади кінцевих точок Python нижче, ніж вимагають запитань; приклади cURL використовують Bash, cURL 7.76+, jq і gzip. Виберіть одну мову для кожної дії, так що ви не створюєте або починаєте дублікати роботи.

Вхід - UTF-8 файл з одним 11-character YouTube ID на лінію, до 2 GiB. Використовуйте IDs, не URLs. Видалити дублікати IDs перед завантаженням; повторний IDs обробляються окремо.

| Джерело | Додаткові параметри |
| --- | --- |
| youtube_metadata | include_formats, include_chapters |
| youtube_transcript | мова, авто |
| youtube_captions | мова, авто |
| youtube_trainability | Немає опцій |
| youtube_download | Параметри та призначення носіїв |

### Python залежностей

```bash
python -m pip install requests
```

- [API ключі та заголовки](https://flashdata.dev/uk/docs/guides/headers-and-authentication/reference.md)
- [Поле зберігання](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#storage)

<a id="request-body"></a>

## Створіть поля запиту

| Поле | Типи | Закупи |
| --- | --- | --- |
| source | string | Потрібні. Підтримуваний джерело для кожного входу ID. |
| options | object | Загальні параметри джерела. Джерела даних можуть встановлювати result_storage; YouTube Download вимагає зберігання. |
| callback_url | string | Необов'язково громадський HTTPS зворотний дзвінок. Протипоказання після явної публікації. |

- [Повний запит schema](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [Webhook обробка](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#webhooks)

<a id="createBulkJob"></a>

## Створити роботу Bulk

Створіть роботу, завантажте текстовий файл UTF-8 з одним 11-character YouTube відео ID на лінії upload.href, після чого зателефонуйте старт. Створення роботи самостійно не починається обробки.

Цей приклад пише video-ids.txt і зберігає надходження 201 до bulk-created.json. Зберігайте, що отримання приватного та повторного використання job.id для кожного пізнішого запиту. Створюючи робочі листи в awaiting_upload; завантаження URL закінчується після 15 хвилин.

### Навігація

```http
POST https://api.flashdata.dev/v2/bulk-jobs
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте bulk_create.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### bulk_create.py

```python
import json
import os
from pathlib import Path

import requests

os.umask(0o077)
Path("video-ids.txt").write_bytes(b"jNQXAC9IVRw\ndQw4w9WgXcQ\n")
response = requests.post(
    "https://api.flashdata.dev/v2/bulk-jobs",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    json={"source": "youtube_metadata", "options": {"include_formats": False}},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
receipt = response.json()
Path("bulk-created.json").write_text(json.dumps(receipt, indent=2), encoding="utf-8")
print(json.dumps(receipt["job"], indent=2))
```

#### Запуск з сипучих/

```bash
python bulk_create.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
umask 077
printf '%s\n' 'jNQXAC9IVRw' 'dQw4w9WgXcQ' > video-ids.txt
curl --fail-with-body --silent --show-error \
  'https://api.flashdata.dev/v2/bulk-jobs' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"source":"youtube_metadata","options":{"include_formats":false}}' \
  --output bulk-created.json &&
jq '.job | {id, source, status}' bulk-created.json
```


- [CreateBulkJobRequest](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [BulkJobCreated](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobCreated)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="createBulkJob-responses"></a>

### Відповіді та запит схема

| HTTP статус | Зручності |
| --- | --- |
| 201 | Bulk створений з 15-хвилинним прямим завантаженням URL |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 422 | Заява про те, що не вдалося |
| 503 | Необхідна залежність або каталог тимчасово недоступний |

#### Тіло запиту

```json
{
  "$ref": "#/components/schemas/CreateBulkJobRequest"
}
```

#### 201 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobCreated"
}
```


<a id="startBulkJob"></a>

## Завантажити і почати

Почати обробку завантаженого UTF-8 відео ID файл, до 2 GiB (2147483648 байтів). Зберігати файл, що змінюється після початку.

Перший PUT video-ids.txt до отримання upload.href з upload.contentType, без X-API-Key. Приклад викликів стартує тільки після того, як завантажити вдасться. Зберігайте завантажений файл, який не змінюється після

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| bulkId | path | Обов’язково · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Навігація

```http
POST https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/start
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте bulk_start.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### bulk_start.py

```python
import json
import os
from pathlib import Path

import requests

receipt = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))
upload = receipt["upload"]
if upload["method"] != "PUT" or not upload["href"].startswith("https://"):
    raise ValueError("Expected an HTTPS PUT upload URL")
# Stream the file to storage without the FlashData key.
with open("video-ids.txt", "rb") as file:
    response = requests.put(
        upload["href"], data=file,
        headers={"Content-Type": upload["contentType"]},
        timeout=300, allow_redirects=False,
    )
    response.raise_for_status()
    if not 200 <= response.status_code < 300:
        raise RuntimeError("Upload did not complete; do not start the job yet")

bulk_id = receipt["job"]["id"]
response = requests.post(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/start",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json()["job"], indent=2))
```

#### Запуск з сипучих/

```bash
python bulk_start.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
UPLOAD_URL=$(jq -er '.upload.href' bulk-created.json)
CONTENT_TYPE=$(jq -er '.upload.contentType' bulk-created.json)
curl --fail-with-body --silent --show-error --proto '=https' \
  --header "Content-Type: $CONTENT_TYPE" \
  --upload-file video-ids.txt "$UPLOAD_URL" &&
curl --fail-with-body --silent --show-error --request POST \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/start" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}"
```


- [BulkJobResponse](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="startBulkJob-responses"></a>

### Відповіді

| HTTP статус | Зручності |
| --- | --- |
| 200 | Bulk розпочато роботу або його поточний стан idempotent |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 404 | Ресурс не знайдено або не належить абоненту |
| 409 | Конфлікт з питань ресурсного стану або відповідальності |
| 422 | Заява про те, що не вдалося |
| 503 | Необхідна залежність або каталог тимчасово недоступний |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="getBulkJob"></a>

## Отримати статус роботи

Читати далі job.status, вхід, кількість, pauseReason і помилки. Зніміть те ж саме ID з затримкою; завершений засіб проявляється, не що кожна відео досягла успіху.

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| bulkId | path | Обов’язково · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Навігація

```http
GET https://api.flashdata.dev/v2/bulk-jobs/{bulkId}
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте bulk_status.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### bulk_status.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.get(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
Path("bulk-job.json").write_text(json.dumps(response.json(), indent=2), encoding="utf-8")
print(json.dumps(response.json()["job"], indent=2))
```

#### Запуск з сипучих/

```bash
python bulk_status.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --output bulk-job.json &&
jq '.job | {id, status, counts, pauseReason, error, expiresAt}' bulk-job.json
```


- [BulkJobResponse](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="getBulkJob-responses"></a>

### Відповіді

| HTTP статус | Зручності |
| --- | --- |
| 200 | Bulk стан роботи |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 404 | Ресурс не знайдено або не належить абоненту |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="listBulkJobs"></a>

## Список робочих місць

Відповідність містить дані та патологія. Пройдіть pagination.nextCursor як наступний параметр запиту, доки він є null. Використовуйте ліміт від 1 до 50; за замовчуванням 20.

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| cursor | query | Необов’язково · {"type":"string","maxLength":512} |
| limit | query | Необов’язково · {"type":"integer","minimum":1,"maximum":50,"default":20} |

### Навігація

```http
GET https://api.flashdata.dev/v2/bulk-jobs
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте list_bulk_jobs.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### list_bulk_jobs.py

```python
import json
import os
from pathlib import Path

import requests

response = requests.get(
    "https://api.flashdata.dev/v2/bulk-jobs?limit=20",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### Запуск з сипучих/

```bash
python list_bulk_jobs.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
curl --fail-with-body --silent --show-error --max-time 30 \
  --request GET \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  "https://api.flashdata.dev/v2/bulk-jobs?limit=20"
```


- [BulkJobPage](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobPage)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="listBulkJobs-responses"></a>

### Відповіді

| HTTP статус | Зручності |
| --- | --- |
| 200 | Bulk робоча сторінка |
| 401 | Ауттентифікація, обов'язкова або недійсна |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobPage"
}
```


<a id="pauseBulkJob"></a>

## Запобігти роботі

Застосувати нові надходження та кінцеву упаковку. Виконуючи робочі місця, що продовжуються з оригінальними налаштуваннями та зарядами. Зроби роботу при готовності.

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| bulkId | path | Обов’язково · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Навігація

```http
POST https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/pause
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте pause_bulk_job.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### pause_bulk_job.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.post(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/pause",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### Запуск з сипучих/

```bash
python pause_bulk_job.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --request POST \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/pause"
```


- [BulkJobResponse](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="pauseBulkJob-responses"></a>

### Відповіді

| HTTP статус | Зручності |
| --- | --- |
| 200 | Використовуються об'ємні роботи або його поточний стан |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 404 | Ресурс не знайдено або не належить абоненту |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="updateBulkJob"></a>

## Оновити параметри роботи

Оновити параметри при очікуванні завантаження, або при пауті до всіх вхідних даних. Виконуючи робочі місця, зберігайте свої налаштування. Якщо паусінг ще триває, чекайте та переробляйте відповідь 409. Після того, як всі дані були прочитані, можна оновити лише дані доставки. Набір callback_url до null для видалення його.

Цей приклад видаляє зворотний дзвінок. Щоб змінити параметри джерела, надішлемо параметри об'єкта. Запобігти першому і чекати паузу, щоб прийняти ефект; 409 означає, що оновлення не можна застосувати ще. Ведуться роботи дитини зберігають свої оригінальні варіанти.

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| bulkId | path | Обов’язково · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Навігація

```http
PATCH https://api.flashdata.dev/v2/bulk-jobs/{bulkId}
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте update_bulk_job.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### update_bulk_job.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.patch(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    json={"callback_url": None},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### Запуск з сипучих/

```bash
python update_bulk_job.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --request PATCH \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' --data '{"callback_url":null}' \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID"
```


- [UpdateBulkJobRequest](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-UpdateBulkJobRequest)
- [BulkJobResponse](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="updateBulkJob-responses"></a>

### Відповіді та запит схема

| HTTP статус | Зручності |
| --- | --- |
| 200 | Оновлений загальний стан роботи |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 404 | Ресурс не знайдено або не належить абоненту |
| 409 | Конфлікт з питань ресурсного стану або відповідальності |
| 422 | Заява про те, що не вдалося |

#### Тіло запиту

```json
{
  "$ref": "#/components/schemas/UpdateBulkJobRequest"
}
```

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="resumeBulkJob"></a>

## Оформити роботу

Виправлено pauseReason першим, таким як додавання кредитів або оновлення облікових даних зберігання, потім відновити те ж саме Bulk ID.

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| bulkId | path | Обов’язково · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Навігація

```http
POST https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/resume
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте resume_bulk_job.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### resume_bulk_job.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.post(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/resume",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### Запуск з сипучих/

```bash
python resume_bulk_job.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --request POST \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/resume"
```


- [BulkJobResponse](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="resumeBulkJob-responses"></a>

### Відповіді

| HTTP статус | Зручності |
| --- | --- |
| 200 | Поточний стан роботи на сипучих роботах |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 404 | Ресурс не знайдено або не належить абоненту |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="cancelBulkJob"></a>

## Скасувати роботу

Стоп нові подання. Забезпечити роботу ще finish і неточувати їх нормальними зарядами. Відмінна робота не публікує остаточний проміжок.

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| bulkId | path | Обов’язково · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Навігація

```http
DELETE https://api.flashdata.dev/v2/bulk-jobs/{bulkId}
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте cancel_bulk_job.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### cancel_bulk_job.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.delete(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(json.dumps(response.json(), indent=2))
```

#### Запуск з сипучих/

```bash
python cancel_bulk_job.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --request DELETE \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID"
```


- [BulkJobResponse](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="cancelBulkJob-responses"></a>

### Відповіді

| HTTP статус | Зручності |
| --- | --- |
| 200 | Поточний стан роботи на сипучих роботах |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 404 | Ресурс не знайдено або не належить абоненту |

#### 200 · application/json

```json
{
  "$ref": "#/components/schemas/BulkJobResponse"
}
```


<a id="downloadBulkJobManifest"></a>

## Отримати результат проявляється

Дотримуйтесь перенаправлення, щоб завантажити JSON проявляється і використовувати його посилання для отримання файлів результатів. Зареєструйтеся на зберігання URLs без ключа API. Доступні результати 24 годин після всього Bulk робота завершується.

Успішний запит API повертається 302 з головуванням розташування. Fetch, що HTTPS зберігання URL в окремому запиті без X-API-Key. Приклад зберігає manifest.json. 409 означає результати не готові; 410 означає, що вони закінчуються.

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| bulkId | path | Обов’язково · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Навігація

```http
GET https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/results
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте bulk_manifest.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### bulk_manifest.py

```python
import json
import os
from pathlib import Path

import requests

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
response = requests.get(
    f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/results",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
if response.status_code != 302:
    raise RuntimeError(f"Expected a manifest redirect, got {response.status_code}")
url = response.headers["Location"]
if not url.startswith("https://"):
    raise ValueError("Expected an HTTPS storage URL")

manifest = requests.get(url, timeout=120)  # No FlashData API key.
manifest.raise_for_status()
Path("manifest.json").write_text(json.dumps(manifest.json(), indent=2), encoding="utf-8")
print(json.dumps(manifest.json(), indent=2))
```

#### Запуск з сипучих/

```bash
python bulk_manifest.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
# Only send the API key to FlashData; fetch storage URLs separately.
fetch_bulk_result() {
  local storage_url
  storage_url=$(curl --fail-with-body --silent --show-error \
    "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/results$1" \
    --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
    --output /dev/null --write-out '%{redirect_url}') || return
  curl --fail-with-body --silent --show-error --proto '=https' \
    "${storage_url:?Expected a signed result URL}" --output "$2"
}
fetch_bulk_result '' manifest.json &&
jq '{status, counts, parts, expires_at}' manifest.json
```


- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="downloadBulkJobManifest-responses"></a>

### Відповіді

| HTTP статус | Зручності |
| --- | --- |
| 200 | JSON проявляється після перенаправлення |
| 302 | Перенаправлення на короткочасний приватний R2 URL; API не повинні бути переадресовані · Location |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 404 | Ресурс не знайдено або не належить абоненту |
| 409 | Конфлікт з питань ресурсного стану або відповідальності |
| 410 | Затриманий результат вибухнув |

#### 200 · application/json

```json
{
  "type": "object",
  "additionalProperties": true
}
```


<a id="downloadBulkJobPart"></a>

## Завантажити деталі результату

Використовуйте кожен parts[].number від manifest.json. Кожна кінцева точка повертає 302 на Gzip NDJSON файл; скачати без ключа API, декомпресувати, потім записати один об'єкт JSON на рядок. Приєднатися до індексу нульової бази. Приклад отримує всі частини і зберігає як .ndjson.gz і .ndjson файли.

| Параметр | Місцезнаходження | Закупівля |
| --- | --- | --- |
| bulkId | path | Обов’язково · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |
| partNumber | path | Обов’язково · {"type":"integer","minimum":0} |

### Навігація

```http
GET https://api.flashdata.dev/v2/bulk-jobs/{bulkId}/results/{partNumber}
X-API-Key: YOUR_API_KEY
```

### Python

Заощаджуйте bulk_parts.py на сипучих та бокових bulk-created.json. Скопіюйте загальний скрипт, потім запустіть команду нижче.

#### bulk_parts.py

```python
import json
import os
from pathlib import Path

import requests
import gzip
import shutil

bulk_id = json.loads(Path("bulk-created.json").read_text(encoding="utf-8"))["job"]["id"]
manifest = json.loads(Path("manifest.json").read_text(encoding="utf-8"))
for part in manifest["parts"]:
    number = part["number"]
    response = requests.get(
        f"https://api.flashdata.dev/v2/bulk-jobs/{bulk_id}/results/{number}",
        headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
        timeout=30, allow_redirects=False,
    )
    response.raise_for_status()
    if response.status_code != 302:
        raise RuntimeError(f"Expected a part redirect, got {response.status_code}")
    url = response.headers["Location"]
    if not url.startswith("https://"):
        raise ValueError("Expected an HTTPS storage URL")

    # Save the original gzip bytes; do not decompress twice.
    with requests.get(url, stream=True, timeout=120) as download:
        download.raise_for_status()
        with open(f"part-{number}.ndjson.gz", "wb") as file:
            download.raw.decode_content = False
            shutil.copyfileobj(download.raw, file)
    with gzip.open(f"part-{number}.ndjson.gz", "rt", encoding="utf-8") as rows:
        with open(f"part-{number}.ndjson", "w", encoding="utf-8") as file:
            for line in rows:
                file.write(line)
                print(json.dumps(json.loads(line)))
```

#### Запуск з сипучих/

```bash
python bulk_parts.py
```


### cURL / Bash

#### Запуск з сипучих/

```bash
BULK_ID=$(jq -er '.job.id' bulk-created.json)
# Only send the API key to FlashData; fetch storage URLs separately.
fetch_bulk_result() {
  local storage_url
  storage_url=$(curl --fail-with-body --silent --show-error \
    "https://api.flashdata.dev/v2/bulk-jobs/$BULK_ID/results$1" \
    --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
    --output /dev/null --write-out '%{redirect_url}') || return
  curl --fail-with-body --silent --show-error --proto '=https' \
    "${storage_url:?Expected a signed result URL}" --output "$2"
}
fetch_bulk_result '' manifest.json &&
jq '{status, counts, parts, expires_at}' manifest.json

# Run in the same Bash session as fetch_bulk_result.
jq -r '.parts[].number' manifest.json | while IFS= read -r PART; do
  fetch_bulk_result "/$PART" "part-$PART.ndjson.gz" || exit
  gzip -dc "part-$PART.ndjson.gz" > "part-$PART.ndjson" || exit
  jq -c '{index, video_id, status, results, error}' "part-$PART.ndjson"
done
```


- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)

<a id="downloadBulkJobPart-responses"></a>

### Відповіді

| HTTP статус | Зручності |
| --- | --- |
| 200 | Gzip-compressed NDJSON скачати після перенаправлення |
| 302 | Перенаправлення на короткочасний приватний R2 URL; API не повинні бути переадресовані · Location |
| 401 | Ауттентифікація, обов'язкова або недійсна |
| 404 | Ресурс не знайдено або не належить абоненту |
| 409 | Конфлікт з питань ресурсного стану або відповідальності |
| 410 | Затриманий результат вибухнув |

#### 200 · application/x-ndjson

```json
{
  "type": "string"
}
```


<a id="states"></a>

## Стани та затримка робочих місць

Доступні результати 24 годин після всього Bulk робота завершується. Збережіть їх до expiresAt. Медіа у Вашому пункті слідувати політиці збереження відро. Закінчена робота може включати не вдалося відео; counts.invalid записів відхилених вхідних ліній.

| Державна державна адміністрація | Попередня дія |
| --- | --- |
| awaiting_upload | Завантажте файл і зателефонуйте. |
| running | Поповнити те ж ID з відворотом; input.complete показує, чи закінчиться сканування. |
| paused | Читать pauseReason, зафіксуйте його, потім відновіть. |
| finalizing | Очікується на результат упаковки і проявляється публікація. |
| completed | Завантажити проявляється і кожна частина. Огляньте статус кожного рядка і похибку. |
| failed / cancelled | Похибка і збережена держава. Не публікується остаточний проявляється. |

- [Помилки й коди стану](https://flashdata.dev/uk/docs/errors/reference.md)
- [Відновити роботу Bulk](https://flashdata.dev/uk/docs/guides/bulk/reference.md#controls)

<a id="storage"></a>

## Доставка сховищ

Використовуйте дитячий майданчик для налаштування провайдера та попереднього перегляду точну поля запиту. Принципи зберігання клієнтів, що належать до об'єкта, вибраного зберігання; X-API-Key автентизує тільки FlashData API запитів.

| Джерело | Створити поле запиту | Доставка |
| --- | --- | --- |
| Метадані, трафарет, підписки, перевірка ліцензії | options.result_storage | Необов'язково. Copies NDJSON результат частини і проявляється до вашого відро. |
| youtube_download | options.storage | Потрібні. Виконує медіа на відро; result_storage і browser_delivery не приймаються. |

- [Основні напрямки діяльності компанії](https://flashdata.dev/uk/docs/sources/youtube_download/reference.md#storage)
- [Налаштування місця зберігання](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#playground)

<a id="storage-layout"></a>

### Знайдіть завантажені файли

Дані проявляються письмовими останніми і списками ключових слів об'єкта, розмірів і SHA-256. Він відрізняється від прояви FlashData, який списує значення API. YYYYMMDDDD у доріжках даних використовує дату створення UTC Bulk; в медіа-стеженнях він використовує дату завантаження кожного відео UTC. Bulk Доставка даних OSS вимагає aliyuncs.com кінцева точка.

Приватні медіа file_url значення потребують вашого зберігання SDK або підписаного URL від цього провайдера. Ключ FlashData не надає доступу до відро. Необов'язкові файли метаданих, що зберігаються усередку носіїв. З'являються ретилії в delivery.retryCount.

#### Планування об'єкта даних

```text
<prefix>/<source>/<bulkId>/results/part-NNNNNNNN.jsonl.gz
<prefix>/<source>/<bulkId>/manifest.json
```


<a id="webhooks"></a>

## Отримувати вебхоок

Місце громадськості HTTPS callback_url поза варіантами. Bulk надсилається тільки після публікації проявляється; він відправляється не на відео події і не відмовляється від завершення події для невдалих або скасованих робочих місць. Зберігайте опитування стану як падлогу.

1. Персист і deduplicate delivery_id, потім повертаємо 2xxx оперативно. Доставка восьмих разів з відключенням.
2. Події не відмічаються. Збігти id і джерело до збереженого чека; перевірити, що завершено через автентичне управління API до отримання ретривалю. Ignore URLs від неперевершеного заходу.

### Створіть запит з зворотним зв'язком

```json
{
  "source": "youtube_metadata",
  "options": {
    "include_formats": false,
    "include_chapters": false
  },
  "callback_url": "https://your-app.example/webhooks/flashdata"
}
```

### Проведення заходів · ілюстративний

```json
{
  "delivery_id": "bulk-completion:bulk_EXAMPLE123",
  "id": "bulk_EXAMPLE123",
  "source": "youtube_metadata",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/bulk-jobs/bulk_EXAMPLE123",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/bulk-jobs/bulk_EXAMPLE123/results",
      "method": "GET"
    }
  ]
}
```

- [Генерація ресивера приймача Node Webhook](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#playground)

<a id="schemas"></a>

## Визначення стеми

- [BulkJobCreated](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobCreated)
- [BulkJob](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJob)
- [BulkJobPage](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobPage)
- [BulkJobResponse](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [CreateBulkJobRequest](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [JobLink](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-JobLink)
- [Pagination](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Pagination)
- [Problem](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Problem)
- [FieldError](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-FieldError)
- [UpdateBulkJobRequest](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-UpdateBulkJobRequest)

<a id="schema-BulkJobCreated"></a>

### BulkJobCreated

#### BulkJobCreated

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "job",
    "upload"
  ],
  "properties": {
    "job": {
      "$ref": "#/components/schemas/BulkJob"
    },
    "upload": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "href",
        "method",
        "expiresAt",
        "contentType"
      ],
      "properties": {
        "href": {
          "type": "string",
          "format": "uri"
        },
        "method": {
          "type": "string",
          "const": "PUT"
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "contentType": {
          "type": "string",
          "const": "text/plain; charset=utf-8"
        }
      }
    }
  }
}
```

- [BulkJob](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJob)

<a id="schema-BulkJob"></a>

### BulkJob

#### BulkJob

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "source",
    "status",
    "input",
    "counts",
    "delivery",
    "pauseReason",
    "error",
    "createdAt",
    "startedAt",
    "completedAt",
    "expiresAt",
    "links"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^bulk_[A-Za-z0-9_-]{8,}$"
    },
    "source": {
      "type": "string",
      "enum": [
        "youtube_metadata",
        "youtube_transcript",
        "youtube_captions",
        "youtube_trainability",
        "youtube_download"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "awaiting_upload",
        "running",
        "paused",
        "finalizing",
        "completed",
        "failed",
        "cancelled"
      ]
    },
    "input": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "bytes",
        "complete",
        "scannedBytes",
        "scannedLines"
      ],
      "properties": {
        "bytes": {
          "type": "integer",
          "minimum": 0
        },
        "complete": {
          "type": "boolean"
        },
        "scannedBytes": {
          "type": "integer",
          "minimum": 0
        },
        "scannedLines": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "counts": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "accepted",
        "completed",
        "failed",
        "invalid",
        "results"
      ],
      "properties": {
        "accepted": {
          "type": "integer",
          "minimum": 0
        },
        "completed": {
          "type": "integer",
          "minimum": 0
        },
        "failed": {
          "type": "integer",
          "minimum": 0
        },
        "invalid": {
          "type": "integer",
          "minimum": 0
        },
        "results": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "pauseReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "delivery": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "customerStorage",
        "storageType",
        "uploadedParts",
        "retryCount"
      ],
      "properties": {
        "customerStorage": {
          "type": "boolean"
        },
        "storageType": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "s3",
            "s3_compatible",
            "oss",
            "gcs",
            "azure",
            "cos",
            "bos",
            "tos",
            null
          ]
        },
        "uploadedParts": {
          "type": "integer",
          "minimum": 0
        },
        "retryCount": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "error": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "code",
            "detail"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "detail": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      ]
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    },
    "startedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "completedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "expiresAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "links": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/JobLink"
      }
    }
  }
}
```

- [JobLink](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-JobLink)

<a id="schema-BulkJobPage"></a>

### BulkJobPage

#### BulkJobPage

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "pagination"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/BulkJob"
      }
    },
    "pagination": {
      "$ref": "#/components/schemas/Pagination"
    }
  }
}
```

- [BulkJob](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJob)
- [Pagination](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-Pagination)

<a id="schema-BulkJobResponse"></a>

### BulkJobResponse

#### BulkJobResponse

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "job"
  ],
  "properties": {
    "job": {
      "$ref": "#/components/schemas/BulkJob"
    }
  }
}
```

- [BulkJob](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-BulkJob)

<a id="schema-CreateBulkJobRequest"></a>

### CreateBulkJobRequest

#### CreateBulkJobRequest

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "source"
  ],
  "properties": {
    "source": {
      "type": "string",
      "enum": [
        "youtube_metadata",
        "youtube_transcript",
        "youtube_captions",
        "youtube_trainability",
        "youtube_download"
      ]
    },
    "options": {
      "type": "object",
      "additionalProperties": true,
      "description": "Reused for every ID. Metadata accepts include_formats and include_chapters. Transcript and captions accept language (one code or an array of 1–10 distinct codes) and auto (applies to all requested languages). Omit language to prefer en-orig, fall back to en, and return one track. With auto=true, each requested code tries its -orig track first, then the plain code. Explicit -orig codes and auto=false stay exact. languageCode identifies the selected track; requestedLanguageCode is included when it differs from the requested code. A language array returns tracks and per-language errors for each video with at least one retrieved track. If no track is retrieved, the video job fails and its reserved credits are refunded. Bulk exports use one JSONL record per video. Trainability accepts no source options. These four data sources optionally accept result_storage. Supported storage_type values are s3, s3_compatible, oss, gcs, azure, cos, bos, and tos. storage_url is the bucket name (Azure container name); object_prefix is optional. S3, S3-compatible, OSS, COS, BOS, and TOS use access_key and secret_key. S3-compatible and OSS also require a public HTTPS endpoint_url. COS, BOS, and TOS require region and use fixed provider endpoints. COS bucket names include the APPID. BOS S3-compatible HTTPS delivery supports bj, su, and hkg. GCS requires service_account with project_id, client_email, and private_key. Azure requires account_name and a container SAS sas_token with write permission. Default object_prefix is YYYYMMDD, frozen to the UTC bulk creation date. Files are written to <prefix>/<source>/<bulkId>/results/part-NNNNNNNN.jsonl.gz; manifest.json in the same bulk directory is written last. Each JSONL row includes its input index and completed, failed, or invalid status. Internal R2 results remain available through the result links for 24 hours. Download accepts the normal YouTube download parameters, requires customer storage, and does not permit browser_delivery. Download storage supports the same eight provider types and credential shapes listed above under the storage field. Download storage may include object_prefix; YYYYMMDD tokens resolve to the UTC upload date, while literal prefixes are unchanged."
    },
    "callback_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Optional public HTTPS endpoint notified once after manifest publication."
    }
  }
}
```


<a id="schema-JobLink"></a>

### JobLink

#### JobLink

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "rel",
    "href",
    "method"
  ],
  "properties": {
    "rel": {
      "type": "string",
      "enum": [
        "self",
        "results",
        "content",
        "download"
      ]
    },
    "href": {
      "type": "string",
      "format": "uri"
    },
    "method": {
      "type": "string",
      "const": "GET"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time"
    },
    "filename": {
      "type": "string"
    },
    "content_type": {
      "type": "string"
    },
    "size_bytes": {
      "type": "integer",
      "minimum": 1
    }
  }
}
```


<a id="schema-Pagination"></a>

### Pagination

#### Pagination

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "hasMore",
    "limit"
  ],
  "properties": {
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "previousCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "hasMore": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}
```


<a id="schema-Problem"></a>

### Problem

#### Problem

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "type",
    "title",
    "status",
    "code",
    "requestId"
  ],
  "properties": {
    "type": {
      "type": "string",
      "format": "uri-reference"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": 400,
      "maximum": 599
    },
    "code": {
      "type": "string",
      "pattern": "^[a-z0-9_]+$"
    },
    "detail": {
      "type": "string"
    },
    "requestId": {
      "type": "string",
      "pattern": "^req_"
    },
    "fieldErrors": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/FieldError"
      }
    }
  }
}
```

- [FieldError](https://flashdata.dev/uk/docs/reference/bulk-processing/reference.md#schema-FieldError)

<a id="schema-FieldError"></a>

### FieldError

#### FieldError

```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "field",
    "code",
    "message"
  ],
  "properties": {
    "field": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    }
  }
}
```


<a id="schema-UpdateBulkJobRequest"></a>

### UpdateBulkJobRequest

#### UpdateBulkJobRequest

```json
{
  "type": "object",
  "additionalProperties": false,
  "minProperties": 1,
  "properties": {
    "options": {
      "type": "object",
      "additionalProperties": true,
      "description": "Partial option update. Nested storage fields are merged so unchanged credentials do not need to be resent. Data result_storage fields are merged the same way. After all IDs have been scanned, a paused data bulk job accepts credential updates only: access_key and secret_key, GCS service_account, or Azure sas_token, depending on the storage type. The complete merged configuration is validated before it is stored."
    },
    "callback_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "maxLength": 2048,
      "description": "Replacement completion callback, or null to remove the callback."
    }
  }
}
```

