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

Retrieve a list of all agents

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
Responses
200

List of agents retrieved successfully

application/json
get
/ai-agents/v1/agents
GET /api/v2/ai-agents/v1/agents?teamId=1 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
/ai-agents/v1/agents

Create a new 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
teamIdnumberRequired
Body

Request body for creating a new agent.

namestringRequired
teamIdnumberRequired
makeConnectionIdnumberRequired
defaultModelstringRequired
systemPromptstring · min: 1Required
outputParserFormatone ofOptional
or
Responses
post
/ai-agents/v1/agents
POST /api/v2/ai-agents/v1/agents?teamId=1 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
/ai-agents/v1/agents/{agentId}

Retrieve an agent 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
agentIdstring · uuidRequired
Query parameters
teamIdnumberRequired
Responses
200

Agent retrieved successfully

application/json
get
/ai-agents/v1/agents/{agentId}
GET /api/v2/ai-agents/v1/agents/{agentId}?teamId=1 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
    }
  ],
  "outputParser": {
    "type": "make-schema",
    "schema": [
      {
        "name": "field1",
        "type": "string",
        "label": "Field 1",
        "required": true
      },
      {
        "name": "field2",
        "type": "integer",
        "label": "Field 2",
        "required": false
      }
    ]
  }
}

Delete Agent by ID

delete
/ai-agents/v1/agents/{agentId}

Delete an agent 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
agentIdstring · uuidRequired
Query parameters
teamIdnumberRequired
Responses
delete
/ai-agents/v1/agents/{agentId}
DELETE /api/v2/ai-agents/v1/agents/{agentId}?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
204

Agent deleted successfully

No content

Modify Agent by ID

patch
/ai-agents/v1/agents/{agentId}

Modify an existing agent 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
agentIdstring · uuidRequired
Query parameters
teamIdnumberRequired
Body

Request body for modifying an existing agent.

namestringOptional
systemPromptstring · min: 1Optional
defaultModelstringOptional
outputParserFormatone ofOptional
or
Responses
patch
/ai-agents/v1/agents/{agentId}
PATCH /api/v2/ai-agents/v1/agents/{agentId}?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 495

{
  "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
  },
  "outputParserFormat": {
    "type": "make-schema",
    "schema": [
      {
        "name": "field1",
        "type": "string",
        "label": "Field 1",
        "required": true
      },
      {
        "name": "field2",
        "type": "integer",
        "label": "Field 2",
        "required": false
      }
    ]
  }
}
204

Agent modified successfully

No content

Run Agent

post
/ai-agents/v1/agents/{agentId}/run

Run an agent with the provided 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
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
/ai-agents/v1/agents/{agentId}/run
POST /api/v2/ai-agents/v1/agents/{agentId}/run?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 495

{
  "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
    },
    "outputParser": {
      "type": "text"
    }
  }
}
200

Agent run started successfully

{
  "response": "{\"name\":\"Liz Carlson\",\"time\":14,\"countriesVisited\":[{\"countryName\":\"Spain\",\"population\":47450795},{\"countryName\":\"New Zealand\",\"population\":5185280},{\"countryName\":\"United States\",\"population\":331893745}],\"currentStay\":\"New Zealand\"}",
  "jsonResponse": {
    "name": "Liz Carlson",
    "time": 14,
    "countriesVisited": [
      {
        "countryName": "Spain",
        "population": 47450795
      },
      {
        "countryName": "New Zealand",
        "population": 5185280
      },
      {
        "countryName": "United States",
        "population": 331893745
      }
    ],
    "currentStay": "New Zealand"
  },
  "executionSteps": [
    {
      "id": "4f7aa955-f0e9-499b-85de-0b3bf160c565",
      "index": 1,
      "role": "user",
      "content": "get me sample json data",
      "agentIterationId": "af7aa955-f0e9-499b-85de-0b3bf160c565"
    },
    {
      "id": "4f7aa955-f0e9-499b-85de-0b3bf160c566",
      "index": 2,
      "role": "assistant",
      "content": "{\"name\":\"Liz Carlson\",\"time\":14,\"countriesVisited\":[{\"countryName\":\"Spain\",\"population\":47450795},{\"countryName\":\"New Zealand\",\"population\":5185280},{\"countryName\":\"United States\",\"population\":331893745}],\"currentStay\":\"New Zealand\"}",
      "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
/ai-agents/v1/agents/{agentId}/run/stream

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

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
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
/ai-agents/v1/agents/{agentId}/run/stream
POST /api/v2/ai-agents/v1/agents/{agentId}/run/stream?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 495

{
  "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
    },
    "outputParser": {
      "type": "text"
    }
  }
}
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

Last updated