Get support

AI Agents

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

Get Agents

get

Retrieve a list of all agents

Authorizations
Query parameters
teamIdnumberRequired
Responses
200
List of agents retrieved successfully
get
GET /api/v2/ai-agents/v1/agents HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

List of agents retrieved successfully

No content

Create Agent

post

Create a new agent

Authorizations
Query parameters
teamIdnumberRequired
Body

Request body for creating a new agent.

namestringRequired
teamIdnumberRequired
makeConnectionIdnumberRequired
defaultModelstringRequired
systemPromptstring · min: 1Required
Responses
201
Agent created successfully
application/json
post
POST /api/v2/ai-agents/v1/agents HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 135

{
  "name": "Example Agent",
  "teamId": 1,
  "makeConnectionId": 123,
  "defaultModel": "gpt-3.5-turbo",
  "systemPrompt": "You are a helpful assistant."
}
201

Agent created successfully

{
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Example Agent",
  "teamId": 1,
  "makeConnectionId": 123,
  "defaultModel": "gpt-3.5-turbo",
  "systemPrompt": "You are a helpful assistant."
}

Get Agent by ID

get

Retrieve an agent by its ID

Authorizations
Path parameters
agentIdstring · uuidRequired
Query parameters
teamIdnumberRequired
Responses
200
Agent retrieved successfully
get
GET /api/v2/ai-agents/v1/agents/{agentId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Agent retrieved successfully

No content

Delete Agent by ID

delete

Delete an agent by its ID

Authorizations
Path parameters
agentIdstring · uuidRequired
Query parameters
teamIdnumberRequired
Responses
204
Agent deleted successfully
delete
DELETE /api/v2/ai-agents/v1/agents/{agentId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
204

Agent deleted successfully

No content

Modify Agent by ID

patch

Modify an existing agent by its ID

Authorizations
Path parameters
agentIdstring · uuidRequired
Query parameters
teamIdnumberRequired
Body

Request body for modifying an existing agent.

namestringOptional
systemPromptstring · min: 1Optional
defaultModelstringOptional
Responses
204
Agent modified successfully
patch
PATCH /api/v2/ai-agents/v1/agents/{agentId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 302

{
  "name": "Modified Agent",
  "systemPrompt": "You are a modified helpful assistant.",
  "defaultModel": "gpt-4",
  "llmConfig": {
    "maxTokens": 1000
  },
  "invocationConfig": {
    "recursionLimit": 5,
    "timeout": 30000
  },
  "scenarios": [
    {
      "makeScenarioId": 345,
      "approvalMode": "auto-run"
    }
  ],
  "historyConfig": {
    "iterationsFromHistoryCount": 3
  }
}
204

Agent modified successfully

No content

Run Agent

post

Run an agent with the provided ID

Authorizations
Path parameters
agentIdstring · uuidRequired
Query parameters
teamIdnumberRequired
Body

Request body for running an agent.

threadIdstring · min: 1OptionalDefault: a64d23ed-2580-43e4-a898-e97193d7fd5e
callbackUrlstringOptional
Responses
200
Agent run started successfully
application/json
post
POST /api/v2/ai-agents/v1/agents/{agentId}/run HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 464

{
  "messages": [
    {
      "role": "user",
      "content": "What can you do?"
    }
  ],
  "threadId": "123e4567-e89b-12d3-a456-426614174000",
  "config": {
    "systemPrompt": "You are a helpful assistant.",
    "additionalSystemPrompt": "And you should always reply politely.",
    "scenarios": [
      {
        "makeScenarioId": 123,
        "approvalMode": "auto-run"
      }
    ],
    "historyConfig": {
      "iterationsFromHistoryCount": 2
    },
    "llmConfig": {
      "llmModel": "o4-mini",
      "settings": {
        "maxTokens": 1500
      }
    },
    "invocationConfig": {
      "recursionLimit": 3,
      "timeout": 60000
    }
  }
}
200

Agent run started successfully

{
  "response": "I can help you with various tasks.",
  "executionSteps": [
    {
      "id": "4f7aa955-f0e9-499b-85de-0b3bf160c565",
      "index": 1,
      "role": "user",
      "content": "Hi, what can you do?",
      "agentIterationId": "af7aa955-f0e9-499b-85de-0b3bf160c565"
    },
    {
      "id": "4f7aa955-f0e9-499b-85de-0b3bf160c566",
      "index": 2,
      "role": "assistant",
      "content": "I can help you with various tasks.",
      "executionTimeMs": 200,
      "tokenUsage": {
        "promptTokens": 10,
        "completionTokens": 20,
        "totalTokens": 30
      },
      "agentIterationId": "af7aa955-f0e9-499b-85de-0b3bf160c565"
    }
  ],
  "executionTimeMs": 500,
  "threadId": "123e4567-e89b-12d3-a456-426614174000",
  "tokenUsageSummary": {
    "promptTokens": 10,
    "completionTokens": 20,
    "totalTokens": 30
  },
  "lastAgentIterationId": "af7aa955-f0e9-499b-85de-0b3bf160c565"
}
PreviousAgentsNextAI Agents > Context