# Create a category

This operation creates a category you can assign to a video for organization.

Endpoint: POST /categories
Version: BETA

## Request fields (application/json):

  - `category` (object)

  - `category.name` (string)
    Name of the category.
    Example: "My first category"

  - `category.description` (string)
    A description for the category.
    Example: "This is a category description"

  - `category.parent_id` (string)
    Identifier to the parent category if one exists.

If the category is on top level and no parent exists, the value is an empty string.

Example: "parent_id": ""

If the category is under an existing parent category, the value is the id of the parent category.

Example: "parent_id": "cb65a918-ad7d-406a-80d8-09c9c8d0dbb"


Note: When updating a category the parent can be removed by setting parent_id to an empty string.
    Example: "cb65a918-ad7d-406a-80d8-09c9c8d0dbb"

## Response 200 fields (application/json):

  - `category` (object)

  - `category.id` (string)
    Unique identifier for the category.
    Example: "cb65a918-ad7d-406a-80d8-09c9c8d0dbbd"

  - `category.name` (string)
    Name of the category.
    Example: "My first category"

  - `category.description` (string)
    A description for the category.
    Example: "This is a category description."

  - `category.parent_id` (string)
    Identifier to the parent category if one exists.

If the category is on top level and no parent exists, the value is an empty string.

Example: "parent_id": ""

If the category is under an existing parent category, the value is the id of the parent category.

Example: "parent_id": "cb65a918-ad7d-406a-80d8-09c9c8d0dbb"


Note: When updating a category the parent can be removed by setting parent_id to an empty string.
    Example: "cb65a918-ad7d-406a-80d8-09c9c8d0dbb"

## Response 401 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 422 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)