Create AI Connection

Create an AI connection with provider credentials and model defaults. Hosted surfaces such as Stagehand or browser-use can use this saved configuration during agent work.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Request

This endpoint expects an object.

labelstringRequired1-200 characters

providerenumRequired

Allowed values:

apiKeystringOptional>=1 character

defaultModelstringOptional>=1 character

enabledbooleanOptional

subaccountIdstringOptional>=1 character

Response

Default Response

createdAtstring

enabledboolean

hasStoredKeyboolean

idstringformat: "^[A-Za-z0-9_-]{1,64}$"

labelstring1-200 characters

providerenum

Allowed values:

updatedAtstring

defaultModelstring or null>=1 character

subaccountIdstring or null>=1 character

1	curl -X POST https://api.bctrl.ai/v1/ai-connections \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"label": "Customer Support AI",
6	"provider": "openai"
7	}'

1	{
2	"createdAt": "2024-06-10T09:15:00Z",
3	"enabled": true,
4	"hasStoredKey": true,
5	"id": "aiConn_9f8d7a6b3c",
6	"label": "Customer Support AI",
7	"provider": "openai",
8	"updatedAt": "2024-06-10T09:15:00Z",
9	"defaultModel": "gpt-4",
10	"subaccountId": "subacct_12345"
11	}