v2

latestOpenAPI 3.1.0LicenseRef-Convex2026-07-264790136.4 KB
Custom Roles

Create a custom role

Creates a new custom role for the team with the specified name, description, and permission statements.

post/teams/{team_id}/create_custom_role

Path parameters

team_idinteger required

Team ID

Request body

namestring required
descriptionstring nullable

Example request

{
  "statements": [
    {
      "resource": "project:*"
    }
  ]
}

Response

idinteger required
teamIdinteger required
namestring required
descriptionstring nullable
creatorinteger
createTimeinteger required

Example response

{
  "statements": [
    {
      "resource": "project:*"
    }
  ]
}