The tasks object in the MarkupGo API represents the result of an API activity triggered by generating documents or images. Tasks are created after calling the /pdf or /image endpoints.
You can also see the list in activity tab in the dashboard.
| Key | Description | Default |
|---|---|---|
limit | The number of tasks to return. | 10 |
page | The page number to return. | 1 |
The response contains an array of tasks and a meta object with pagination information.
| Key | Description |
|---|---|
id | The unique identifier of the task. |
url | The URL of the generated document or image. |
format | The format of the generated document or image. |
size | The size of the generated document or image in bytes. |
width | The width of the generated document or image in pixels. |
height | The height of the generated document or image in pixels. |
createdAt | The date and time the task was created. |
updatedAt | The date and time the task was last updated. |
GET /tasks
curl -X GET "api/v1/tasks?limit=10&page=1"
{
"data": [
{
"id": "task_12345",
"url": "https://files.markupgo.com/task_12345.pdf",
"format": "pdf",
"size": 1048576,
"width": 210,
"height": 297,
"createdAt": "2023-06-21T10:00:00Z",
"updatedAt": "2023-06-21T10:05:00Z"
},
],
"meta": {
"total": 2,
"skip": 0,
"limit": 10
}
}