Connectors

Connect accounts, manage connections and policies, run tools. 20 endpoints

GET /integrations/catalog

/api/v1/integrations/catalog · Needs a session

Parameters

Field	Type	Required	Notes
q (query)	string

Example

curl -X GET 'https://api.lexcetha.com/api/v1/integrations/catalog' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /connector-providers

/api/v1/connector-providers · Needs a session

Parameters

Field	Type	Required	Notes
q (query)	string

Example

curl -X GET 'https://api.lexcetha.com/api/v1/connector-providers' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /integrations/connections

/api/v1/integrations/connections · Needs a session

Example

curl -X GET 'https://api.lexcetha.com/api/v1/integrations/connections' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /connector-connections

/api/v1/connector-connections · Needs a session

Example

curl -X GET 'https://api.lexcetha.com/api/v1/connector-connections' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /integrations/{toolkitSlug}/connect

/api/v1/integrations/{toolkitSlug}/connect · Needs a session

Parameters

Field	Type	Required	Notes
toolkitSlug (path)	string	yes

Request body

Field	Type	Required	Notes
credentials	record<string, string>
label	string		length 0–80
returnTo	string		length 0–300 · pattern ^\/(?!\/)[A-Za-z0-9/_\-.~%?=&]*$

Example

curl -X POST 'https://api.lexcetha.com/api/v1/integrations/:toolkitSlug/connect' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

GET /integrations/connections/{connectionId}

/api/v1/integrations/connections/{connectionId} · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Example

curl -X GET 'https://api.lexcetha.com/api/v1/integrations/connections/:connectionId' \
  -H "Authorization: Bearer $LEX_TOKEN"

PATCH /integrations/connections/{connectionId}

/api/v1/integrations/connections/{connectionId} · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Request body

Field	Type	Required	Notes
displayLabel	string		length 1–80
isDefault	true

Example

curl -X PATCH 'https://api.lexcetha.com/api/v1/integrations/connections/:connectionId' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

DELETE /integrations/connections/{connectionId}

/api/v1/integrations/connections/{connectionId} · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Example

curl -X DELETE 'https://api.lexcetha.com/api/v1/integrations/connections/:connectionId' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /connector-connections/{connectionId}

/api/v1/connector-connections/{connectionId} · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Example

curl -X GET 'https://api.lexcetha.com/api/v1/connector-connections/:connectionId' \
  -H "Authorization: Bearer $LEX_TOKEN"

PATCH /connector-connections/{connectionId}

/api/v1/connector-connections/{connectionId} · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Request body

Field	Type	Required	Notes
displayLabel	string		length 1–80
isDefault	true

Example

curl -X PATCH 'https://api.lexcetha.com/api/v1/connector-connections/:connectionId' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

DELETE /connector-connections/{connectionId}

/api/v1/connector-connections/{connectionId} · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Example

curl -X DELETE 'https://api.lexcetha.com/api/v1/connector-connections/:connectionId' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /integrations/callback/verify

/api/v1/integrations/callback/verify · Needs a session

Example

curl -X GET 'https://api.lexcetha.com/api/v1/integrations/callback/verify' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /integrations/connections/{connectionId}/sync

/api/v1/integrations/connections/{connectionId}/sync · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Example

curl -X POST 'https://api.lexcetha.com/api/v1/integrations/connections/:connectionId/sync' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /connector-connections/{connectionId}/test

/api/v1/connector-connections/{connectionId}/test · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Example

curl -X POST 'https://api.lexcetha.com/api/v1/connector-connections/:connectionId/test' \
  -H "Authorization: Bearer $LEX_TOKEN"

PUT /connector-connections/{connectionId}/bots

/api/v1/connector-connections/{connectionId}/bots · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes

Request body

Field	Type	Required	Notes
botId	string	yes	length 1–∞

Example

curl -X PUT 'https://api.lexcetha.com/api/v1/connector-connections/:connectionId/bots' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"botId":"string"}'

DELETE /connector-connections/{connectionId}/bots/{botId}

/api/v1/connector-connections/{connectionId}/bots/{botId} · Needs a session

Parameters

Field	Type	Required	Notes
connectionId (path)	string	yes
botId (path)	string	yes

Example

curl -X DELETE 'https://api.lexcetha.com/api/v1/connector-connections/:connectionId/bots/:botId' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /integrations/tools/search

/api/v1/integrations/tools/search · Needs a session

Example

curl -X GET 'https://api.lexcetha.com/api/v1/integrations/tools/search' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /integrations/tools/{toolSlug}/execute

/api/v1/integrations/tools/{toolSlug}/execute · Needs a session

Parameters

Field	Type	Required	Notes
toolSlug (path)	string	yes

Request body

Field	Type	Required	Notes
arguments	record<string, any>	yes	default {}
approvalId	string
idempotencyKey	string		length 8–200

Example

curl -X POST 'https://api.lexcetha.com/api/v1/integrations/tools/:toolSlug/execute' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"arguments":{}}'

GET /integrations/policies

/api/v1/integrations/policies · Needs a session

Example

curl -X GET 'https://api.lexcetha.com/api/v1/integrations/policies' \
  -H "Authorization: Bearer $LEX_TOKEN"

PUT /integrations/policies/{toolkitSlug}

/api/v1/integrations/policies/{toolkitSlug} · Needs a session

Parameters

Field	Type	Required	Notes
toolkitSlug (path)	string	yes

Request body

Field	Type	Required	Notes
enabled	boolean	yes
authConfigId	string | null
toolkitVersion	string | null
allowedTools	string[]		max 500 items
deniedTools	string[]		max 2000 items
autoRunTools	string[]		max 2000 items
askTools	string[]		max 2000 items
writeRequiresApproval	boolean

Example

curl -X PUT 'https://api.lexcetha.com/api/v1/integrations/policies/:toolkitSlug' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"enabled":true}'