Skip to main content
POST
/
v1
/
integrations
/
{integrationId}
/
tools
/
{toolId}
/
execute
Execute Tool
curl --request POST \
  --url https://api.sigmamind.ai/v1/integrations/{integrationId}/tools/{toolId}/execute \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "placeholders": {
    "customerId": "7654321"
  },
  "authId": "auth-P3kNz7Yv1Qm9"
}
'
{
  "toolId": "tool-X9pLm2Wq8Rt3",
  "integrationId": "intg-AuUKK371Spr5",
  "url": "https://my-store.myshopify.com/admin/api/2024-01/customers/7654321.json",
  "method": "GET",
  "statusCode": 200,
  "success": true,
  "responseBody": {
    "customer_name": "Michael"
  },
  "responseHeaders": {
    "Content-Type": "application/json; charset=utf-8"
  },
  "errorMessage": "404 Not Found: {\"errors\": \"Customer not found\"}",
  "durationMs": 342,
  "executedAt": "2024-04-20T10:00:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sigmamind.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

API Key is required in header. You can find it in the settings

Path Parameters

​
integrationId
string
required

Unique identifier for the integration

​
toolId
string
required

Unique identifier for the tool to execute

Body

application/json

Request body to execute a tool against its configured third-party API. Supply values for every {{variable}} placeholder declared in the tool's endpoint, queryParams, and bodyParams. The tool's stored auth credentials are resolved automatically — you do not need to pass credentials here.

​
placeholders
object

A map of placeholder names to values used to resolve {{placeholder}} tokens in the tool's endpoint URL, query parameters, and request body at runtime. Each placeholder used in the request must have a corresponding entry in this map. Example: for endpoint '/customers/{{customerId}}.json', provide {"customerId": "7654321"}.

Example:
{ "customerId": "7654321" }
​
authId
string

The authId of the credential set to use for this execution.

Maximum string length: 64
Example:

"auth-P3kNz7Yv1Qm9"

Response

OK

Result of executing a tool against its configured third-party API.

​
toolId
string

Unique identifier of the tool that was executed.

Example:

"tool-X9pLm2Wq8Rt3"

​
integrationId
string

Unique identifier of the integration this tool belongs to.

Example:

"intg-AuUKK371Spr5"

​
url
string

The fully resolved URL that was called, with all {{variable}} placeholders substituted.

Example:

"https://my-store.myshopify.com/admin/api/2024-01/customers/7654321.json"

​
method
string

The HTTP method used for the request.

Example:

"GET"

​
statusCode
integer<int32>

HTTP status code returned by the third-party API.

Example:

200

​
success
boolean

Whether the third-party API returned a 2xx success response.

Example:

true

​
responseBody
object

A set of dynamic key-value pairs required by the selected Agent. These variables allow personalization of the call, such as passing the customer’s name or other contextual details.

Example:
{ "customer_name": "Michael" }
​
responseHeaders
object

Response headers returned by the third-party API.

Example:
{
  "Content-Type": "application/json; charset=utf-8"
}
​
errorMessage
string

Error message when success is false — contains the raw error body or exception message.

Example:

"404 Not Found: {\"errors\": \"Customer not found\"}"

​
durationMs
integer<int64>

How long the third-party API took to respond, in milliseconds.

Example:

342

​
executedAt
string<date-time>

Timestamp when the execution was triggered.

Example:

"2024-04-20T10:00:00.000Z"