Pricing

A location's current prices, its unpublished changes, and what blocks publishing#

GET /v1/account/groups/{groupId}/price-book

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Path parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Approve a location's price changes: they are published, on their date if one was asked#

POST /v1/account/groups/{groupId}/price-book/approve

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/approve" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

Cancel a scheduled price change before its date: it becomes the draft again#

POST /v1/account/groups/{groupId}/price-book/cancel-scheduled

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/cancel-scheduled" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Save a location's unpublished price changes#

PUT /v1/account/groups/{groupId}/price-book/draft

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X PUT "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/draft" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "content": {
    "entries": []
  }
}'

Discard a location's unpublished price changes#

DELETE /v1/account/groups/{groupId}/price-book/draft

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X DELETE "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/draft" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Publish a location's price changes, now or on a date. Sent for approval instead when your changes need it#

POST /v1/account/groups/{groupId}/price-book/publish

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/publish" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "effectiveFrom": "2026-01-15T15:30:00Z",
  "note": "string"
}'

Send price changes waiting for approval back to draft, with a note saying why#

POST /v1/account/groups/{groupId}/price-book/return

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/return" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

A location's published price books, newest first#

GET /v1/account/groups/{groupId}/price-book/versions

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Path parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/versions" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Publish a copy of an earlier price book as the newest version (sent for approval when your changes need it)#

POST /v1/account/groups/{groupId}/price-book/versions/{version}/rollback

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/versions/{version}/rollback" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Take back price changes you sent for approval, to change them#

POST /v1/account/groups/{groupId}/price-book/withdraw

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Type: object

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/groups/{groupId}/price-book/withdraw" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Every location you can see against every service: current prices and drafts, or the prices in effect at a past moment#

GET /v1/account/price-matrix

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Query parameters

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/price-matrix" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Approve the price changes waiting at several locations#

POST /v1/account/price-matrix/approve

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/price-matrix/approve" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "groupIds": [
    "grp_2ZPh7XbT0v9Ao4iJ3qK1mN8sRgE"
  ]
}'

Discard the unpublished price changes of several locations#

POST /v1/account/price-matrix/discard

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/price-matrix/discard" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "groupIds": [
    "grp_2ZPh7XbT0v9Ao4iJ3qK1mN8sRgE"
  ]
}'

Save unpublished price changes for several locations at once#

PUT /v1/account/price-matrix/drafts

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X PUT "$ANSWERSTACK_API_URL/v1/account/price-matrix/drafts" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "drafts": [
    {
      "groupId": "grp_2ZPh7XbT0v9Ao4iJ3qK1mN8sRgE",
      "content": {
        "entries": []
      }
    }
  ]
}'

Publish the price changes of several locations with one note, now or on a date (sent for approval when your changes need it)#

POST /v1/account/price-matrix/publish

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/price-matrix/publish" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "groupIds": [
    "grp_2ZPh7XbT0v9Ao4iJ3qK1mN8sRgE"
  ]
}'

The services, option sets and options you sell, and the pricing settings#

GET /v1/account/pricing/catalog

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/pricing/catalog" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Add an option set: a list of choices that changes a price#

POST /v1/account/pricing/option-sets

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Request body

application/json, required.

Response 201

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/option-sets" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

Rename, reorder or archive an option set#

PATCH /v1/account/pricing/option-sets/{optionSetId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X PATCH "$ANSWERSTACK_API_URL/v1/account/pricing/option-sets/{optionSetId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "archived": true,
  "name": "string",
  "sort": 0
}'

Add an option to a set: the account's, or a location's own#

POST /v1/account/pricing/option-sets/{optionSetId}/options

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 201

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/option-sets/{optionSetId}/options" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

Rename, reorder or archive an option#

PATCH /v1/account/pricing/options/{optionId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X PATCH "$ANSWERSTACK_API_URL/v1/account/pricing/options/{optionId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "archived": true,
  "name": "string",
  "sort": 0,
  "spokenName": "string",
  "synonyms": [
    "string"
  ]
}'

Add a service to the account's catalog, or a location's own#

POST /v1/account/pricing/services

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Request body

application/json, required.

Response 201

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/services" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

Change or archive a service. Every location that offers it is recomputed#

PATCH /v1/account/pricing/services/{serviceId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X PATCH "$ANSWERSTACK_API_URL/v1/account/pricing/services/{serviceId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "archived": true,
  "description": "string",
  "kind": "service",
  "name": "string",
  "optionSetIds": [
    "oset_2ZPh7XbT0v9Ao4iJ3qK1mN8sRgE"
  ],
  "perPerson": "single",
  "sort": 0,
  "spokenName": "string",
  "synonyms": [
    "string"
  ],
  "unit": "month"
}'

Your specials: drafts, those waiting for approval, and approved ones#

GET /v1/account/pricing/specials

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token). Bearer token: Authorization: Bearer <token> (An API token (ans_pat_ or ans_svc_). Only routes that list a scope here accept one, and only with that scope.).

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X GET "$ANSWERSTACK_API_URL/v1/account/pricing/specials" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Add a special. It is approved at once, or sent for approval when your changes need it, or kept as a draft#

POST /v1/account/pricing/specials

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Request body

application/json, required.

Response 201

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/specials" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "spokenWording": "string",
  "startsOn": "2026-01-15"
}'

Change a special. Changing an approved one sends it back for approval when your changes need it#

PATCH /v1/account/pricing/specials/{specialId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X PATCH "$ANSWERSTACK_API_URL/v1/account/pricing/specials/{specialId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "endsOn": "2026-01-15",
  "groupIds": [
    "grp_2ZPh7XbT0v9Ao4iJ3qK1mN8sRgE"
  ],
  "serviceIds": [
    "srv_2ZPh7XbT0v9Ao4iJ3qK1mN8sRgE"
  ],
  "spokenWording": "string",
  "startsOn": "2026-01-15",
  "title": "string",
  "writtenWording": "string"
}'

Delete a draft special (approved ones are ended, never deleted)#

DELETE /v1/account/pricing/specials/{specialId}

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Response 204

No content.

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X DELETE "$ANSWERSTACK_API_URL/v1/account/pricing/specials/{specialId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Approve a special waiting for approval#

POST /v1/account/pricing/specials/{specialId}/approve

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/specials/{specialId}/approve" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

End an approved special now: the agent stops mentioning it#

POST /v1/account/pricing/specials/{specialId}/end

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/specials/{specialId}/end" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

Send a special waiting for approval back to draft, with a note saying why#

POST /v1/account/pricing/specials/{specialId}/return

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/specials/{specialId}/return" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

Send a draft special for approval (approved at once when your changes do not need it)#

POST /v1/account/pricing/specials/{specialId}/submit

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/specials/{specialId}/submit" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

Take back a special you sent for approval#

POST /v1/account/pricing/specials/{specialId}/withdraw

Authentication: Bearer token: Authorization: Bearer <token> (Supabase access token).

Path parameters

Request body

application/json, required.

Response 200

Errors: 400, 401, 403, 404, 409, 429, 500, with an ErrorBody body.

Example

curl -X POST "$ANSWERSTACK_API_URL/v1/account/pricing/specials/{specialId}/withdraw" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'