Create a new role

Creates a new role (cargo) for the company resolved from the API token.

Business rules:

  • name, externalCode, and similarity are required.
  • externalCode must be unique among active roles for the same company.
  • jobLevel is optional: omit the field, send null, or send an empty string ("")—empty string is normalized to null before persistence.
  • description is optional: omit the field, send null, or send an empty string.

Validation:

  • Invalid enum values for similarity or jobLevel, or other constraint violations return 400 with validation details.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 300

role name

string
enum
required

role similarity

string | null
enum

role job level; empty string is accepted and normalized to null

Allowed:
string
required
length ≤ 50

role external code

string
length ≤ 900

role description

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json