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
application/json
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

{
  "id": "b504aa93-0752-4bf8-887e-c2c717d525bf",
  "name": "myagent",
  "teamId": 2,
  "createdAt": "2025-06-25T13:36:46.730Z",
  "systemPrompt": "you are the greatest bot ever",
  "defaultModel": "gemini-2.5-flash",
  "invocationConfig": {
    "recursionLimit": 300
  },
  "scenarios": [
    {
      "makeScenarioId": 123,
      "approvalMode": "auto-run"
    }
  ],
  "mcpConfigs": [
    {
      "mcpConnectionId": 456,
      "toolIds": [
        "tool1",
        "tool2"
      ],
      "name": "Example MCP Config"
    }
  ],
  "historyConfig": {
    "iterationsFromHistoryCount": 10
  },
  "llmConfig": {
    "maxTokens": 100000
  },
  "contexts": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "agentId": "1b504aa93-0752-4bf8-887e-c2c717d525bf0",
      "documentName": "Example Document",
      "description": "This is an example context for the agent.",
      "createdAt": "2025-06-26T06:53:15.407Z",
      "metadata": {
        "type": "csv"
      },
      "isTemporary": false
    }
  ]
}

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
application/json
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

{
  "id": "b504aa93-0752-4bf8-887e-c2c717d525bf",
  "name": "myagent",
  "teamId": 2,
  "createdAt": "2025-06-25T13:36:46.730Z",
  "systemPrompt": "you are the greatest bot ever",
  "defaultModel": "gemini-2.5-flash",
  "invocationConfig": {
    "recursionLimit": 300
  },
  "makeConnectionId": 18,
  "makeConnectionType": "openai-gpt-3",
  "pastConfigurations": [
    {
      "name": "myagent",
      "llmConfig": {
        "maxTokens": 100000
      },
      "scenarios": [],
      "mcpConfigs": [
        {
          "toolIds": [
            "s1_list_inventory"
          ],
          "mcpConnectionId": 19
        }
      ],
      "defaultModel": "gemini-2.5-flash",
      "systemPrompt": "you are the greatest bot ever",
      "historyConfig": {
        "iterationsFromHistoryCount": 10
      },
      "invocationConfig": {
        "recursionLimit": 300
      }
    }
  ],
  "scenarios": [
    {
      "makeScenarioId": 123,
      "approvalMode": "auto-run"
    }
  ],
  "mcpConfigs": [
    {
      "mcpConnectionId": 19,
      "toolIds": [
        "s1_list_inventory"
      ],
      "name": "mymcpconnection"
    },
    {
      "mcpConnectionId": 14,
      "toolIds": [
        "fetch_generic_url_content",
        "search_generic_code"
      ],
      "name": "GitMCP"
    }
  ],
  "historyConfig": {
    "iterationsFromHistoryCount": 10
  },
  "llmConfig": {
    "maxTokens": 100000
  },
  "llmProviderId": 9,
  "contexts": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "agentId": "1b504aa93-0752-4bf8-887e-c2c717d525bf0",
      "documentName": "Example Document",
      "description": "This is an example context for the agent.",
      "createdAt": "2025-06-26T06:53:15.407Z",
      "metadata": {
        "type": "csv"
      },
      "isTemporary": false
    }
  ]
}

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"
}

Run Agent with Server Sent Events (SSE) Streaming

post

Run an agent with the provided ID and stream the response using Server Sent Events (SSE)

Authorizations
Path parameters
agentIdstring · uuidRequired
Query parameters
teamIdnumberRequired
Body

Request body for running an agent.

threadIdstring · min: 1OptionalDefault: d7fbd183-6b53-4dba-9469-00ec3d047cef
callbackUrlstringOptional
Responses
200
Agent run with streaming started successfully
text/event-stream
Responseany | nullable

Server-Sent Events stream (text/event-stream)

Example: event:step id:4ebb9c59-ab75-41d5-8146-7407ce71f484 data:{"role":"system","content":"do what user says\nCurrent time (ISO): 2025-06-26T01:42:30.080-06:00","id":"445431dd-c20e-4a58-a043-ca9c131d4010","agentIterationId":"a132ced5-4afd-4444-ac9d-330cc99c4986"}
post
POST /api/v2/ai-agents/v1/agents/{agentId}/run/stream 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 with streaming started successfully

event:step
id:4ebb9c59-ab75-41d5-8146-7407ce71f484
data:{"role":"system","content":"do what user says\nCurrent time (ISO): 2025-06-26T01:42:30.080-06:00","id":"445431dd-c20e-4a58-a043-ca9c131d4010","agentIterationId":"a132ced5-4afd-4444-ac9d-330cc99c4986"}
PreviousAgentsNextAI Agents > Context