# Create update classification

URL: /en/docs/api/v1/updates/classifications/post
Last Updated: 2026-07-30T21:15:30.381Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/updates/classifications

**Create update classification**

Create a tenant-owned classification for update organization and subscriber preferences.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Request body** (`application/json`) - required:

- `title` (string, required)
- `color` (string)
- `translations` (array of ClassificationTranslation (object))
  - `languages_code` (string)
  - `title` (string)
- `custom_fields` (array of ClassificationCustomField (object))
  - `title` (string)
  - `translations` (array of ClassificationTranslation (object))
    - `languages_code` (string)
    - `title` (string)
  - `options` (array of object)
    - `value` (string)
    - `label` (array of object)
      - `languages_code` (string)
      - `translation` (string)

Example (classification):

```json
{
  "title": "Security advisory",
  "color": "destructive",
  "translations": [
    {
      "languages_code": "de-DE",
      "title": "Sicherheitshinweis"
    }
  ],
  "custom_fields": [
    {
      "title": "Severity",
      "options": [
        {
          "value": "low"
        },
        {
          "value": "medium"
        },
        {
          "value": "high"
        }
      ]
    }
  ]
}
```

**Responses:**

- `201` - Classification created
  - `success` (boolean)
  - `data` (object)
    - `classification` (Classification (object))
      - `id` (string)
      - `title` (string)
      - `color` (any)
      - `translations` (array of ClassificationTranslation (object))
        - `languages_code` (string)
        - `title` (string)
      - `custom_fields` (array of ClassificationCustomField (object))
        - `title` (string)
        - `translations` (array of ClassificationTranslation (object))
          - `languages_code` (string)
          - `title` (string)
        - `options` (array of object)
          - `value` (string)
          - `label` (array of object)
            - `languages_code` (string)
            - `translation` (string)
- `400` - Validation failed
- `500` - Failed to create classification