Create support contingent

Creates a new support contingent (retainer plan) for a project.

Required fields:

projectId: ID of the project
title: Name of the contingent plan
fromDate: Start date (ISO 8601 date format)
toDate: End date (ISO 8601 date format)
frequency: Frequency in months
price: Total price for the period
hours: Total hours allocated

Optional fields:

transferable: Whether unused hours can be transferred (default: false)

Validation:

Date periods must not overlap with existing contingents in the same project
Rate is automatically calculated as price / hours
All numeric values must be non-negative

Note: Requires WsSettings.manageSettings permission.

POST/administration/project-settings/support-contingents

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

frequencynumberrequired

Frequency in months for the contingent period

fromDatestringrequired

Start date of the contingent period (ISO 8601 date format)

hoursnumberrequired

Total hours allocated for the contingent period

pricenumberrequired

Total price for the contingent period

projectIdstringrequired

ID of the project this contingent belongs to (UUID)

titlestringrequired

Title or name of the support contingent plan

toDatestring

End date of the contingent period (ISO 8601 date format). If not set, the contingent is active forever.

transferableboolean

Whether unused hours can be transferred to the next period

Responses

201

Support contingent created successfully

successbooleanrequired

Operation success flag

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

frequencynumber*Frequency in months for the contingent periodfromDatestring*Start date of the contingent period (ISO 8601 date format)hoursnumber*Total hours allocated for the contingent periodpricenumber*Total price for the contingent periodprojectIdstring*ID of the project this contingent belongs to (UUID)titlestring*Title or name of the support contingent plantoDatestringEnd date of the contingent period (ISO 8601 date format). If not set, the contingent is active forever.transferablebooleanWhether unused hours can be transferred to the next period

Request

curl -X POST "https://leadtime.app/api/public/administration/project-settings/support-contingents" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "frequency": 12,
  "fromDate": "2025-01-01",
  "hours": 120,
  "price": 10000,
  "projectId": "550e8400-e29b-41d4-a716-446655440001",
  "title": "Maintenance flatrate",
  "toDate": "2025-12-31",
  "transferable": false
}'

const response = await fetch("https://leadtime.app/api/public/administration/project-settings/support-contingents", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"frequency\": 12,\n  \"fromDate\": \"2025-01-01\",\n  \"hours\": 120,\n  \"price\": 10000,\n  \"projectId\": \"550e8400-e29b-41d4-a716-446655440001\",\n  \"title\": \"Maintenance flatrate\",\n  \"toDate\": \"2025-12-31\",\n  \"transferable\": false\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/administration/project-settings/support-contingents",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"frequency\": 12,\n  \"fromDate\": \"2025-01-01\",\n  \"hours\": 120,\n  \"price\": 10000,\n  \"projectId\": \"550e8400-e29b-41d4-a716-446655440001\",\n  \"title\": \"Maintenance flatrate\",\n  \"toDate\": \"2025-12-31\",\n  \"transferable\": false\n}",
)

Response

{
  "success": true
}