Tasks

get

Retrieves multiple tasks.

Query parameters

agentIdsany ofOptionalDefault: []

string · uuid[]Optional

A UUID v4 string that identifies an entity.

or

string · uuidOptional

A UUID v4 string that identifies an entity.

pageNumbernumber · min: 1Optional

The page number.

Default: 1

pageSizenumber · min: 1 · max: 100Optional

The page size.

Default: 10

versionIdsany ofOptionalDefault: []

string · uuid[]Optional

A UUID v4 string that identifies an entity.

or

string · uuidOptional

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves all tasks for the workspace.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

agentIdstring · uuidRequired

The agent ID associated with the task.

conditionstring · min: 3 · max: 250Required

The condition that must be met for the task to be executed.

namestring · min: 3 · max: 50Required

The display name of the task.

promptstring · min: 3 · max: 2000Required

What will be set as the main object of the agent when the task is selected.

statusstring · enumRequired

The lifecycle status of the task.

Possible values:

401

Unauthorized.

application/json

get

/api/v1/tasks

HTTPcURLJavaScriptPython

GET /api/v1/tasks HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

[
  {
    "createdAt": "2026-06-11T21:54:03.628Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "isRemoved": true,
    "referenceId": "123e4567-e89b-12d3-a456-426614174000",
    "updatedAt": "2026-06-11T21:54:03.628Z",
    "versionId": "123e4567-e89b-12d3-a456-426614174000",
    "agentId": "123e4567-e89b-12d3-a456-426614174000",
    "condition": "text",
    "name": "text",
    "prompt": "text",
    "status": "active"
  }
]

post

Creates a new task.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

application/json

agentIdstring · uuidRequired

The agent ID associated with the task.

conditionstring · min: 3 · max: 250Required

The condition that must be met for the task to be executed.

namestring · min: 3 · max: 50Required

The display name of the task.

promptstring · min: 3 · max: 2000Required

What will be set as the main object of the agent when the task is selected.

statusstring · enumRequired

The lifecycle status of the task.

Possible values:

Responses

200

The task was created.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

agentIdstring · uuidRequired

The agent ID associated with the task.

conditionstring · min: 3 · max: 250Required

The condition that must be met for the task to be executed.

namestring · min: 3 · max: 50Required

The display name of the task.

promptstring · min: 3 · max: 2000Required

What will be set as the main object of the agent when the task is selected.

statusstring · enumRequired

The lifecycle status of the task.

Possible values:

401

Unauthorized.

application/json

404

Agent not found.

application/json

post

/api/v1/tasks

HTTPcURLJavaScriptPython

POST /api/v1/tasks HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "condition": "text",
  "name": "text",
  "prompt": "text",
  "status": "active"
}

{
  "createdAt": "2026-06-11T21:54:03.628Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-06-11T21:54:03.628Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "condition": "text",
  "name": "text",
  "prompt": "text",
  "status": "active"
}

get

Retrieves a task.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves a task.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

agentIdstring · uuidRequired

The agent ID associated with the task.

conditionstring · min: 3 · max: 250Required

The condition that must be met for the task to be executed.

namestring · min: 3 · max: 50Required

The display name of the task.

promptstring · min: 3 · max: 2000Required

What will be set as the main object of the agent when the task is selected.

statusstring · enumRequired

The lifecycle status of the task.

Possible values:

401

Unauthorized.

application/json

404

Task not found.

application/json

get

/api/v1/tasks/{id}

HTTPcURLJavaScriptPython

GET /api/v1/tasks/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "createdAt": "2026-06-11T21:54:03.628Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-06-11T21:54:03.628Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "condition": "text",
  "name": "text",
  "prompt": "text",
  "status": "active"
}

delete

Removes a task.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

The task was removed.

application/json

messagestringRequired

An informative message for a call that has no effective result to be returned.

401

Unauthorized.

application/json

404

Task not found.

application/json

delete

/api/v1/tasks/{id}

HTTPcURLJavaScriptPython

DELETE /api/v1/tasks/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "message": "text"
}

patch

Updates a task.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

application/json

conditionstring · min: 3 · max: 250Optional

The condition that must be met for the task to be executed.

namestring · min: 3 · max: 50Optional

The display name of the task.

promptstring · min: 3 · max: 2000Optional

What will be set as the main object of the agent when the task is selected.

statusstring · enumOptional

The lifecycle status of the task.

Possible values:

Responses

200

The task was updated.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

agentIdstring · uuidRequired

The agent ID associated with the task.

conditionstring · min: 3 · max: 250Required

The condition that must be met for the task to be executed.

namestring · min: 3 · max: 50Required

The display name of the task.

promptstring · min: 3 · max: 2000Required

What will be set as the main object of the agent when the task is selected.

statusstring · enumRequired

The lifecycle status of the task.

Possible values:

401

Unauthorized.

application/json

404

Task not found.

application/json

patch

/api/v1/tasks/{id}

HTTPcURLJavaScriptPython

PATCH /api/v1/tasks/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "condition": "text",
  "name": "text",
  "prompt": "text",
  "status": "active"
}

{
  "createdAt": "2026-06-11T21:54:03.628Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-06-11T21:54:03.628Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "condition": "text",
  "name": "text",
  "prompt": "text",
  "status": "active"
}