POST /api/roles
application/json

Body Required

  • name string Required

    Maximum length is 64.

  • scope array

    Default value is [] (empty).

Responses

  • 201 application/json

    Successful Response

    Hide response attributes Show response attributes object
    • role_id integer Required
    • name string Required
    • scope array Required
    • created_at integer Required
  • 503 application/json

    Database connection error

    Hide response attribute Show response attribute object
    • detail string

      Default value is Can't connect to MySQL server on '[SERVER]'.
  • 422 application/json

    Validation Error

    Hide response attribute Show response attribute object
    • detail array[object]
      Hide detail attributes Show detail attributes object
      • loc array[string | integer] Required
      • msg string Required
      • type string Required
POST /api/roles 
curl \
 -X POST https://lztup.toil.cc/api/roles \
 -H "Content-Type: application/json" \
 -d '{"name":"string","scope":[]}'
Request example 
{
  "name": "string",
  "scope": []
}
Request examples 
{
  "name": "string",
  "scope": []
}
Response examples (201) 
{
  "role_id": 42,
  "name": "string",
  "scope": [],
  "created_at": 42
}
Response examples (503) 
{
  "detail": "Can't connect to MySQL server on '[SERVER]'"
}
Response examples (422) 
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}