Create project category

Creates a new project category for organizing projects by type or purpose.

Required fields:

name: Display name for the category (e.g., “Development”, “Support”)
icon: Icon identifier in format :icon_name: (e.g., “:rocket:”, “:wrench:”)
translations: Array of translations for multilingual support

Optional fields:

description: Additional context about when to use this category

Multilingual support: Provide translations array with language codes (e.g., “en”, “de”) and corresponding names/descriptions. The system will automatically display the correct language based on user preferences.

Note: Categories are workspace-specific. Once created, they appear as options when creating or editing projects.

POST/administration/project-settings/categories

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

descriptionobject

Optional description providing context about when to use this category. Helps users understand the purpose of the category.

iconstringrequired

Icon identifier in emoji format. Must be wrapped in colons (e.g., ":rocket:", ":wrench:", ":briefcase:"). The icon appears next to the category name throughout the application.

namestringrequired

Display name for the project category. Used to organize projects by type or purpose (e.g., "Development", "Support", "New Client Project").

translationsProjectCategoryTranslationDto[]required

Array of translations for multilingual support. Each translation object contains a language code and translated name/description. The system automatically displays the correct language based on user preferences.

Show properties

Array of ProjectCategoryTranslationDto

descriptionobject

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

languagestringrequired

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

nameobject

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

Responses

201

Project category created successfully

descriptionobject

Optional description providing context about when to use this category.

iconstringrequired

Icon identifier in emoji format (e.g., ":rocket:"). Displayed next to the category name throughout the application.

idstringrequired

Unique identifier (UUID) for the project category. Used to reference this category when creating or updating projects.

namestringrequired

Display name of the project category. Shown in dropdowns and project lists.

sortnumber

Numeric sort order for display purposes. Lower numbers appear first in lists and dropdowns. May be undefined if not explicitly set.

translationsProjectCategoryTranslationDto[]required

Complete array of translations for all supported languages. Each translation contains the language code and localized name/description.

Show properties

Array of ProjectCategoryTranslationDto

descriptionobject

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

languagestringrequired

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

nameobject

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

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

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/administration/project-settings/categories" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Projects related to software development",
  "icon": ":rocket:",
  "name": "Development",
  "translations": [
    {
      "description": "Software development projects",
      "language": "en",
      "name": "Development"
    },
    {
      "description": "Softwareentwicklungsprojekte",
      "language": "de",
      "name": "Entwicklung"
    }
  ]
}'

const response = await fetch("https://leadtime.app/api/public/administration/project-settings/categories", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"description\": \"Projects related to software development\",\n  \"icon\": \":rocket:\",\n  \"name\": \"Development\",\n  \"translations\": [\n    {\n      \"description\": \"Software development projects\",\n      \"language\": \"en\",\n      \"name\": \"Development\"\n    },\n    {\n      \"description\": \"Softwareentwicklungsprojekte\",\n      \"language\": \"de\",\n      \"name\": \"Entwicklung\"\n    }\n  ]\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/administration/project-settings/categories",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"description\": \"Projects related to software development\",\n  \"icon\": \":rocket:\",\n  \"name\": \"Development\",\n  \"translations\": [\n    {\n      \"description\": \"Software development projects\",\n      \"language\": \"en\",\n      \"name\": \"Development\"\n    },\n    {\n      \"description\": \"Softwareentwicklungsprojekte\",\n      \"language\": \"de\",\n      \"name\": \"Entwicklung\"\n    }\n  ]\n}",
)

Response

{
  "description": "Projects related to software development",
  "icon": ":rocket:",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Development",
  "sort": 1,
  "translations": [
    {
      "description": "Software development projects",
      "language": "en",
      "name": "Development"
    },
    {
      "description": "Softwareentwicklungsprojekte",
      "language": "de",
      "name": "Entwicklung"
    }
  ]
}