GET
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.mergent.co/v2/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "4cf95241-fa19-47ef-8a67-71e483747649",
  "name": "4cf95241-fa19-47ef-8a67-71e483747649",
  "queue": "default",
  "status": "queued",
  "request": {
    "url": "https://example.com",
    "headers": {
      "Authorization": "8BOHec9yUJMJ4sJFqUuC5w==",
      "Content-Type": "application/json"
    },
    "body": "Hello, world!"
  },
  "scheduled_for": "2021-10-01T15:53:05Z",
  "created_at": "2021-10-01T15:53:05Z"
}

Authorizations

Authorization
string
headerrequired

The Mergent API uses API keys to authenticate requests. Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Path Parameters

task_id
string
required

The ID of the task.

Response

200 - application/json
id
string
required

The unique ID for the task.

name
string | null

The name of the task.

queue
string
default: defaultrequired

The name of the of the task queue.

status
enum<string>
required

The status of the task. Additional statuses may be added over time.

Available options:
queued,
working,
success,
failure
request
object
required

A task request.

scheduled_for
string | null

The ISO 8601 timestamp for when the task is scheduled to be executed.

created_at
string
required

The ISO 8601 timestamp representing when the task was created.

Was this page helpful?

Batch delete tasksDelete task