---
search:
  tags:
    - administration
    - POST
seo:
  description: >-
    Creates a new task status. All fields are required. Reference for the POST
    /administration/task-settings/statuses endpoint in the Leadtime Public API
    API.
sidebar:
  badge: POST
  label: Create or update task status
title: Create or update task status
type: openapi-operation
---
Creates a new task status. All fields are required.

**Step-by-step process:**
1. Provide a status name (e.g., "In Review", "Awaiting Approval")
2. Select an icon in format `:icon_name:` (e.g., `:hourglass_flowing_sand:`, `:check_mark:`)
3. Choose the base status type (New, InProgress, Feedback, Resolved, Closed, or Backlog)
4. Add multilingual translations for the status name

**Status types:**
Each custom status must be based on one of these types:
- **New**: Initial state, task not started
- **InProgress**: Active work phase
- **Feedback**: Needs input or review
- **Resolved**: Completed but not closed
- **Closed**: Finished and archived
- **Backlog**: Planned for later

**Icon format:**
Icons use emoji shortcodes in the format `:icon_name:`. Examples:
- `:hourglass_flowing_sand:` for time-based statuses
- `:check_mark:` for completed statuses
- `:x:` for cancelled statuses
- `:rocket:` for active statuses

**Multilingual support:**
Provide translations for status name. Leadtime automatically displays the correct text based on the user language.

**Note:** After creation, assign this status to specific task types to make it available in their workflows.

<Operation source="api-reference" id="tasksettingscontroller-savetaskstatus" />