Data Types


Lists the most recently issued jobs (e.g. batch file deletions, folder deletions, etc.).

GET /v2/accounts/{accountId}/jobs
1curl{accountId}/jobs?jobType=BatchFileDeletionJob \
2 -H "Authorization: Bearer YOUR_API_KEY"
Response (200)
2 "items": [
3 {
4 "accountId": "YOUR_ACCOUNT_ID",
5 "attempts": 2,
6 "created": 1615680311115,
7 "error": {
8 "code": "error_code",
9 "message": "Error message."
10 },
11 "jobId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
12 "jobType": "BatchFileDeletionJob",
13 "lastUpdated": 1615680311115,
14 "payload": {
15 "deletions": [
16 "/file/to/delete.jpg"
17 ]
18 },
19 "status": "Cancelled"
20 }
21 ]

Response Body

URL Parameters


Your account ID.

This is visible on the settings page:

Type: String

Length: 7

Example: A623uY2

In: Path

Required: Yes


The type of the job.

This parameter can be set multiple times.

Type: String

Allowed Values: BatchFileDeletionJob, BatchFolderDeletionJob

In: Querystring

Required: Yes

Request Headers


Add one of these Authorization header values to your request:

Option 1: prefix "Bearer " to your API key. The result is your Authorization header value.

Option 2: use HTTP basic authorization, specifying apikey as your username, and your API key as your password.

Note: this endpoint requires a secret_* API key.

Type: String

In: Header

Required: Yes

Was this section helpful? Yes No

You are using an outdated browser.

This website requires a modern web browser -- the latest versions of these browsers are supported: