POST/api/v1/contract-line-templates

Create contract line template

Creates a plan template record under plan_templates with optional default services.

Request body

Content type: application/json · schema CreateContractLineTemplateBody

template_namestringRequired

min length 1 · max length 255

template_descriptionstring

contract_line_typestringRequired

Enum: FixedHourlyUsage

billing_frequencystringRequired

Enum: weeklybi-weeklymonthlyquarterlysemi-annuallyannually

default_servicesarray of object

itemsobject

service_idstring <uuid>Required

configuration_typestringRequired

Enum: FixedHourlyUsageBucket

default_ratenumber

≥ 0

quantitynumber

≥ 1

is_publicboolean

Response body

Success response 201 · schema ContractLineApiSuccess

successbooleanRequired

Enum: true

dataanyOfRequired

anyOf (option 1)object

anyOf (option 2)array of object

itemsobject

metaobject

timestampstring <date-time>Required

versionstringRequired

Response codes

201

Template created.

400

Invalid request payload.

401

x-api-key missing at middleware.

500

Request context missing or template creation failure.

POST /api/v1/contract-line-templates

cURL

curl -X POST "https://algapsa.com/api/v1/contract-line-templates" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "template_name": "x",
  "template_description": "string",
  "contract_line_type": "Fixed",
  "billing_frequency": "weekly",
  "default_services": [
    {
      "service_id": "01HN2K7VRB9PQ3Y0000000000",
      "configuration_type": "Fixed",
      "default_rate": 0,
      "quantity": 1
    }
  ],
  "is_public": false
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/contract-line-templates", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "template_name": "x",
    "template_description": "string",
    "contract_line_type": "Fixed",
    "billing_frequency": "weekly",
    "default_services": [
      {
        "service_id": "01HN2K7VRB9PQ3Y0000000000",
        "configuration_type": "Fixed",
        "default_rate": 0,
        "quantity": 1
      }
    ],
    "is_public": false
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/contract-line-templates");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""template_name"": ""x"",
  ""template_description"": ""string"",
  ""contract_line_type"": ""Fixed"",
  ""billing_frequency"": ""weekly"",
  ""default_services"": [
    {
      ""service_id"": ""01HN2K7VRB9PQ3Y0000000000"",
      ""configuration_type"": ""Fixed"",
      ""default_rate"": 0,
      ""quantity"": 1
    }
  ],
  ""is_public"": false
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

201 OK·application/json

{
  "success": true,
  "data": {},
  "meta": {
    "timestamp": "2026-04-18T15:22:14Z",
    "version": "string"
  }
}