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

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/ai-agents/v1/agents

Retrieve a list of all agents

Required scopes

This endpoint requires the following scopes:

Authorizations

token

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

HTTPcURLJavaScriptPython

GET /api/v2/ai-agents/v1/agents?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
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

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/ai-agents/v1/agents

Create a new agent

Required scopes

This endpoint requires the following scopes:

Authorizations

token

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

application/json

Request body for creating a new agent.

namestringRequired

teamIdnumberRequired

makeConnectionIdnumberRequired

defaultModelstringRequired

systemPromptstring · min: 1Required

outputParserFormatone ofOptional

or

Responses

201

Agent created successfully

application/json

post

/ai-agents/v1/agents

HTTPcURLJavaScriptPython

POST /api/v2/ai-agents/v1/agents?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
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

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

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

Retrieve an agent by its ID

Required scopes

This endpoint requires the following scopes:

Authorizations

token

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}

HTTPcURLJavaScriptPython

GET /api/v2/ai-agents/v1/agents/{agentId}?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
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

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

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

Delete an agent by its ID

Required scopes

This endpoint requires the following scopes:

Authorizations

token

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

204

Agent deleted successfully

delete

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

HTTPcURLJavaScriptPython

DELETE /api/v2/ai-agents/v1/agents/{agentId}?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

204

Agent deleted successfully

No content

Modify Agent by ID

patch

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

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

Modify an existing agent by its ID

Required scopes

This endpoint requires the following scopes:

Authorizations

token

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

application/json

Request body for modifying an existing agent.

namestringOptional

systemPromptstring · min: 1Optional

defaultModelstringOptional

outputParserFormatone ofOptional

or

Responses

204

Agent modified successfully

patch

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

HTTPcURLJavaScriptPython

PATCH /api/v2/ai-agents/v1/agents/{agentId}?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
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

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

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

Run an agent with the provided ID

Required scopes

This endpoint requires the following scopes:

Authorizations

token

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

application/json

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

HTTPcURLJavaScriptPython

POST /api/v2/ai-agents/v1/agents/{agentId}/run?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
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

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/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

token

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

application/json

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

HTTPcURLJavaScriptPython

POST /api/v2/ai-agents/v1/agents/{agentId}/run/stream?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
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"}