# API pemrosesan Bulk

Membuat dan mengontrol berkas berbasis YouTube pekerjaan, kemudian mengambil manifestasi mereka dan bagian hasil.

Referensi kanonikal: https://flashdata.dev/id/docs/reference/bulk-processing
Diulang: 2026-11-05 oleh FlashData

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

## Playground API

Pilih sumber dan salin lengkap alur kerja Python atau Bash, satu permintaan, atau sebuah respon cuplikan. Pratilik taman bermain kode; tidak mengirimkan pekerjaan. Lengkap cardflow handle upload, status checks and retrieval dari setiap bagian hasil.

- [Otentikasi dan persyaratan berkas](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#prepare)
- [Menelusuri titik akhir](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#endpoints)
- [Batch atau Bulk?](https://flashdata.dev/id/docs/reference/batch-and-bulk/reference.md)

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

## Titik Akhir

Semua titik akhir gunakan https://api.flashdata.dev/v2. Buat suatu pekerjaan yang hendak diunggah ke videoID berkas £1st monitor engkau dapat mengambil manifest dan setiap bagian hasil.

| Metode | Path | Aksi |
| --- | --- | --- |
| POST | /v2/bulk-jobs | Buat pekerjaan Bulk |
| POST | /v2/bulk-jobs/{bulkId}/start | Unggah dan mulai |
| GET | /v2/bulk-jobs/{bulkId} | Dapatkan status pekerjaan |
| GET | /v2/bulk-jobs | Daftar tugas |
| POST | /v2/bulk-jobs/{bulkId}/pause | Jeda pekerjaan |
| PATCH | /v2/bulk-jobs/{bulkId} | Mutakhirkan opsi pekerjaan |
| POST | /v2/bulk-jobs/{bulkId}/resume | Lanjutkan pekerjaan |
| DELETE | /v2/bulk-jobs/{bulkId} | Batalkan tugas |
| GET | /v2/bulk-jobs/{bulkId}/results | Dapatkan daftar muatan hasil |
| GET | /v2/bulk-jobs/{bulkId}/results/{partNumber} | Unduh bagian hasil |

- [Batch atau Bulk?](https://flashdata.dev/id/docs/reference/batch-and-bulk/reference.md)
- [End-to-end Bulk panduan](https://flashdata.dev/id/docs/guides/bulk/reference.md)
- [Spesifikasi OpenAPI](https://flashdata.dev/docs/openapi.json)

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

## Otentikasi dan masukan

Set FLASHDATA_API_KEY ke kunci dengan akses ke sumber yang dipilih. Gunakan kembali kunci dan akun yang sama untuk pembuatan, kontrol, dan hasil. Pemrosesan menggunakan saldo akun dan harga yang normal. YouTube Download membutuhkan akses pemilik dan options.storage.

Membuat folder kerja bernama bulk-api / dan menjalankan contoh-contoh ini dari itu. Taman bermain selesai Python arus kerja menggunakan Python 3.10+ perpustakaan standar; individu Python contoh titik akhir di bawah ini membutuhkan Permintaan; cURL contoh menggunakan Bash, cURL 7.76+, jq dan gzip. Pilih satu bahasa untuk setiap aksi sehingga Anda tidak membuat atau mulai menduplikasi pekerjaan.

Masukan adalah UTF-8 berkas dengan satu 11-character YouTube ID per baris, sampai 2 GiB. Gunakan IDs, bukan URLs. Hapus duplikat IDs sebelum mengunggah; diulang IDs diproses secara terpisah.

| Sumber | Opsi bersama |
| --- | --- |
| youtube_metadata | include_formats, include_chapters |
| youtube_transcript | bahasa, otomatis |
| youtube_captions | bahasa, otomatis |
| youtube_trainability | Tidak ada opsi |
| youtube_download | Opsi media dan tujuan penyimpanan |

### Python ketergantungan

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

- [API kunci dan header](https://flashdata.dev/id/docs/guides/headers-and-authentication/reference.md)
- [Ruas penyimpanan](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#storage)

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

## Buat ruas permintaan

| Ruas | Jenis | Penggunaan |
| --- | --- | --- |
| source | string | Perlu. Satu sumber yang didukung untuk setiap masukan ID. |
| options | object | Opsi sumber bersama. Sumber data dapat mengatur result_storage; YouTube Download membutuhkan penyimpanan. |
| callback_url | string | HTTPS publik opsional call back selesai. Dikirim setelah publikasi yang jelas. |

- [Skema permintaan penuh](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [Tatanan Webhook](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#webhooks)

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

## Buat pekerjaan Bulk

Membuat pekerjaan, mengunggah UTF-8 berkas teks dengan satu 11-character YouTube video ID per baris ke upload.href, kemudian panggilan mulai. Membuat pekerjaan sendiri tidak mulai memproses.

Contoh ini menulis video-ids.txt dan menyimpan tanda terima 201 ke bulk-created.json. Simpan tanda terima itu secara pribadi dan gunakan job.id untuk setiap permintaan nanti. Membuat pekerjaan meninggalkannya di awaiting_upload; upload URL berakhir setelah 15 menit.

### Endpoint

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

### Python

Simpan bulk_create.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python bulk_create.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [BulkJobCreated](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-BulkJobCreated)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Menanggapi dan meminta skema

| Status HTTP | Artinya |
| --- | --- |
| 201 | Bulk pekerjaan yang dibuat dengan 15Q- menit langsung upload URL |
| 401 | Otentikasi diperlukan atau tak valid |
| 422 | Permintaan validasi gagal |
| 503 | Ketergantungan atau katalog yang diperlukan sementara tidak tersedia |

#### Isi permintaan

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

#### 201 · application/json

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


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

## Unggah dan mulai

Mulai memproses video UTF-8 terunggah ID, hingga ke 2 GiB (2147483648 bytes). Menjaga berkas tidak berubah setelah dimulai.

Pertama PUT video-ids.txt untuk tanda terima upload.href dengan upload.contentType, tanpa X-API-Key. Contoh panggilan dimulai hanya setelah upload sukses. Menjaga file upload tidak berubah sesudahnya.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| bulkId | path | Wajib · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

Simpan bulk_start.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python bulk_start.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Respon

| Status HTTP | Artinya |
| --- | --- |
| 200 | Bulk pekerjaan dimulai atau keadaan idempoten saat ini |
| 401 | Otentikasi diperlukan atau tak valid |
| 404 | Sumber daya tidak ditemukan atau tidak dimiliki oleh penelepon |
| 409 | Kondisi sumber daya atau konflik idempotency |
| 422 | Permintaan validasi gagal |
| 503 | Ketergantungan atau katalog yang diperlukan sementara tidak tersedia |

#### 200 · application/json

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


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

## Dapatkan status pekerjaan

Baca job.status, masukan, jumlah, pauseReason dan error. Periksa ulang ID yang sama dengan penundaan; selesai berarti manifest diterbitkan, bukan berarti setiap video berhasil.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| bulkId | path | Wajib · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

Simpan bulk_status.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python bulk_status.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Respon

| Status HTTP | Artinya |
| --- | --- |
| 200 | Bulk kondisi tugas |
| 401 | Otentikasi diperlukan atau tak valid |
| 404 | Sumber daya tidak ditemukan atau tidak dimiliki oleh penelepon |

#### 200 · application/json

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


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

## Daftar tugas

Respon berisi data dan paginasi. Pass pagination.nextCursor sebagai permintaan berikutnya parameter query kursor sampai null. Gunakan batas dari 1 ke 50; baku adalah 20.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| cursor | query | Opsional · {"type":"string","maxLength":512} |
| limit | query | Opsional · {"type":"integer","minimum":1,"maximum":50,"default":20} |

### Endpoint

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

### Python

Simpan list_bulk_jobs.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python list_bulk_jobs.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-BulkJobPage)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Respon

| Status HTTP | Artinya |
| --- | --- |
| 200 | Bulk halaman tugas |
| 401 | Otentikasi diperlukan atau tak valid |

#### 200 · application/json

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


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

## Jeda pekerjaan

Jeda pengiriman baru dan hasil kemasan. Pekerjaan yang ada terus dengan pengaturan asli mereka dan biaya. Lanjutkan pekerjaan ketika siap.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| bulkId | path | Wajib · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

Simpan pause_bulk_job.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python pause_bulk_job.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Respon

| Status HTTP | Artinya |
| --- | --- |
| 200 | Ditunda lama tugas atau keadaan idempoten saat ini |
| 401 | Otentikasi diperlukan atau tak valid |
| 404 | Sumber daya tidak ditemukan atau tidak dimiliki oleh penelepon |

#### 200 · application/json

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


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

## Mutakhirkan opsi pekerjaan

Perbarui opsi ketika menunggu upload, atau saat jeda sebelum semua masukan telah dibaca. Pekerjaan yang ada menjaga pengaturan mereka. Jika jeda masih dalam proses, tunggu dan coba lagi respon 409. Setelah semua masukan dibaca, hanya kredensial pengiriman yang dapat diperbarui. Set callback_url ke null untuk menghapusnya.

Contoh ini menghapus callback penyelesaian. Untuk mengubah opsi sumber, kirim objek options. Jeda pemrosesan terlebih dahulu dan tunggu hingga jeda berlaku; 409 berarti pembaruan belum dapat diterapkan. Tugas turunan yang sudah ada tetap menggunakan opsi awalnya.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| bulkId | path | Wajib · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

Simpan update_bulk_job.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python update_bulk_job.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-UpdateBulkJobRequest)
- [BulkJobResponse](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Menanggapi dan meminta skema

| Status HTTP | Artinya |
| --- | --- |
| 200 | Diperbarui keadaan tugas massal |
| 401 | Otentikasi diperlukan atau tak valid |
| 404 | Sumber daya tidak ditemukan atau tidak dimiliki oleh penelepon |
| 409 | Kondisi sumber daya atau konflik idempotency |
| 422 | Permintaan validasi gagal |

#### Isi permintaan

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

#### 200 · application/json

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


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

## Lanjutkan pekerjaan

Perbaiki pauseReason pertama, seperti menambahkan kredit atau memperbarui mandat penyimpanan, kemudian melanjutkan Bulk ID yang sama.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| bulkId | path | Wajib · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

Simpan resume_bulk_job.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python resume_bulk_job.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Respon

| Status HTTP | Artinya |
| --- | --- |
| 200 | Kondisi tugas besar saat ini |
| 401 | Otentikasi diperlukan atau tak valid |
| 404 | Sumber daya tidak ditemukan atau tidak dimiliki oleh penelepon |

#### 200 · application/json

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


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

## Batalkan tugas

Hentikan pengiriman baru. Pekerjaan yang ada masih bisa finish dan dikenakan biaya normal mereka. Pekerjaan yang dibatalkan tidak menerbitkan daftar akhir.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| bulkId | path | Wajib · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

Simpan cancel_bulk_job.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python cancel_bulk_job.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Respon

| Status HTTP | Artinya |
| --- | --- |
| 200 | Kondisi tugas besar saat ini |
| 401 | Otentikasi diperlukan atau tak valid |
| 404 | Sumber daya tidak ditemukan atau tidak dimiliki oleh penelepon |

#### 200 · application/json

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


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

## Dapatkan daftar muatan hasil

Ikuti redirek untuk mengunduh manifest JSON dan gunakan link-nya untuk mengambil berkas hasil. Ambil penyimpanan yang ditandatangani URLs tanpa kunci API Anda. Hasil tetap tersedia untuk 24 jam setelah seluruh Bulk menyelesaikan pekerjaan.

Permintaan terotentikasi API mengembalikan 302 dengan header Lokasi. Ambil yang HTTPS penyimpanan URL dalam permintaan terpisah tanpa X-API-Key. Contoh menyelamatkan manifest.json. Sebuah 409 berarti hasil tidak siap; 410 berarti mereka berakhir.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| bulkId | path | Wajib · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |

### Endpoint

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

### Python

Simpan bulk_manifest.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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))
```

#### Lari dari bulki-api /

```bash
python bulk_manifest.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Respon

| Status HTTP | Artinya |
| --- | --- |
| 200 | JSON manifest diunduh setelah mengikuti redirect |
| 302 | Mengarahkan ke R2 URL yang tinggal; API kredensial tidak boleh diteruskan · Location |
| 401 | Otentikasi diperlukan atau tak valid |
| 404 | Sumber daya tidak ditemukan atau tidak dimiliki oleh penelepon |
| 409 | Kondisi sumber daya atau konflik idempotency |
| 410 | Hasil yang ditahan telah berakhir |

#### 200 · application/json

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


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

## Unduh bagian hasil

Gunakan setiap parts[].number dari manifest.json. Setiap titik akhir kembali 302 ke gzip NDJSON berkas; unduh tanpa API kunci, dekompresi, kemudian parse satu JSON objek per baris. Bergabung dengan indeks berbasis zero-. Contoh mengambil semua bagian dan menjaga baik .ndjson.gz dan .ndjson file.

| Parameter | Lokasi | Kebutuhan |
| --- | --- | --- |
| bulkId | path | Wajib · {"type":"string","pattern":"^bulk_[A-Za-z0-9_-]{8,}$"} |
| partNumber | path | Wajib · {"type":"integer","minimum":0} |

### Endpoint

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

### Python

Simpan bulk_parts.py di bulk-api / di samping bulk-created.json. Salin skrip lengkap, kemudian jalankan perintah di bawahnya.

#### 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)))
```

#### Lari dari bulki-api /

```bash
python bulk_parts.py
```


### cURL / Bash

#### Lari dari bulki-api /

```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/id/docs/reference/bulk-processing/reference.md#schema-Problem)

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

### Respon

| Status HTTP | Artinya |
| --- | --- |
| 200 | NDJSON terkompresi Gzip- diunduh setelah mengikuti redirect |
| 302 | Mengarahkan ke R2 URL yang tinggal; API kredensial tidak boleh diteruskan · Location |
| 401 | Otentikasi diperlukan atau tak valid |
| 404 | Sumber daya tidak ditemukan atau tidak dimiliki oleh penelepon |
| 409 | Kondisi sumber daya atau konflik idempotency |
| 410 | Hasil yang ditahan telah berakhir |

#### 200 · application/x-ndjson

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


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

## Pekerjaan negara bagian dan penahanan

Hasil tetap tersedia untuk 24 jam setelah seluruh Bulk menyelesaikan pekerjaan. Selamatkan mereka sebelum expiresAt. Media di tujuanmu mengikuti kebijakan penyimpanan embermu. Pekerjaan selesai dapat menyertakan video gagal; catatan counts.invalid ditolak baris masukan.

| Keadaan | Aksi berikutnya |
| --- | --- |
| awaiting_upload | Unggah berkas dan panggil start. |
| running | Poll ID yang sama dengan backoff; input.complete menunjukkan apakah pemindaian selesai. |
| paused | Baca pauseReason, perbaiki, kemudian lanjutkan. |
| finalizing | Tunggu hasil pengepakan dan publikasi yang nyata. |
| completed | Unduh manifest dan setiap bagian. Inspeksi status dan kesalahan setiap baris. |
| failed / cancelled | Galat pemeriksaan dan keadaan yang disimpan. Tidak ada manifes akhir diterbitkan. |

- [Kesalahan dan kode status](https://flashdata.dev/id/docs/errors/reference.md)
- [Pulihkan pekerjaan Bulk yang telah diistirahatkan](https://flashdata.dev/id/docs/guides/bulk/reference.md#controls)

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

## Pengiriman penyimpanan

Gunakan tempat bermain untuk menata penyedia dan pratinjau ruas permintaan yang tepat. Kredensial penyimpanan pelanggan milik dalam objek penyimpanan yang dipilih; X-API-Key hanya otentikasi FlashData API permintaan.

| Sumber | Buat ruas permintaan | Pengiriman |
| --- | --- | --- |
| Metadata, transkrip, captions, pemeriksaan lisensi | options.result_storage | Opsional. Salinan bagian hasil NDJSON dan manifest ke ember Anda. |
| youtube_download | options.storage | Perlu. Mengirim media ke ember Anda; result_storage dan browser_delivery tidak diterima. |

- [Ruas kredensial penyedia](https://flashdata.dev/id/docs/sources/youtube_download/reference.md#storage)
- [Konfigurasikan tujuan penyimpanan](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#playground)

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

### Temukan berkas yang dikirim

Daftar muatan data ditulis terakhir dan daftar kunci objek, ukuran dan SHA-256 checksums. Ini berbeda dari manifest FlashData, yang daftar nilai API. YYYYMMDD dalam jalur data menggunakan tanggal pembuatan UTC Bulk; dalam jalur media ini menggunakan tanggal upload UTC setiap video. Bulk OSS data pengiriman memerlukan sebuah titik akhir aliyuncs.com.

Media pribadi file_url membutuhkan penyimpanan Anda SDK atau URL yang ditandatangani dari penyedia tersebut. Kunci FlashData tidak memberikan akses ember. Berkas pendamping metadata opsional disimpan di samping media. Pengiriman kembali muncul di delivery.retryCount.

#### Tata letak objek data

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


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

## Menerima sebuah webhook pelengkapan

Tempatkan publik HTTPS callback_url pilihan luar. Bulk mengirim hanya selesai setelah menerbitkan daftar muatan; ini tidak mengirim acara video per dan tidak ada acara penyelesaian untuk gagal atau membatalkan tugas. Menjaga status polling sebagai fallback.

1. Persist dan deduplikasi delivery_id, kemudian kembali 2xx segera. Pengiriman ulang hingga delapan kali dengan mundur.
2. Kejadian yang tidak ditandatangani. Cocokkan id dan sumber ke tanda terima tersimpan Anda; verifikasi selesai melalui manajemen terotentikasi API sebelum antrian pengambilan. Abaikan URLs dari sebuah kejadian yang belum diverifikasi.

### Buat permintaan dengan callback

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

### Acara penyelesaian

```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"
    }
  ]
}
```

- [Hasilkan penerima node webhook](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#playground)

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

## Definisi skema

- [BulkJobCreated](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-BulkJobCreated)
- [BulkJob](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-BulkJob)
- [BulkJobPage](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-BulkJobPage)
- [BulkJobResponse](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-BulkJobResponse)
- [CreateBulkJobRequest](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-CreateBulkJobRequest)
- [JobLink](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-JobLink)
- [Pagination](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Pagination)
- [Problem](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-Problem)
- [FieldError](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#schema-FieldError)
- [UpdateBulkJobRequest](https://flashdata.dev/id/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/id/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/id/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/id/docs/reference/bulk-processing/reference.md#schema-BulkJob)
- [Pagination](https://flashdata.dev/id/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/id/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/id/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."
    }
  }
}
```

