Governance Assignments

Upsert assignments

Changed on

Batched create-or-update of capability assignments. Existing assignments matched by (entityId, capabilityId) are updated; new pairs are created. On update, omitted fields (usageLimit, cadence) are preserved; on create both are required by the governance service.

put/api/v1-beta/customers/{id}/assignments

Request

  • Base URL
    https://api.stigg.io
  • URL
    https://api.stigg.io/api/v1-beta/customers/{id}/assignments
  • Auth
    API key in header X-API-KEY

Path parameters

idstring required

The customer identifier (owner) the assignments belong to

Headers

X-ACCOUNT-IDstring

Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.

X-ENVIRONMENT-IDstring

Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).

Request body

Response

Assignments after upsert.

Changes

    • warning

      added the new ContractNotFound enum value to the response property for the response status

    • warning

      added the new CreditOveragePriceCurrencyNotFound enum value to the response property for the response status

    • warning

      added the new InvalidCreditOverageBillingModel enum value to the response property for the response status

    • warning

      added the new InvoicePreviewNotAvailableForDraftContract enum value to the response property for the response status

    • warning

      added the new OveragePriceNotSupportedOnAddon enum value to the response property for the response status

    • warning

      added the new OveragePriceRequiresUsageLimit enum value to the response property for the response status