POST
/
api
/
v1
/
roles
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.roles.create(request={
        "name": "prompt_engineer",
        "description": "Role for users who can fetch and change prompts",
        "permissions": [
            "prompts_read",
            "prompts_write",
            "prompts_delete",
        ],
    })

    # Handle response
    print(res)
{
  "name": "prompt_engineer",
  "description": "Role for users who can fetch and change prompts",
  "permissions": [
    "prompts_read",
    "prompts_write",
    "prompts_delete"
  ],
  "id": 1,
  "last_updated_comments": "Updated to add delete permission",
  "is_system_role": false,
  "last_updated": "2023-11-07T05:31:56Z",
  "last_updated_by": "user@email.com"
}

Authorizations

Syllable-API-Key
string
header
required

Body

application/json

Request model to create a role.

Response

200
application/json

Successful Response

Information about a role.