Add a connection

POST/v1/admin/connections

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

description?string

baseUrl*string

OpenAI-compatible base URL including the version prefix, for example https://proxy.example.edu/v1

apiKey?string

Stored encrypted; never returned

timeoutSeconds?integer

Formatint32

Range1 <= value <= 600

Default60

requestsPerMinute?integer

Request limit per minute; omit or 0 for unlimited

Formatint32

Range0 <= value <= 1000000

maxConcurrentRequests?integer

Requests in flight at once per Grounded process (SystemOne models)

Formatint32

Range1 <= value <= 256

Default8

enabled?boolean

Defaulttrue

Response Body

`application/json`

curl -X POST "https://example.com/v1/admin/connections" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "baseUrl": "string"  }'

{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "Campus AI gateway",    "description": "string",    "baseUrl": "https://ai-gateway.example.edu/v1",    "hasApiKey": true,    "apiKeyHint": "string",    "timeoutSeconds": 0,    "requestsPerMinute": 0,    "maxConcurrentRequests": 1,    "enabled": true,    "modelCount": 0,    "revision": 0,    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

201application/json

400application/json

403application/json

409application/json

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`