Integration

Get All Integrations

get

Retrieves a list of all integrations, optionally filtered by active status

Authorizations

x-api-key

x-api-keystringRequired

Query parameters

activebooleanOptionalDefault: true

Responses

200

Integrations retrieved successfully

application/json

401

Unauthorized - invalid API key

500

Internal server error

get

/v1/integrations

HTTPcURLJavaScriptPython

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

[
  {
    "integrationId": "text",
    "customerIntegrationId": "text",
    "active": true,
    "name": "text",
    "description": "text",
    "host": "text",
    "updatedAt": "2026-02-06T14:41:03.635Z",
    "createdAt": "2026-02-06T14:41:03.635Z"
  }
]

Get Integration User

get

Retrieves a user for a specific customer integration

Authorizations

x-api-key

x-api-keystringRequired

Path parameters

customerIntegrationIdstringRequired

Customer integration ID

userIdstringRequired

User ID associated with the integration

Responses

200

Integration user retrieved successfully

application/json

401

Unauthorized - invalid API key

500

Internal server error

get

/v1/integrations/{customerIntegrationId}/users/{userId}

HTTPcURLJavaScriptPython

GET /v1/integrations/{customerIntegrationId}/users/{userId} HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Accept: */*

{
  "userId": "text",
  "active": true,
  "updatedAt": "2026-02-06T14:41:03.635Z",
  "createdAt": "2026-02-06T14:41:03.635Z"
}

Generate Integration User Auth URL

post

Generates an auth URL for a specific integration user. User will be created if it does not exist for the integration.

Authorizations

x-api-key

x-api-keystringRequired

Path parameters

customerIntegrationIdstringRequired

Customer integration ID

userIdstringRequired

User ID associated with the integration

Body

application/json

redirectUristringOptional

The optional redirect URI to redirect the user to after authentication. Askel will append query param ?status=success/error. If not provided, a default success/failure page will be shown.

Responses

201

Auth URL generated successfully

application/json

401

Unauthorized - invalid API key

500

Internal server error

post

/v1/integrations/{customerIntegrationId}/users/{userId}/auth-url

HTTPcURLJavaScriptPython

POST /v1/integrations/{customerIntegrationId}/users/{userId}/auth-url HTTP/1.1
Host: api.toolregistry.ai
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "redirectUri": "text"
}

{
  "authorizeUrl": "text"
}