# catalog_roles_public_create

Add or update a role through the public API (when enabled).

Endpoint: POST /api/catalog/roles/public/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Request fields (application/json):

  - `id` (integer)
    Role ID (for updates)

  - `name` (string, required)
    Role name

  - `slug` (string)
    Role slug

  - `platform_key` (string)
    Platform key

  - `data` (any)
    Additional role data

## Response 200 fields (application/json):

  - `id` (integer, required)

  - `name` (string,null, required)
    The display name of the role.

  - `slug` (string,null, required)
    An additional unique slug field.

  - `platform_key` (string)

  - `skills` (array, required)

  - `skills.name` (string,null, required)
    Display name

  - `skills.slug` (string,null, required)
    An additional unique slug field. (Optional)

  - `skills.data` (any,null, required)
    Metadata

## Response 201 fields (application/json):

  - `id` (integer, required)

  - `name` (string,null, required)
    The display name of the role.

  - `slug` (string,null, required)
    An additional unique slug field.

  - `platform_key` (string)

  - `skills` (array, required)

  - `skills.name` (string,null, required)
    Display name

  - `skills.slug` (string,null, required)
    An additional unique slug field. (Optional)

  - `skills.data` (any,null, required)
    Metadata