Skip to main content
POST
/
v2
/
orgs
/
{orgSlug}
/
roles
cURL
curl --request POST \
  --url https://api.eda.prisme.ai/v2/orgs/{orgSlug}/roles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "permissions": [
    "<string>"
  ],
  "scopes": [
    "<string>"
  ]
}
'
{
  "name": "<string>",
  "slug": "<string>",
  "id": "<string>",
  "orgSlug": "<string>",
  "description": "<string>",
  "permissions": [
    "<string>"
  ],
  "scopes": [
    "<string>"
  ],
  "createdBy": "<string>",
  "updatedBy": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "isSystem": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.prisme.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
orgSlug
string
required

Body

application/json
​
name
string
required
​
slug
string
required
​
description
string
​
permissions
string[]

Array of permission strings. Convention: {product}:{resource}:{action} Wildcards: Use * at end only (e.g., orgs:* matches orgs:members:manage) Platform permissions: - orgs:* (full org access) - orgs:members:manage, orgs:roles:manage, orgs:manage - orgs:branding:manage, orgs:navigation:manage - orgs:subscriptions:view, orgs:subscriptions:manage - orgs:apikeys:manage, orgs:invites:manage, orgs:join-rules:manage - secure-chat:, store:, knowledge:, builder: - agent-builder:, analytics:view, platform-admin: Custom app permissions: {app-slug}:{resource}:{action} Example: my-crm:contacts:read, my-crm:deals:manage Super admin: ["*"] (matches everything)

​
scopes
string[]

Resource scopes granted by this role. Wildcards: ["*"] grants access to all resources.

Response

Role created

​
name
string
required
​
slug
string
required
​
id
string
​
orgSlug
string
​
description
string
​
permissions
string[]

Array of permission strings. Convention: {product}:{resource}:{action} Wildcards: Use * at end only (e.g., orgs:* matches orgs:members:manage) Platform permissions: - orgs:* (full org access) - orgs:members:manage, orgs:roles:manage, orgs:manage - orgs:branding:manage, orgs:navigation:manage - orgs:subscriptions:view, orgs:subscriptions:manage - orgs:apikeys:manage, orgs:invites:manage, orgs:join-rules:manage - secure-chat:, store:, knowledge:, builder: - agent-builder:, analytics:view, platform-admin: Custom app permissions: {app-slug}:{resource}:{action} Example: my-crm:contacts:read, my-crm:deals:manage Super admin: ["*"] (matches everything)

​
scopes
string[]

Resource scopes granted by this role. Wildcards: ["*"] grants access to all resources.

​
createdBy
string
​
updatedBy
string
​
createdAt
string
​
updatedAt
string
​
isSystem
boolean