start api role

Create, update, and delete roles for permission management

Create, update, and delete roles for permission management

Requires authentication — run start login first or set START_API_KEY.

Commands

CommandDescription
start api role createCreate a new role in a server
start api role updateUpdate a role name or color
start api role deleteDelete a role

create

Create a new role in a server

Terminal

start api role create <name>
ArgumentRequiredDescription
nameYesRole name
FlagTypeDefaultDescription
--colorstring#808080Role color (hex, e.g. #3B82F6)

update

Update a role name or color

Terminal

start api role update <id>
ArgumentRequiredDescription
idYesRole ID
FlagTypeDefaultDescription
--namestringNew role name
--colorstringNew role color (hex)

delete

Delete a role

Terminal

start api role delete <id>
ArgumentRequiredDescription
idYesRole ID to delete

Examples

Create a role

Terminal

start api role create "Moderator" --color "#EF4444"
✓ Role "Moderator" created

Update a role

Terminal

start api role update role_abc123 --name "Senior Mod" --color "#3B82F6"
✓ Role updated

Delete a role

Terminal

start api role delete role_abc123
✓ Role deleted