InteliG
Sign Up

API Reference / Contributors - Roles

Create custom role

post https://api.intelig.ai/api/v1/intelig/contributors/roles

Auth: Authorization: ApiKey <key> (an API key sent as Bearer is rejected) or Authorization: Bearer <jwt> for a dashboard session. operationId: createRole

Creates a custom contributor role for the organization

Example request

curl -X POST "https://api.intelig.ai/api/v1/intelig/contributors/roles" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Platform Engineer",
    "level": 6
  }'

Request body

application/json

FieldTypeRequiredDescription
name string yes Role name Example: Platform Engineer
level integer (int32) yes Seniority level (1-10) Example: 6

Response 200

application/json · ApiResponseContributorRoleDto

FieldTypeDescription
success boolean —
message string —
data ContributorRoleDto Contributor role definition

Status codes

  • 200 — Role created successfully
  • 400 — Invalid request body
  • 401 — Not authenticated
  • 403 — Insufficient permissions to access code intelligence pillar
  • 409 — Role with this name already exists
  • 429 — —

Every response is wrapped in { success, message, data }. A 4xx means the request is wrong — do not retry it unchanged. A 429 carries Retry-After in seconds.