Datagrid Columns

get

Retrieves multiple datagrid columns.

Query parameters

datagridIdstring · 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 all datagrid columns for the specified datagrid.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

updatedAtstring · date-timeRequired

datagridIdstring · uuidRequired

The datagrid ID associated with the column.

descriptionstring · min: 3 · max: 250Required

The description of the column. Will be used by the agent to understand how to interact with it.

detailany ofRequired

or

or

namestring · min: 3 · max: 50Required

The display name of the datagrid column.

401

Unauthorized.

application/json

404

Datagrid not found.

application/json

get

/api/v1/datagrid-columns

HTTPcURLJavaScriptPython

GET /api/v1/datagrid-columns?datagridId=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

[
  {
    "createdAt": "2026-06-11T20:41:13.866Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "updatedAt": "2026-06-11T20:41:13.866Z",
    "datagridId": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "detail": {
      "semanticSearch": true,
      "type": "string"
    },
    "name": "text"
  }
]

post

Creates a new datagrid column.

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

datagridIdstring · uuidRequired

The datagrid ID associated with the column.

descriptionstring · min: 3 · max: 250Required

The description of the column. Will be used by the agent to understand how to interact with it.

detailany ofRequired

or

or

namestring · min: 3 · max: 50Required

The display name of the datagrid column.

Responses

200

The datagrid column was created.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

updatedAtstring · date-timeRequired

datagridIdstring · uuidRequired

The datagrid ID associated with the column.

descriptionstring · min: 3 · max: 250Required

The description of the column. Will be used by the agent to understand how to interact with it.

detailany ofRequired

or

or

namestring · min: 3 · max: 50Required

The display name of the datagrid column.

400

Invalid datagrid column configuration.

application/json

401

Unauthorized.

application/json

404

Datagrid not found.

application/json

412

Precondition failed.

application/json

post

/api/v1/datagrid-columns

HTTPcURLJavaScriptPython

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

{
  "datagridId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "detail": {
    "semanticSearch": true,
    "type": "string"
  },
  "name": "text"
}

{
  "createdAt": "2026-06-11T20:41:13.866Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-06-11T20:41:13.866Z",
  "datagridId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "detail": {
    "semanticSearch": true,
    "type": "string"
  },
  "name": "text"
}

delete

Removes a datagrid column.

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 datagrid column was removed along with all associated values.

application/json

messagestringRequired

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

401

Unauthorized.

application/json

404

Datagrid column not found.

application/json

delete

/api/v1/datagrid-columns/{id}

HTTPcURLJavaScriptPython

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

{
  "message": "text"
}

patch

Updates a datagrid column.

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

descriptionstring · min: 3 · max: 250Optional

The description of the column. Will be used by the agent to understand how to interact with it.

detailany ofOptional

or

or

namestring · min: 3 · max: 50Optional

The display name of the datagrid column.

Responses

200

The datagrid column was updated.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

updatedAtstring · date-timeRequired

datagridIdstring · uuidRequired

The datagrid ID associated with the column.

descriptionstring · min: 3 · max: 250Required

The description of the column. Will be used by the agent to understand how to interact with it.

detailany ofRequired

or

or

namestring · min: 3 · max: 50Required

The display name of the datagrid column.

400

Invalid request - data type cannot be changed.

application/json

401

Unauthorized.

application/json

404

The datagrid column was not found.

application/json

412

Precondition failed.

application/json

patch

/api/v1/datagrid-columns/{id}

HTTPcURLJavaScriptPython

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

{
  "description": "text",
  "detail": {
    "semanticSearch": true,
    "type": "string"
  },
  "name": "text"
}

{
  "createdAt": "2026-06-11T20:41:13.866Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-06-11T20:41:13.866Z",
  "datagridId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "detail": {
    "semanticSearch": true,
    "type": "string"
  },
  "name": "text"
}