Subscription categories and custom fields

Category management#

Use https://my.assetcenter.app/api/v1/subscription-categories to manage the subscription categories belonging to your API key’s organization. The token creator must remain an active organization administrator. Existing keys keep their current permissions; create a replacement key to grant newly available access.

Permissions are independent. Subscription record permissions do not grant category management. New Read Only tokens include category read access; new Full Access tokens include all four category permissions. Use Custom to select individual permissions.

Endpoints#

• List categories and read category details.
• Get notification and field-type options.
• Create, update, or delete a category.
• Create, update, or delete a custom field.

All writes require an Idempotency-Key and support 24-hour replay. PATCH changes only supplied fields. Lists accept page and per_page; the other endpoints accept no query parameters.

Subscription values and data protections#

Category detail responses include field definitions, without subscription values. Use the returned category and field IDs to create subscriptions or update their values. The contract_lookahead_days setting controls the contract-expiry notification window. Checkbox fields are always optional.

Deleting a category is blocked while any subscription uses it or its custom fields retain populated values. Fields with values cannot be deleted or change type; labels and requirements remain editable. Retained values include those left by subscriptions that changed category. The response flags describe data constraints, not permission grants.

Manage display ordering in the app. Asset categories use their own endpoints and permissions.