Skip to content

Create a role

POST
/organisations/{orgId}/roles
curl --request POST \
--url https://kravos-orchestrator.onrender.com/organisations/example/roles \
--header 'Content-Type: application/json' \
--data '{ "name": "example", "overallThreshold": 1, "dimensions": [ { "name": "example", "weight": 1, "category": "process", "threshold": 1 } ], "ticketIds": [ "example" ] }'

Creates a role and its scoring rubric. Dimension weights must be integers summing to exactly 100, a constraint enforced in code because JSON Schema cannot express it.

orgId
required
string
Media typeapplication/json
object
name
required
string
/\S/
overallThreshold
required
integer
<= 100
dimensions
required
Array<object>
>= 1 items
object
name
required
string
/\S/
weight
required
integer
<= 100
category
required
string
Allowed values: process correctness
threshold
integer
<= 100
ticketIds
Array<string>

Default Response