AI Agents > Context

The following endpoints allow you to get, create, and delete Context for AI Agents. These endpoints are available in open beta to all users. As beta endpoints, both functionality and availability may change.

List Context

get

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/ai-agents/v1/contexts

Retrieve a list of all context for an agent

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Query parameters

agentIdstring · uuidRequired

teamIdnumberRequired

Responses

200

List of context retrieved successfully

get

/ai-agents/v1/contexts

HTTPcURLJavaScriptPython

GET /api/v2/ai-agents/v1/contexts?agentId=123e4567-e89b-12d3-a456-426614174000&teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

List of context retrieved successfully

No content

Create Context

post

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/ai-agents/v1/contexts

Create a new context with an optional file upload

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Query parameters

teamIdnumberRequired

Body

multipart/form-dataapplication/json

Schema for uploading a file.

agentIdstring · uuidRequired

fileany | nullableOptional

Responses

201

Context created successfully

post

/ai-agents/v1/contexts

HTTPcURLJavaScriptPython

POST /api/v2/ai-agents/v1/contexts?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: multipart/form-data
Accept: */*
Content-Length: 161

{
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "file": {
    "fieldname": "file",
    "originalname": "example.txt",
    "encoding": "7bit",
    "mimetype": "text/plain",
    "size": 1024
  }
}

multipart/form-dataapplication/json

201

Context created successfully

No content

Delete Context

delete

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/ai-agents/v1/contexts/{contextId}

Delete a context by its ID

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters

contextIdstring · uuidRequired

Query parameters

teamIdnumberRequired

Responses

204

Context deleted successfully

delete

/ai-agents/v1/contexts/{contextId}

HTTPcURLJavaScriptPython

DELETE /api/v2/ai-agents/v1/contexts/{contextId}?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

204

Context deleted successfully

No content