Skip to main content
The Connection Service handles the integration credentials, webhook translation layer, and remote actions for external tools. Base URL: https://api.thygon.com

​
Connection providers

Providers are the templates defining integration parameters (e.g. Slack or GitHub).

​
List connection providers

GET /vertex/http-connection-providers

​
Create connection provider

POST /vertex/http-connection-providers

​
Connections

Connections represent configured credentials of a provider for an organization.

​
List connections

GET /vertex/connections

​
Create connection

POST /vertex/connections Authorize a new connection by passing access keys, tokens, or OAuth configs. Request body: 
{
  "name": "slack-engineering",
  "organization_id": "org_acme_123",
  "provider_id": "prov_slack",
  "credentials": {
    "token": "xoxb-your-slack-bot-token"
  },
  "description": "Primary communication channel for alerting"
}
Response (200 OK): 
{
  "id": "conn_slack_engineering",
  "name": "slack-engineering",
  "organization_id": "org_acme_123",
  "provider_id": "prov_slack",
  "description": "Primary communication channel for alerting"
}

​
Get connection

GET /vertex/connections/{connection_id}

​
Update connection

PATCH /vertex/connections/{connection_id}

​
Delete connection

DELETE /vertex/connections/{connection_id}

​
Invoking remote actions

​
Invoke connection action

POST /vertex/{organization_id} Workflows or agents call this endpoint to trigger specific SaaS endpoints or operations on behalf of the organization. Request body: 
{
  "service_channel_id": "chan_slack_alerts",
  "operation": "post_message",
  "args": {
    "channel": "#ops-alerts",
    "text": "Critical support ticket created: Cannot access billing portal."
  }
}
Response (200 OK): 
{
  "success": true,
  "result": {
    "ts": "1686935712.0001",
    "channel": "C12345"
  }
}