POST/api/v1/contract-lines/bulk/add-services

Bulk add services to contract line

Adds multiple services to one contract_line_id and returns per-service success/failure results.

Request body

Content type: application/json · schema BulkAddServicesBody

contract_line_idstring <uuid>Required

servicesarray of ContractLineAddServiceBodyRequired

min items 1 · max items 20

itemsobject

service_idstring <uuid>Required

quantitynumber

≥ 1

custom_ratenumber

≥ 0

configuration_typestring

Enum: FixedHourlyUsageBucket

type_configobject

Response body

Success response 200 · 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

200

Bulk service add completed.

400

Invalid request payload.

401

x-api-key missing at middleware.

500

Request context missing or unhandled service failure.

POST /api/v1/contract-lines/bulk/add-services

cURL

curl -X POST "https://algapsa.com/api/v1/contract-lines/bulk/add-services" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contract_line_id": "01HN2K7VRB9PQ3Y0000000000",
  "services": [
    {
      "service_id": "01HN2K7VRB9PQ3Y0000000000",
      "quantity": 1,
      "custom_rate": 0,
      "configuration_type": "Fixed",
      "type_config": {}
    }
  ]
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/contract-lines/bulk/add-services", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "contract_line_id": "01HN2K7VRB9PQ3Y0000000000",
    "services": [
      {
        "service_id": "01HN2K7VRB9PQ3Y0000000000",
        "quantity": 1,
        "custom_rate": 0,
        "configuration_type": "Fixed",
        "type_config": {}
      }
    ]
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/contract-lines/bulk/add-services");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""contract_line_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""services"": [
    {
      ""service_id"": ""01HN2K7VRB9PQ3Y0000000000"",
      ""quantity"": 1,
      ""custom_rate"": 0,
      ""configuration_type"": ""Fixed"",
      ""type_config"": {}
    }
  ]
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

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