Skip to main content

​
Available Scopes

ScopeDescription
readRead resources (calls, notes, evaluations)
writeCreate and update resources
deleteDelete resources
adminManage project settings and team

​
Scope Combinations

# Read-only key
key = client.api_keys.create(
    name="analytics-reader",
    scopes=["read"]
)

# Full access
key = client.api_keys.create(
    name="production",
    scopes=["read", "write", "delete"]
)

​
Insufficient Scope Error

{
  "error": {
    "type": "forbidden",
    "code": "insufficient_scope",
    "message": "This action requires the 'write' scope"
  }
}