API Reference

Roles

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create

POST/roles

Creates a new role

Body ParametersJSONExpand Collapse

role: string

Name of the role

ReturnsExpand Collapse

data: object { id, role }

Role object

id: string

Unique role ID

role: string

Name of the role

Create

HTTP

HTTP

TypeScript

Python

curl https://api.us-west-2.fragment.dev/roles \
    -H 'Content-Type: application/json' \
    -d '{
          "role": "admin"
        }'

200 example

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

Returns Examples

200 example

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