Skip to main content

​
Method

POST /v1/contract-series

​
Body Parameters

​
Headers

​
Authorization
string
Bearer token (requires contract-series:write).
​
content-type
string
application/json

​
Request Example

curl -X POST "https://api.voyantcloud.com/v1/contract-series" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "name": "Core Contracts",
    "prefix": "CNT",
    "pattern": "CNT-{year}-{sequence}",
    "resetPeriod": "year",
    "startValue": 100,
    "enforceGapless": true,
    "enforceMonotonicDates": true,
    "active": true,
    "defaultForBe": true
  }'

​
Response

{
  "series": {
    "id": "cs_01HZYQ0RN0AT4Z2ZEYQXT4S1B2",
    "workspaceId": "ws_01HZYPM2QF2R8X9SZQ0J9SYBCN",
    "name": "Core Contracts",
    "prefix": "CNT",
    "pattern": "CNT-{year}-{sequence}",
    "resetPeriod": "year",
    "startValue": 100,
    "enforceGapless": true,
    "enforceMonotonicDates": true,
    "active": true,
    "defaultForBe": true,
    "createdAt": "2025-01-06T10:14:32.000Z",
    "updatedAt": "2025-01-06T10:14:32.000Z"
  }
}
When defaultForBe is true, the previous default series (if any) is automatically unflagged.