Update project status

Updates an existing project status. All fields must be provided (full replacement).

Required fields:

name: Updated display name
icon: Updated icon identifier
type: Status type enum value
translations: Complete translations array (all languages)

Optional fields:

description: Updated description (can be null)

Note: This is a full update operation. Use PATCH endpoint if you only want to update specific fields. Changing the status type may affect billing eligibility for projects using this status.

PUT/administration/project-settings/statuses/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Request body

requiredapplication/json

descriptionobject

Description of the project status

iconstring

Icon for the project status in format :icon_name:

namestring

Name of the project status

translationsProjectStatusTranslationDto[]

Translations for the project status

Show properties

Array of ProjectStatusTranslationDto

descriptionobject

Translated description of the project status in this language. Provides context about when to use this status.

languagestringrequired

ISO 639-1 language code for the translation (e.g., "en" for English, "de" for German)

nameobject

Translated name of the project status in this language. Used for multilingual display in the user interface.

typestring

Type of the project status

Allowed:SalesRequirementsImplementationQualityManagementBillingDone

Responses

200

Project status updated successfully

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*

Bodyapplication/json

Request body

Request

curl -X PUT "https://leadtime.app/api/public/administration/project-settings/statuses/string" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Project is currently in development phase",
  "icon": ":hourglass_flowing_sand:",
  "name": "In Progress",
  "translations": [
    {
      "description": "Project is currently in progress",
      "language": "en",
      "name": "In Progress"
    }
  ],
  "type": "Implementation"
}'

const response = await fetch("https://leadtime.app/api/public/administration/project-settings/statuses/string", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"description\": \"Project is currently in development phase\",\n  \"icon\": \":hourglass_flowing_sand:\",\n  \"name\": \"In Progress\",\n  \"translations\": [\n    {\n      \"description\": \"Project is currently in progress\",\n      \"language\": \"en\",\n      \"name\": \"In Progress\"\n    }\n  ],\n  \"type\": \"Implementation\"\n}"
});

import requests

response = requests.put(
    "https://leadtime.app/api/public/administration/project-settings/statuses/string",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"description\": \"Project is currently in development phase\",\n  \"icon\": \":hourglass_flowing_sand:\",\n  \"name\": \"In Progress\",\n  \"translations\": [\n    {\n      \"description\": \"Project is currently in progress\",\n      \"language\": \"en\",\n      \"name\": \"In Progress\"\n    }\n  ],\n  \"type\": \"Implementation\"\n}",
)

Response

Project status updated successfully