Actions

List actions

get

Retrieves actions for the authenticated owner

Authorizations

x-api-key

x-api-keystringRequired

Responses

200

Actions retrieved successfully

application/json

keystringRequired

The key of the action

Example: action-1

intentstringRequired

The intent associated with the action

Example: Summarize latest sales report

outputSchemaobject · json-schemaOptional

JSON Schema draft 7 schema for action output format

inputSchemaobject · json-schemaOptional

JSON Schema draft 7 schema for action input format

useDefaultMappingbooleanRequired

Whether default input/output mapping is used

Example: true

updatedAtstring · date-timeRequired

Action last update timestamp

Example: 2026-04-09T10:15:30.000Z

createdAtstring · date-timeRequired

Action creation timestamp

Example: 2026-04-01T08:00:00.000Z

401

Unauthorized - invalid API key

get

/v1/actions

HTTPcURLJavaScriptPython

GET /v1/actions HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Accept: */*

[
  {
    "key": "action-1",
    "intent": "Summarize latest sales report",
    "outputSchema": {},
    "inputSchema": {},
    "useDefaultMapping": true,
    "updatedAt": "2026-04-09T10:15:30.000Z",
    "createdAt": "2026-04-01T08:00:00.000Z"
  }
]

Run an action

post

Runs an action for the specified action key, customer integration ID and user ID

Authorizations

x-api-key

x-api-keystringRequired

Body

application/json

keystringRequired

The key of the action to run

Example: action-1

userIdstringRequired

The ID of the user who is running the action

Example: user-123

inputobjectOptional

Input parameters for the action. Required if action has input schema defined.

Example: {"name":"John Doe"}

passThroughobject[]Optional

Pass through data for the action run, e.g. credentials for the integrations used in the run

Example: [{"customerIntegrationId":"integration-1","headers":{"Authorization":"Bearer 1234567890"}}]

Responses

200

Action run successfully. Returns runId and output in the shape of action's output schema

application/json

runIdstring · uuidRequired

The ID of the run that was created

outputobjectRequired

The output of the action

401

Unauthorized - invalid API key

post

/v1/actions/run

HTTPcURLJavaScriptPython

POST /v1/actions/run HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 172

{
  "key": "action-1",
  "userId": "user-123",
  "input": {
    "name": "John Doe"
  },
  "passThrough": [
    {
      "customerIntegrationId": "integration-1",
      "headers": {
        "Authorization": "Bearer 1234567890"
      }
    }
  ]
}

{
  "runId": "123e4567-e89b-12d3-a456-426614174000",
  "output": {}
}