Create subscription plan

post

https://zyins.isaapi.com/v1/plans

Defines a new subscription plan and optional metered rate tiers. Intended for internal billing operators provisioning bespoke enterprise plans; most tenants should consume existing plans returned by List subscription plans.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Human-readable plan name shown on invoices and account screens.

base_price

string

required

Monthly base price as a decimal string

included_requests

integer

required

Requests included in the base price

rates

array of objects

Overage rate tiers

rates

Headers

Idempotency-Key

string

Client-supplied idempotency token for mutating versioned API requests
(POST, PUT, PATCH, DELETE under /v1/* and /v2/* where listed).

When the service has already completed a request for the same
account, route, key, and identical JSON body within the replay window,
it returns the stored HTTP status and body instead of executing again.

Reusing the same key with a different body returns 409 Conflict
(see 409 / Idempotency conflict responses on those operations). Keys
expire after 24 hours. Prefer a new UUID v4 per distinct logical operation.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

201Plan created

400Invalid request parameters

401Authentication required or invalid

403Insufficient permissions

409Idempotency key reused with a different request body than the completed replay entry for the same account, endpoint, and key.

429Rate limit exceeded

500Internal server error