Skip to main content
POST
/
integrations
/
connections
Create integration connection
curl --request POST \
  --url https://api.blaxel.ai/v0/integrations/connections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": {
    "name": "my-resource",
    "displayName": "My Resource",
    "labels": {}
  },
  "spec": {
    "config": {},
    "integration": "openai",
    "sandbox": false,
    "secret": {}
  }
}
'
{
  "metadata": {
    "name": "my-resource",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "createdBy": "<string>",
    "updatedBy": "<string>",
    "displayName": "My Resource",
    "labels": {},
    "plan": "<string>",
    "url": "<string>",
    "workspace": "<string>"
  },
  "spec": {
    "config": {},
    "integration": "openai",
    "sandbox": false,
    "secret": {}
  }
}

Authorizations

Authorization
string
header
required

OAuth2 authentication with JWT tokens

Body

application/json

Configured connection to an external service (LLM provider, API, SaaS, database) storing credentials and settings for use by workspace resources.

metadata
object
required

Common metadata fields shared by all Blaxel resources including name, labels, timestamps, and ownership information

spec
object
required

Specification defining the integration type, configuration parameters, and encrypted credentials

Response

successful operation

Configured connection to an external service (LLM provider, API, SaaS, database) storing credentials and settings for use by workspace resources.

metadata
object
required

Common metadata fields shared by all Blaxel resources including name, labels, timestamps, and ownership information

spec
object
required

Specification defining the integration type, configuration parameters, and encrypted credentials