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: 435

{
  "name": "Example Agent",
  "teamId": 1,
  "makeConnectionId": 123,
  "defaultModel": "gpt-3.5-turbo",
  "systemPrompt": "You are a helpful assistant.",
  "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"
    }
  ]
}
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,
      "tools": [
        {
          "id": "fetch_generic_url_content",
          "isDeprecated": false
        },
        {
          "id": "search_generic_code",
          "isDeprecated": false
        }
      ],
      "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