Create or update work activity

Creates a new work activity or updates an existing one. If an ID is provided, updates the existing activity; otherwise creates a new one.

Step-by-step process:

Provide a default activity name (used as fallback when no translation exists)
Add multilingual translations for the activity name
Optionally provide an ID to update an existing activity

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

Examples of work activities:

Development (for developers)
Management (for project leads)
Design (for designers)
Testing (for QA)
Review (for code reviews)

Note: After creation, assign this activity to specific task types to make it available for time tracking.

POST/administration/task-settings/activities

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Query parameters

fieldsToReturnstring

Comma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.

responseShapestring

Advanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:compactfull

Header parameters

LT-Response-Shapestring

Advanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:full

Request body

requiredapplication/json

idstring

Work activity ID (optional for create)

namestringrequired

Default work activity name (used as fallback when no translation exists for user's language)

translationsWorkActivityTranslationDto[]required

Language-specific translations for activity name. Overrides the default name when user's language matches.

Show properties

Array of WorkActivityTranslationDto

languagestringrequired

Language code following ISO 639-1 format (e.g., "en", "de", "fr")

namestringrequired

Translated name for this language. Overrides the default name when user's language matches.

Responses

201

Work activity created/updated successfully

idstringrequired

Work activity ID

namestringrequired

Default work activity name (used as fallback when no translation exists for user's language)

sortnumberrequired

Sort order

translationsWorkActivityTranslationDto[]required

Language-specific translations for activity name. Overrides the default name when user's language matches.

Show properties

Array of WorkActivityTranslationDto

languagestringrequired

Language code following ISO 639-1 format (e.g., "en", "de", "fr")

namestringrequired

Translated name for this language. Overrides the default name when user's language matches.

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

fieldsToReturnqueryComma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.responseShapequeryAdvanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.LT-Response-ShapeheaderAdvanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/administration/task-settings/activities" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Development",
  "translations": [
    {
      "language": "en",
      "name": "Development"
    }
  ]
}'

const response = await fetch("https://leadtime.app/api/public/administration/task-settings/activities", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"id\": \"123e4567-e89b-12d3-a456-426614174000\",\n  \"name\": \"Development\",\n  \"translations\": [\n    {\n      \"language\": \"en\",\n      \"name\": \"Development\"\n    }\n  ]\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/administration/task-settings/activities",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"id\": \"123e4567-e89b-12d3-a456-426614174000\",\n  \"name\": \"Development\",\n  \"translations\": [\n    {\n      \"language\": \"en\",\n      \"name\": \"Development\"\n    }\n  ]\n}",
)

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Development",
  "sort": 1,
  "translations": [
    {
      "language": "en",
      "name": "Development"
    }
  ]
}