Create AI Provider | BCTRL Docs

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

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Request

This endpoint expects an object.

namestringRequired1-200 characters

providerenumRequired

Allowed values:

apiKeystringOptional>=1 character

configobjectOptional

scopeobjectOptional

statusenumOptional

Allowed values:

Response

Default Response

configobject

createdAtstring

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

namestring1-200 characters

providerenum

Allowed values:

scopeobject

statusenum

Allowed values:

updatedAtstring

$	curl -X POST https://api.bctrl.ai/v2/ai-providers \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Acme AI Provider",
>	"provider": "openai"
>	}'

1	{
2	"config": {
3	"hasApiKey": true,
4	"defaultModel": "gpt-4"
5	},
6	"createdAt": "2024-06-01T12:00:00Z",
7	"id": "acmeOpenAI123",
8	"name": "Acme AI Provider",
9	"provider": "openai",
10	"scope": {
11	"subaccountId": "subacct-7890"
12	},
13	"status": "enabled",
14	"updatedAt": "2024-06-01T12:00:00Z"
15	}