API Reference

Roles

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create

roles.create(RoleCreateParams**kwargs) -> RoleCreateResponse

POST/roles

Creates a new role

ParametersExpand Collapse

role: str

Name of the role

ReturnsExpand Collapse

class RoleCreateResponse: …

data: Data

Role object

id: str

Unique role ID

role: str

Name of the role

Create

Python

HTTP

TypeScript

Python

from fragment import Fragment

client = Fragment()
role = client.roles.create(
    role="admin",
)
print(role.data)

200 example

{
  "data": {
    "id": "role_abc123",
    "role": "admin"
  }
}

Returns Examples

200 example

{
  "data": {
    "id": "role_abc123",
    "role": "admin"
  }
}