GetJob

Gets information on a job (e.g. a batch file deletion).

1curl https://api.upload.io/v2/accounts/{accountId}/jobs/{jobType}/{jobId} \
2     -H "Authorization: Bearer YOUR_API_KEY"

1{
2  "accountId": "YOUR_ACCOUNT_ID",
3  "attempts": 2,
4  "created": 1615680311115,
5  "error": {
6    "code": "error_code",
7    "message": "Error message."
8  },
9  "jobId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
10  "jobType": "BatchFileDeletionJob",
11  "lastUpdated": 1615680311115,
12  "payload": {
13    "deletions": [
14      "/file/to/delete.jpg"
15    ]
16  },
17  "status": "Cancelled"
18}

Response Body

See full details

URL Parameters

accountId

Your account ID.

This is visible on the settings page:

https://upload.io/dashboard/settings

Type: String

Length: 7

Example: A623uY2

In: Path

Required: Yes

jobId

Job ID.

Type: String

Length: 26

Example: 01ARZ3NDEKTSV4RRFFQ69G5FAV

In: Path

Required: Yes

jobType

The type of the job.

Type: String

Allowed Values: "BatchFileDeletionJob", "BatchFolderDeletionJob"

In: Path

Required: Yes

Request Headers

Authorization

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:

Documentation

Data Types

More Resources

GetJob

Response Body

URL Parameters

accountId

jobId

jobType

Request Headers

Authorization

You are using an outdated browser.