Choose which roles may use AI connectors

Workspace owner only. Changes allowed_roles (a subset of owner, admin, manager, agent). AI Connectors are available automatically for existing and new workspaces. Confirmed changes and usage limits remain platform-controlled. A missing settings row uses default permissions.

PUT

https://api.channelautomation.com/api/workspaces/{workspaceId}/ai-connectors/access

Authorization

BearerAuth
HTTP Bearer (JWT)
required

Path parameters

workspaceId
string
required

Request body JSON required

allowed_roles
optional
array of
owner
or
admin
or
manager
or
agent

Returns

200

Same shape as GET

400

Invalid value, platform-controlled field sent, or nothing to change

403

Not the workspace owner

503

AI_CONNECTORS_NOT_SET_UP

Choose which roles may use AI connectors

curl --request PUT \
  --url 'https://api.channelautomation.com/api/workspaces/<workspaceId>/ai-connectors/access' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allowed_roles": [
    "owner"
  ]
}
'

const url = 'https://api.channelautomation.com/api/workspaces/<workspaceId>/ai-connectors/access';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({allowed_roles: ['owner']})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/workspaces/<workspaceId>/ai-connectors/access"

payload = { "allowed_roles": ["owner"] }
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)