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
/ai-agents/v1/contexts

Retrieve a list of all context for an agent

Required scopes
This endpoint requires the following scopes:
Authorizations
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
GET /api/v2/ai-agents/v1/contexts?agentId=123e4567-e89b-12d3-a456-426614174000&teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

List of context retrieved successfully

No content

Create Context

post
/ai-agents/v1/contexts

Create a new context with an optional file upload

Required scopes
This endpoint requires the following scopes:
Authorizations
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

Schema for uploading a file.

agentIdstring · uuidRequired
fileany | nullableOptional
Responses
post
/ai-agents/v1/contexts
POST /api/v2/ai-agents/v1/contexts?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
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
  }
}
201

Context created successfully

No content

Delete Context

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

Delete a context by its ID

Required scopes
This endpoint requires the following scopes:
Authorizations
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
delete
/ai-agents/v1/contexts/{contextId}
DELETE /api/v2/ai-agents/v1/contexts/{contextId}?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
204

Context deleted successfully

No content

Last updated