---
search:
  tags:
    - workspace
    - POST
seo:
  description: >-
    Creates a new manual position category or updates an… Reference for the POST
    /workspace/manual-position-categories endpoint in the Leadtime Public API
    API.
sidebar:
  badge: POST
  label: Create or update manual position category
title: Create or update manual position category
type: openapi-operation
---
Creates a new manual position category or updates an existing one. The operation is determined by whether an `id` is provided in the request body.

**How it works:**
- **Create**: Omit the `id` field (or set it to `null`) to create a new category
- **Update**: Include the `id` field with an existing category UUID to update that category

**What is returned:**
- The created or updated category with:
  - `id`: Category identifier (UUID)
  - `name`: Category name

**Validation rules:**
- `name`: Required, must be a non-empty string
- `id`: Optional, must be a valid UUID if provided

**Error handling:**
- If updating with an `id` that doesn't exist, returns `404 Not Found`
- If validation fails, returns `400 Bad Request` with detailed error messages

**Note:** This endpoint requires the `manageManualPositions` permission.

<Operation source="api-reference" id="manualpositioncategoriescontroller-createorupdatecategory" />