Brains
Create a Brain source
POST /v1/brains/{brainId}/sources · SDK createBrainSource · CLI deployments brain-source create
POST
Requires brains:admin.
tenantJwtheader
AuthorizationBearer <token>Tenant JWT carrying organization, project, and environment claims.
brainId*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-organization*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$idempotency-key*stringLimited to 500 UTF-8 bytes.
Length
1 <= length <= 500application/json- body
kind*"upload"Value in
"upload"name*stringLength
length <= 200BrainSourceResponse
application/json- response
brainId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$connectionId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$configuration?createdAt*stringcreatedByPrincipalId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$id*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$environmentId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$kind*stringValue in
"email""github""google-drive""notion""platform-conversation""slack""teams""upload"lastSyncAt?stringname*stringLength
length <= 200organizationId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$projectId?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$status*stringValue in
"active""archived""failed""paused"syncCursor?stringsyncError?stringupdatedAt*stringupdatedByPrincipalId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$version*integerRange
0 <= valuecurl -X POST "https://example.com/v1/brains/string/sources" \ -H "x-deployments-organization: string" \ -H "idempotency-key: string" \ -H "Content-Type: application/json" \ -d '{ "kind": "upload", "name": "string" }'{ "brainId": "string", "connectionId": "string", "configuration": {}, "createdAt": "string", "createdByPrincipalId": "string", "id": "string", "environmentId": "string", "kind": "email", "lastSyncAt": "string", "name": "string", "organizationId": "string", "projectId": "string", "status": "active", "syncCursor": "string", "syncError": "string", "updatedAt": "string", "updatedByPrincipalId": "string", "version": 0}