> ## Documentation Index > Fetch the complete documentation index at: https://docs.outseta.com/llms.txt > Use this file to discover all available pages before exploring further. # Change a subscription on an account. > Returns an invoice object with information about the amount outstanding. ## OpenAPI ````yaml /api-reference/openapi.json put /api/v1/billing/subscriptions/{subscriptionUid}/changesubscription openapi: 3.0.0 info: title: Outseta API description: >- # Outseta REST API The Outseta REST API lets you manage people, accounts, subscriptions, invoices, email, and support resources over HTTPS. Responses are JSON unless an endpoint documents another format, such as an invoice PDF. **Base URL:** `https://{your-domain}.outseta.com/api/v1/` ## Contents - [Quick start](#quick-start) - [Authentication](#authentication) - [Server-side API keys](#server-side-api-keys) - [Client-side bearer tokens](#client-side-bearer-tokens) - [Two-factor authentication](#two-factor-authentication-2fa-during-login) - [Forced 2FA enrollment](#forced-2fa-enrollment-during-login) - [Working with collections](#working-with-collections) - [Field selection](#field-selection) - [Pagination](#pagination) - [Sorting](#sorting) - [Filtering](#filtering) - [Account billing stages](#account-billing-stages) - [Error responses](#error-responses) - [Rate limits](#rate-limits) - [Support](#support) - [Webhooks](#webhooks) - [Endpoint index](#endpoint-index) ## Quick start Authenticate every request with either a server-side API key or a user bearer token. For example: ```http GET /api/v1/crm/accounts?limit=20&fields=Uid,Name HTTP/1.1 Host: example.outseta.com Authorization: Outseta {api_key}:{api_secret} ``` List endpoints return a consistent envelope: ```json { "metadata": { "limit": 20, "offset": 0, "total": 142 }, "items": [] } ``` Use `limit` and `offset` for [pagination](#pagination), `fields` to control the response shape, `orderBy` for sorting, and entity properties for filtering. General request behavior: - Use HTTPS. HTTP requests are redirected to HTTPS with `301`. - `GET` retrieves, `POST` creates or invokes an action, `PUT` updates, and `DELETE` removes. - The API returns standard HTTP status codes. Error details are returned as JSON. - Add `donotlog=1` to a request that should not appear in the activity log. ## Authentication All API requests require authentication via one of two methods: ### Server-Side (API Keys) Use API keys for server-to-server integrations. Create keys at **Settings > Integrations > API Keys**. Make sure to record the secret key when you create it. ``` Authorization: Outseta {api_key}:{api_secret} ``` **Example:** ``` Authorization: Outseta ce08fd5a-e1ee-4472-9c5f-b7575d8369b2:74fc1d2242a4eb7336d34b0e40cfbc5f ``` > **Warning:** Never expose API keys in client-side code. The API key and secret combined give full access to all data in your account. ### Client-Side (Bearer Token) Do **not** use API keys on the client side — they can be easily copied. Instead, obtain a JWT access token by calling the `POST /tokens` endpoint from the server side with your credentials, then use it on the client: ``` Authorization: bearer {access_token} ``` Tokens are JWTs containing claims such as `PersonUid`, `AccountUid`, and subscription details. Tokens expire after approximately one year. Verify tokens server-side using Outseta's [JWKS endpoint](https://{your-domain}.outseta.com/.well-known/jwks.json). ### Two-Factor Authentication (2FA) During Login When a user has enabled two-factor authentication, a username and password are no longer sufficient to obtain a token — the login becomes a two-step exchange. You do not need to call any endpoint up front to discover whether 2FA is on; the response to `POST /tokens` tells you. **Step 1 — Attempt login as usual.** ``` POST /api/v1/tokens Content-Type: application/json { "username": "user@example.com", "password": "their-password" } ``` If the user has no 2FA enabled, you get the normal `200` token response and you're done: ```json { "access_token": "eyJ...", "token_type": "Bearer", "expires_in": 31536000 } ``` If the user **does** have 2FA enabled, the password is verified and the response is `202 Accepted` with a challenge instead of a token: ```json { "two_factor_required": true, "challenge_token": "eyJ...", "mechanism": "Totp", "masked_destination": "", "expires_in": 600, "available_mechanisms": ["Totp", "Email"], "recovery_codes_available": true } ``` This single response answers everything you need to know about the user's 2FA: | Field | Meaning | |-------|---------| | `mechanism` | The method this challenge targets: `Email` or `Totp` (authenticator app). **If `Email`, a one-time code has already been emailed to the user.** If `Totp`, nothing is sent — the user reads the current code from their authenticator app. | | `masked_destination` | Where an emailed code was sent, masked for display (e.g. `b***@outseta.com`). Empty when `mechanism` is `Totp`. | | `available_mechanisms` | Every method the user has enrolled. Use this to show the user their options (and to enable "use a different method"). | | `recovery_codes_available` | Whether the user has recovery codes they can fall back to. | | `challenge_token` | Opaque, short-lived token (valid for `expires_in` seconds, 600 = 10 minutes) that ties the next request to this challenge. Echo it back verbatim. | > When both an authenticator app and email are enrolled, Outseta picks the > authenticator app (`Totp`) as the default `mechanism` because it requires no > "check your inbox" step. The user can switch to email — see below. **Step 2 — Submit the code to get the token.** Collect the 6-digit code from the user (from their email or authenticator app) and post it along with the `challenge_token`: ``` POST /api/v1/tokens/two-factor Content-Type: application/json { "challenge_token": "eyJ...", "code": "123456" } ``` On success you receive the final JWT — the same shape as a normal login, and the token you use as the `Authorization: bearer {access_token}` for subsequent calls: ```json { "access_token": "eyJ...", "token_type": "Bearer", "expires_in": 31536000 } ``` Error responses: | Status | Body | Meaning | |--------|------|---------| | `400` | `invalid_grant` | The code was wrong or missing. The challenge allows up to 5 attempts before it locks. | | `410` | `challenge_expired` | The challenge token expired (older than 10 minutes). Start over at `POST /tokens`. | | `429` | — | Too many attempts; retry after a minute. | **Optional helper endpoints** (all take the `challenge_token` from Step 1): - **Resend an emailed code** — `POST /api/v1/tokens/two-factor/resend` with `{ "challenge_token": "..." }`. Returns a fresh challenge (same shape as the `202` above). Only valid for `Email` challenges; a `Totp` challenge returns `400` `not_supported`. - **Switch to a different method** — `POST /api/v1/tokens/two-factor/switch-mechanism` with `{ "challenge_token": "...", "mechanism": "Email" }`. Use this when the user picks one of the other `available_mechanisms` (e.g. they can't reach their authenticator). Returns a fresh challenge for the chosen mechanism (and sends a code when switching to `Email`). - **Use a recovery code** — `POST /api/v1/tokens/two-factor/recovery` with `{ "challenge_token": "...", "recovery_code": "abcd-efgh-ijkl" }`. Returns the final JWT, exactly like Step 2. Each recovery code is single-use. ### Forced 2FA Enrollment During Login Accounts can be configured to *require* 2FA. When a user who has not yet set it up tries to log in, they must enroll a method before they can get a token — all in the same login flow. **Step 1 — Attempt login.** Exactly as above. If the account forces 2FA and the user has no method enrolled, `POST /api/v1/tokens` verifies the password and returns `202 Accepted` with `two_factor_enrollment_required` (instead of `two_factor_required`): ```json { "two_factor_enrollment_required": true, "challenge_token": "eyJ...", "expires_in": 600 } ``` That `challenge_token` is the **enrollment token** — it proves the user's identity for the rest of the flow. Pass it as `enrollment_token` in every call below. Let the user pick a method (email or an authenticator app) and run the matching two-step *begin → confirm* sequence. **Option A — Enroll an authenticator app (recommended).** 1. Begin — exchange the enrollment token for a shared secret: ``` POST /api/v1/tokens/two-factor/enroll/totp/begin { "enrollment_token": "eyJ..." } ``` ```json { "challenge_token": "eyJ...", "secret": "JBSWY3DPEHPK3PXP", "otpauth_uri": "otpauth://totp/Acme:user@example.com?secret=...&issuer=Acme", "qr_code_png_base64": "iVBORw0KGgo...", "expires_in": 600 } ``` Have the user add the secret to their authenticator app — scan `qr_code_png_base64` (render it as an image), open `otpauth_uri`, or type the `secret` manually. 2. Confirm — submit the first code the app generates: ``` POST /api/v1/tokens/two-factor/enroll/totp/confirm { "enrollment_token": "eyJ...", "challenge_token": "eyJ...", "code": "123456" } ``` **Option B — Enroll email.** 1. Begin — a code is emailed to the user: ``` POST /api/v1/tokens/two-factor/enroll/email/begin { "enrollment_token": "eyJ..." } ``` ```json { "challenge_token": "eyJ...", "mechanism": "Email", "masked_destination": "b***@outseta.com", "expires_in": 600 } ``` 2. Confirm — submit the emailed code: ``` POST /api/v1/tokens/two-factor/enroll/email/confirm { "enrollment_token": "eyJ...", "challenge_token": "eyJ...", "code": "123456" } ``` **Confirm response (both options).** A successful confirm enables the method *and* completes the login in one shot — it returns the final JWT plus the user's recovery codes: ```json { "confirmed": true, "recovery_codes": ["abcd-efgh-ijkl", "mnop-qrst-uvwx", "..."], "access_token": "eyJ...", "token_type": "Bearer", "expires_in": 31536000 } ``` > Show `recovery_codes` to the user **once** and prompt them to save the codes — > they are generated as part of first-time enrollment and are never returned > again. Each is single-use at `POST /api/v1/tokens/two-factor/recovery`. Notes: - Both `begin` calls pass only the `enrollment_token`; both `confirm` calls pass the `enrollment_token`, the `challenge_token` from the matching `begin`, and the `code`. - `401` means the enrollment token is missing/invalid/expired (restart at Step 1); `403` means forced enrollment does not apply to the user; `400` (`invalid_grant`) means a wrong code; `410` (`challenge_expired`) means the challenge timed out. - Each token/challenge is valid for 10 minutes (`expires_in` = 600). If the user takes too long, restart at `POST /api/v1/tokens`. - After enrollment, the user is a normal 2FA user — subsequent logins follow the standard challenge flow described above, not this enrollment flow. ## Working with collections Collection endpoints support field selection, pagination, sorting, and filtering. Unless an endpoint says otherwise, these options can be combined in the same request. ### Field selection When you make an API request, you'll automatically get all the basic information from the main object and its immediate child objects. Referenced objects beyond the first level are returned as `null`. Change this behavior using the `fields` query parameter: - **Go deeper** — Request fields lower down in the object tree: `?fields=CurrentSubscription.Plan.*` - **Go lighter** — Request only the essentials for faster performance: `?fields=Uid,Name` - **Combination** — `?fields=Uid,Name,CurrentSubscription.Plan.Uid` - **Wildcard** — Use `*` to get all fields in an object: `?fields=*` or `?fields=CurrentSubscription.Plan.*` > **Tip:** When expanding nested paths, include `*` and intermediate path segments (e.g., `PersonAccount.*`) to preserve root-level and intermediate fields. **Examples:** ``` # Get the current subscription plan UID for an account GET /crm/accounts/{uid}?fields=CurrentSubscription.Plan.Uid # Get the account UID and plan UID for a list of accounts GET /crm/accounts?fields=Uid,CurrentSubscription.Plan.Uid # Get the full plan object for an account's current subscription GET /crm/accounts/{uid}?fields=CurrentSubscription.Plan.* # Get a person with their account and subscription info GET /crm/people/{uid}?fields=Uid,PersonAccount.Account.CurrentSubscription.Plan.Uid ``` If your request includes fields from a child object you will be limited to retrieving **25 items** per page. The maximum for requests not expanding child object fields is **100 items**. ### Pagination List endpoints return paginated results with a `metadata` object and an `items` array: ```json { "metadata": { "limit": 25, "offset": 0, "total": 142 }, "items": [ ... ] } ``` | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `offset` | integer | `0` | Page number (zero-based) | | `limit` | integer | `25` | Maximum number of records per page | **Examples:** ``` ?offset=0&limit=20 # returns results 1-20 ?offset=1&limit=20 # returns results 21-40 ``` ### Sorting Sort results using the `orderBy` parameter with a property name and direction: ``` ?orderBy=PropertyName+DESC ``` ### Filtering Filter results by passing entity properties as query parameters. #### Basic filtering Filter on any field using the field name as a query parameter: ``` GET /crm/people?Email=john@example.com GET /crm/accounts?AccountStage=2 ``` #### Wildcard matching | Pattern | Match Type | Example | |---------|-----------|---------| | `*value` | Ends with | `?Email=*@example.com` | | `value*` | Starts with | `?Name=Acme*` | | `*value*` | Contains | `?Name=*corp*` | #### Comparison operators For advanced filtering, append comparison operators to field names: | Operator | Description | Example | |----------|-------------|---------| | `__gt` | Greater than | `Created__gt=2024-01-01` | | `__gte` | Greater than or equal | `Amount__gte=100` | | `__lt` | Less than | `Created__lt=2024-12-31` | | `__lte` | Less than or equal | `Amount__lte=500` | | `__ne` | Not equal | `Status__ne=Active` | | `__isnull` | Is null (true/false) | `ProfileImageS3Url__isnull=true` | **Examples:** ``` # Date filtering GET /crm/accounts?Created__gt=2024-01-01 GET /billing/subscriptions?EndDate__lt=2024-08-01 # Numeric filtering GET /billing/invoices?Amount__gte=1000 # Null value filtering GET /crm/people?ProfileImageS3Url__isnull=true # Multiple filters combined with field selection GET /billing/subscriptions?StartDate__gte=2024-01-01&Rate__lt=100&DiscountCode__isnull=false&fields=Uid,Amount,StartDate,DiscountCode,Plan.Name ``` ## Account Billing Stages Account stages reflect the financial standing of each account and are not directly editable — they change automatically based on subscription activity. | Value | Stage | Description | |-------|-------|-------------| | `2` | Trialing | Currently on a free trial or free plan | | `3` | Subscribing | Active paid subscription (contributes to MRR) | | `4` | Canceling | Customer has indicated intent to cancel | | `5` | Expired | Subscription has ended after cancellation | | `6` | Trial Expired | Free trial ended without conversion to paid | Filter by stage: `GET /crm/accounts?AccountStage=3` returns all actively subscribing accounts. ## Error Responses | Status Code | Description | |-------------|-------------| | `200` | Success | | `301` | Redirect — HTTP requests are redirected to HTTPS | | `400` | Bad request — invalid parameters or Uid format | | `401` | Unauthorized — missing or invalid authentication | | `404` | Entity not found | | `4XX` / `5XX` | Client or server error | Validation errors return a JSON body with `ErrorMessage` and `PropertyName` fields: ```json { "ErrorMessage": "Invalid company email", "PropertyName": "Email" } ``` ## Rate Limits Requests authorized by an API Key should not exceed **4 requests/second**. ## Support For help regarding the Outseta API please email [support@outseta.com](mailto:support@outseta.com). ## Webhooks Use **Activity Notifications** to receive real-time callbacks when events occur in Outseta. Configure webhook URLs and their SHA256 signing secrets at **Settings > Notifications**. Always verify the signature before processing a request. Outseta sends an HTTP `POST` to each registered callback URL. The payload is the activity's entity restricted to a subset of fields, with an `ActivityEventData` property carrying activity-specific data. | Activity | Entity | Payload schema | | --- | --- | --- | | `AccountCreated` | `Account` | `AccountCreatedWebhookPayload` | | `AccountUpdated` | `Account` | `AccountUpdatedWebhookPayload` | | `AccountAddPerson` | `Account` | `AccountAddPersonWebhookPayload` | | `AccountStageUpdated` | `Account` | `AccountStageUpdatedWebhookPayload` | | `AccountDeleted` | `Account` | `AccountDeletedWebhookPayload` | | `AccountBillingInformationUpdated` | `Account` | `AccountBillingInformationUpdatedWebhookPayload` | | `AccountSubscriptionPlanUpdated` | `Account` | `AccountSubscriptionPlanUpdatedWebhookPayload` | | `AccountSubscriptionPaymentCollected` | `Account` | `AccountSubscriptionPaymentCollectedWebhookPayload` | | `AccountSubscriptionPaymentDeclined` | `Account` | `AccountSubscriptionPaymentDeclinedWebhookPayload` | | `AccountBillingInformationRequested` | `Account` | `AccountBillingInformationRequestedWebhookPayload` | | `AccountBillingInvoiceEmailSent` | `Invoice` | `AccountBillingInvoiceEmailSentWebhookPayload` | | `AccountRemovePerson` | `Account` | `AccountRemovePersonWebhookPayload` | | `AccountPaidSubscriptionCreated` | `Account` | `AccountPaidSubscriptionCreatedWebhookPayload` | | `AccountBillingInformationRemoved` | `Account` | `AccountBillingInformationRemovedWebhookPayload` | | `AccountPrimaryPersonUpdated` | `Account` | `AccountPrimaryPersonUpdatedWebhookPayload` | | `AccountBillingInvoiceCreated` | `Invoice` | `AccountBillingInvoiceCreatedWebhookPayload` | | `AccountSubscriptionStarted` | `Account` | `AccountSubscriptionStartedWebhookPayload` | | `AccountSubscriptionRenewalExtended` | `Account` | `AccountSubscriptionRenewalExtendedWebhookPayload` | | `AccountSubscriptionAddOnsChanged` | `Account` | `AccountSubscriptionAddOnsChangedWebhookPayload` | | `AccountSubscriptionCancellationRequested` | `Account` | `AccountSubscriptionCancellationRequestedWebhookPayload` | | `AccountBillingInvoiceDeleted` | `Invoice` | `AccountBillingInvoiceDeletedWebhookPayload` | | `AccountPersonRoleUpdated` | `Account` | `AccountPersonRoleUpdatedWebhookPayload` | | `PersonCreated` | `Person` | `PersonCreatedWebhookPayload` | | `PersonUpdated` | `Person` | `PersonUpdatedWebhookPayload` | | `PersonDeleted` | `Person` | `PersonDeletedWebhookPayload` | | `PersonLogin` | `Account` | `PersonLoginWebhookPayload` | | `PersonListSubscribed` | `Person` | `PersonListSubscribedWebhookPayload` | | `PersonListUnsubscribed` | `Person` | `PersonListUnsubscribedWebhookPayload` | | `PersonSegmentAdded` | `Person` | `PersonSegmentAddedWebhookPayload` | | `PersonSegmentRemoved` | `Person` | `PersonSegmentRemovedWebhookPayload` | | `PersonEmailOpened` | `Person` | `PersonEmailOpenedWebhookPayload` | | `PersonEmailClicked` | `Person` | `PersonEmailClickedWebhookPayload` | | `PersonEmailBounce` | `Person` | `PersonEmailBounceWebhookPayload` | | `PersonEmailSpam` | `Person` | `PersonEmailSpamWebhookPayload` | | `PersonSupportTicketCreated` | `Person` | `PersonSupportTicketCreatedWebhookPayload` | | `PersonSupportTicketUpdated` | `Person` | `PersonSupportTicketUpdatedWebhookPayload` | | `PersonLeadFormSubmitted` | `Person` | `PersonLeadFormSubmittedWebhookPayload` | | `PersonListConfirmed` | `Person` | `PersonListConfirmedWebhookPayload` | | `PersonEmailSubscribed` | `Person` | `PersonEmailSubscribedWebhookPayload` | | `PersonEmailUnsubscribed` | `Person` | `PersonEmailUnsubscribedWebhookPayload` | | `PersonTemporaryPasswordSet` | `Person` | `PersonTemporaryPasswordSetWebhookPayload` | | `PersonSupportTicketClosed` | `Person` | `PersonSupportTicketClosedWebhookPayload` | | `PersonTwoFactorRecoveryCodesRegenerated` | `Person` | `PersonTwoFactorRecoveryCodesRegeneratedWebhookPayload` | | `DealCreated` | `Deal` | `DealCreatedWebhookPayload` | | `DealUpdated` | `Deal` | `DealUpdatedWebhookPayload` | | `DealDeleted` | `Deal` | `DealDeletedWebhookPayload` | | `DealDueDate` | `Deal` | `DealDueDateWebhookPayload` | | `PlanCreated` | `Plan` | `PlanCreatedWebhookPayload` | | `PlanUpdated` | `Plan` | `PlanUpdatedWebhookPayload` | | `AddOnCreated` | `AddOn` | `AddOnCreatedWebhookPayload` | | `AddOnUpdated` | `AddOn` | `AddOnUpdatedWebhookPayload` | | `DiscordUserLinked` | `Person` | `DiscordUserLinkedWebhookPayload` | | `DiscordUserAddedToServer` | `Person` | `DiscordUserAddedToServerWebhookPayload` | | `DiscordUserRolesUpdated` | `Person` | `DiscordUserRolesUpdatedWebhookPayload` | | `DiscordUserRemovedFromServer` | `Person` | `DiscordUserRemovedFromServerWebhookPayload` | `TaskCreated` and `TaskUpdated` are not listed above because their payload is polymorphic: the webhook is rooted on the entity the task is associated with (an `Account`, `Person`, or `Deal`), with the task itself carried in the `ActivityEventData` property. Because the root entity varies per task, they do not have a single fixed payload schema. | Activity | Entity | Payload schema | | --- | --- | --- | | `AccountCreated` | `Account` | `AccountCreatedWebhookPayload` | | `AccountUpdated` | `Account` | `AccountUpdatedWebhookPayload` | | `AccountAddPerson` | `Account` | `AccountAddPersonWebhookPayload` | | `AccountStageUpdated` | `Account` | `AccountStageUpdatedWebhookPayload` | | `AccountDeleted` | `Account` | `AccountDeletedWebhookPayload` | | `AccountBillingInformationUpdated` | `Account` | `AccountBillingInformationUpdatedWebhookPayload` | | `AccountSubscriptionPlanUpdated` | `Account` | `AccountSubscriptionPlanUpdatedWebhookPayload` | | `AccountSubscriptionPaymentCollected` | `Account` | `AccountSubscriptionPaymentCollectedWebhookPayload` | | `AccountSubscriptionPaymentDeclined` | `Account` | `AccountSubscriptionPaymentDeclinedWebhookPayload` | | `AccountBillingInformationRequested` | `Account` | `AccountBillingInformationRequestedWebhookPayload` | | `AccountBillingInvoiceEmailSent` | `Invoice` | `AccountBillingInvoiceEmailSentWebhookPayload` | | `AccountRemovePerson` | `Account` | `AccountRemovePersonWebhookPayload` | | `AccountPaidSubscriptionCreated` | `Account` | `AccountPaidSubscriptionCreatedWebhookPayload` | | `AccountBillingInformationRemoved` | `Account` | `AccountBillingInformationRemovedWebhookPayload` | | `AccountPrimaryPersonUpdated` | `Account` | `AccountPrimaryPersonUpdatedWebhookPayload` | | `AccountBillingInvoiceCreated` | `Invoice` | `AccountBillingInvoiceCreatedWebhookPayload` | | `AccountSubscriptionStarted` | `Account` | `AccountSubscriptionStartedWebhookPayload` | | `AccountSubscriptionRenewalExtended` | `Account` | `AccountSubscriptionRenewalExtendedWebhookPayload` | | `AccountSubscriptionAddOnsChanged` | `Account` | `AccountSubscriptionAddOnsChangedWebhookPayload` | | `AccountSubscriptionCancellationRequested` | `Account` | `AccountSubscriptionCancellationRequestedWebhookPayload` | | `AccountBillingInvoiceDeleted` | `Invoice` | `AccountBillingInvoiceDeletedWebhookPayload` | | `AccountPersonRoleUpdated` | `Account` | `AccountPersonRoleUpdatedWebhookPayload` | | `PersonCreated` | `Person` | `PersonCreatedWebhookPayload` | | `PersonUpdated` | `Person` | `PersonUpdatedWebhookPayload` | | `PersonDeleted` | `Person` | `PersonDeletedWebhookPayload` | | `PersonLogin` | `Account` | `PersonLoginWebhookPayload` | | `PersonListSubscribed` | `Person` | `PersonListSubscribedWebhookPayload` | | `PersonListUnsubscribed` | `Person` | `PersonListUnsubscribedWebhookPayload` | | `PersonSegmentAdded` | `Person` | `PersonSegmentAddedWebhookPayload` | | `PersonSegmentRemoved` | `Person` | `PersonSegmentRemovedWebhookPayload` | | `PersonEmailOpened` | `Person` | `PersonEmailOpenedWebhookPayload` | | `PersonEmailClicked` | `Person` | `PersonEmailClickedWebhookPayload` | | `PersonEmailBounce` | `Person` | `PersonEmailBounceWebhookPayload` | | `PersonEmailSpam` | `Person` | `PersonEmailSpamWebhookPayload` | | `PersonSupportTicketCreated` | `Person` | `PersonSupportTicketCreatedWebhookPayload` | | `PersonSupportTicketUpdated` | `Person` | `PersonSupportTicketUpdatedWebhookPayload` | | `PersonLeadFormSubmitted` | `Person` | `PersonLeadFormSubmittedWebhookPayload` | | `PersonListConfirmed` | `Person` | `PersonListConfirmedWebhookPayload` | | `PersonEmailSubscribed` | `Person` | `PersonEmailSubscribedWebhookPayload` | | `PersonEmailUnsubscribed` | `Person` | `PersonEmailUnsubscribedWebhookPayload` | | `PersonTemporaryPasswordSet` | `Person` | `PersonTemporaryPasswordSetWebhookPayload` | | `PersonSupportTicketClosed` | `Person` | `PersonSupportTicketClosedWebhookPayload` | | `PersonTwoFactorRecoveryCodesRegenerated` | `Person` | `PersonTwoFactorRecoveryCodesRegeneratedWebhookPayload` | | `DealCreated` | `Deal` | `DealCreatedWebhookPayload` | | `DealUpdated` | `Deal` | `DealUpdatedWebhookPayload` | | `DealDeleted` | `Deal` | `DealDeletedWebhookPayload` | | `DealDueDate` | `Deal` | `DealDueDateWebhookPayload` | | `PlanCreated` | `Plan` | `PlanCreatedWebhookPayload` | | `PlanUpdated` | `Plan` | `PlanUpdatedWebhookPayload` | | `AddOnCreated` | `AddOn` | `AddOnCreatedWebhookPayload` | | `AddOnUpdated` | `AddOn` | `AddOnUpdatedWebhookPayload` | | `DiscordUserLinked` | `Person` | `DiscordUserLinkedWebhookPayload` | | `DiscordUserAddedToServer` | `Person` | `DiscordUserAddedToServerWebhookPayload` | | `DiscordUserRolesUpdated` | `Person` | `DiscordUserRolesUpdatedWebhookPayload` | | `DiscordUserRemovedFromServer` | `Person` | `DiscordUserRemovedFromServerWebhookPayload` | `TaskCreated` and `TaskUpdated` are not listed above because their payload is polymorphic: the webhook is rooted on the entity the task is associated with (an `Account`, `Person`, or `Deal`), with the task itself carried in the `ActivityEventData` property. Because the root entity varies per task, they do not have a single fixed payload schema. version: v1 servers: - url: https://{subdomain}.outseta.com description: Your Outseta account variables: subdomain: default: your-subdomain description: >- Your Outseta account subdomain — the part before ".outseta.com" in your admin URL. security: [] paths: /api/v1/billing/subscriptions/{subscriptionUid}/changesubscription: put: tags: - Billing summary: Change a subscription on an account. description: Returns an invoice object with information about the amount outstanding. operationId: Subscription_ChangeSubscription parameters: - name: subscriptionUid in: path required: true description: The subscription's unique identifier schema: type: string nullable: true x-position: 1 - name: startImmediately in: query description: If true, the subscription change takes effect immediately schema: type: string nullable: true x-position: 3 requestBody: x-name: newSubscription description: The new subscription details content: application/json: schema: nullable: true oneOf: - $ref: '#/components/schemas/Subscription' x-position: 2 responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/Subscription' '400': description: Invalid Uid format '401': description: Unauthorized '404': description: Subscription not found security: - Bearer: [] - ApiKey: [] components: schemas: Subscription: example: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} BillingRenewalTerm: 1 Account: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} SchemaLessData: {} StripeId: string IsLivemode: false Name: string ClientIdentifier: string Currency: string InvoiceNotes: string IsDemo: false BillingAddress: {} MailingAddress: {} AccountStage: 2 PaymentInformation: {} PersonAccount: [] StripeDefaultPaymentMethodId: string StripeInvoices: [] StripePaymentMethods: [] StripeSubscriptions: [] Subscriptions: [] Deals: [] LastLoginDateTime: string AccountSpecificPageUrl1: string AccountSpecificPageUrl2: string AccountSpecificPageUrl3: string AccountSpecificPageUrl4: string AccountSpecificPageUrl5: string AccountSpecificPageUrl6: string AccountSpecificPageUrl7: string AccountSpecificPageUrl8: string AccountSpecificPageUrl9: string AccountSpecificPageUrl10: string RewardFulReferralId: string ToltReferralId: string TaxIds: [] TaxStatus: string AccountStageLabel: string CurrentStripeProducts: string CurrentSubscription: {} DomainName: string HasLoggedIn: false LatestSubscription: {} LifetimeRevenue: 0 NextStripeInvoiceDate: string Nonce: string PrimaryContact: {} PrimarySubscription: {} PrimaryStripeSubscription: {} RecaptchaToken: string StripeNextInvoiceSequence: 0 StripePrice: [] StripePromotionCode: string TaxId: string TaxIdIsInvalid: false TaxIdType: string WebflowSlug: string Plan: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} Name: string Description: string PlanFamily: {} AccountRegistrationMode: 1 IsQuantityEditable: false MinimumQuantity: 0 MaximumPeople: 0 MonthlyRate: 0 AnnualRate: 0 QuarterlyRate: 0 OneTimeRate: 0 SetupFee: 0 SkipSetupFeeOnPlanChange: false IsTaxable: false IsActive: false IsPerUser: false RequirePaymentInformation: false TrialPeriodDays: 0 TrialUntilDate: string ExpiresAfterMonths: 0 ExpirationDate: string PostLoginPath: string StripeTaxCodeId: string UnitOfMeasure: string PlanAddOns: [] ContentGroups: [] NumberOfSubscriptions: 0 Quantity: 0 StartDate: string EndDate: string ExpirationDate: string RenewalDate: string NewRequiredQuantity: 0 IsPlanUpgradeRequired: false PlanUpgradeRequiredMessage: string SubscriptionAddOns: - Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} BillingRenewalTerm: 1 Subscription: {} AddOn: {} Quantity: 0 StartDate: string EndDate: string ExpirationDate: string RenewalDate: string NewRequiredQuantity: 0 Rate: 0 DiscountCouponSubscriptions: - Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} RedeemedDate: string ExpireDate: string Subscription: {} DiscountCoupon: {} DiscountCode: string DiscountCouponExpirationDate: string LatestInvoice: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} InvoiceDate: string PaymentReminderSentDate: string Number: 0 BillingInvoiceStatus: 1 Subscription: {} Amount: 0 AmountOutstanding: 0 InvoiceLineItems: [] IsUserGenerated: false StripeTaxCalculationId: string StripeTaxBehavior: string AmountCredit: 0 AmountDiscount: 0 AmountPaid: 0 AmountRefunded: 0 AmountSubtotal: 0 AmountTax: 0 AmountTaxRefunded: 0 IsTaxable: false HasPaymentGatewayTransactions: false StripePaymentTransactionIds: string StripeRefundTransactionIds: string StripeTaxRefundTransactionIds: string Rate: 0 allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false properties: BillingRenewalTerm: maximum: 4 minimum: 1 oneOf: - $ref: '#/components/schemas/BillingRenewalTerm' Account: nullable: true oneOf: - type: object title: Account description: Circular reference to Account (not expanded here). Plan: nullable: true oneOf: - $ref: '#/components/schemas/Plan' Quantity: type: integer format: int32 nullable: true StartDate: type: string format: date-time EndDate: type: string format: date-time nullable: true ExpirationDate: type: string format: date-time nullable: true RenewalDate: type: string format: date-time nullable: true NewRequiredQuantity: type: integer format: int32 nullable: true IsPlanUpgradeRequired: type: boolean PlanUpgradeRequiredMessage: type: string nullable: true SubscriptionAddOns: type: array nullable: true items: $ref: '#/components/schemas/SubscriptionAddOn' DiscountCouponSubscriptions: type: array nullable: true items: $ref: '#/components/schemas/DiscountCouponSubscription' DiscountCode: type: string nullable: true DiscountCouponExpirationDate: type: string format: date-time nullable: true LatestInvoice: nullable: true oneOf: - $ref: '#/components/schemas/Invoice' Rate: type: number format: decimal nullable: true AbstractQcountBean: allOf: - $ref: '#/components/schemas/AbstractBean' - type: object additionalProperties: false required: - Qcount_Id properties: ActivityEventData: nullable: true BillingRenewalTerm: type: integer description: '`1` - Monthly, `2` - Yearly, `3` - Quarterly, `4` - One Time' x-enumNames: - Monthly - Yearly - Quarterly - OneTime x-enum-descriptions: - '' - '' - '' - One Time enum: - 1 - 2 - 3 - 4 Plan: example: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} Name: string Description: string PlanFamily: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} SchemaLessData: {} Name: string IsActive: false IsDefault: false Plans: [] AccountRegistrationMode: 1 IsQuantityEditable: false MinimumQuantity: 0 MaximumPeople: 0 MonthlyRate: 0 AnnualRate: 0 QuarterlyRate: 0 OneTimeRate: 0 SetupFee: 0 SkipSetupFeeOnPlanChange: false IsTaxable: false IsActive: false IsPerUser: false RequirePaymentInformation: false TrialPeriodDays: 0 TrialUntilDate: string ExpiresAfterMonths: 0 ExpirationDate: string PostLoginPath: string StripeTaxCodeId: string UnitOfMeasure: string PlanAddOns: - Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} Plan: {} AddOn: {} IsUserSelectable: false ContentGroups: - Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} Name: string AccessDeniedPath: string ContentGroupItems: [] AllowedPlans: [] AllowedProducts: [] AllowedAddOns: [] NumberOfSubscriptions: 0 allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false required: - IsQuantityEditable - IsTaxable properties: Name: type: string maxLength: 250 nullable: true Description: type: string nullable: true PlanFamily: nullable: true oneOf: - $ref: '#/components/schemas/PlanFamily' AccountRegistrationMode: $ref: '#/components/schemas/AccountRegistrationMode' IsQuantityEditable: type: boolean MinimumQuantity: type: integer format: int32 MaximumPeople: type: integer format: int32 nullable: true MonthlyRate: type: number format: decimal AnnualRate: type: number format: decimal QuarterlyRate: type: number format: decimal OneTimeRate: type: number format: decimal SetupFee: type: number format: decimal SkipSetupFeeOnPlanChange: type: boolean IsTaxable: type: boolean IsActive: type: boolean IsPerUser: type: boolean RequirePaymentInformation: type: boolean TrialPeriodDays: type: integer format: int32 TrialUntilDate: type: string format: date-time nullable: true ExpiresAfterMonths: type: integer format: int32 ExpirationDate: type: string format: date-time nullable: true PostLoginPath: type: string maxLength: 250 nullable: true StripeTaxCodeId: type: string maxLength: 15 nullable: true UnitOfMeasure: type: string maxLength: 250 nullable: true PlanAddOns: type: array nullable: true items: $ref: '#/components/schemas/PlanAddOn' ContentGroups: type: array nullable: true items: type: object title: ContentGroup description: Circular reference to ContentGroup (not expanded here). NumberOfSubscriptions: type: integer format: int32 nullable: true SubscriptionAddOn: example: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} BillingRenewalTerm: 1 Subscription: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} BillingRenewalTerm: 1 Account: {} Plan: {} Quantity: 0 StartDate: string EndDate: string ExpirationDate: string RenewalDate: string NewRequiredQuantity: 0 IsPlanUpgradeRequired: false PlanUpgradeRequiredMessage: string SubscriptionAddOns: [] DiscountCouponSubscriptions: [] DiscountCode: string DiscountCouponExpirationDate: string LatestInvoice: {} Rate: 0 AddOn: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} Name: string BillingAddOnType: 1 IsQuantityEditable: false MinimumQuantity: 0 MonthlyRate: 0 AnnualRate: 0 SetupFee: 0 UnitOfMeasure: string IsTaxable: false IsBilledDuringTrial: false ExpiresAfterMonths: 0 ExpirationDate: string StripeTaxCodeId: string PlanAddOns: [] ContentGroups: [] IsPerUser: false QuarterlyRate: 0 OneTimeRate: 0 SubscriptionCount: 0 Quantity: 0 Quantity: 0 StartDate: string EndDate: string ExpirationDate: string RenewalDate: string NewRequiredQuantity: 0 Rate: 0 allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false properties: BillingRenewalTerm: maximum: 4 minimum: 1 oneOf: - $ref: '#/components/schemas/BillingRenewalTerm' Subscription: nullable: true oneOf: - type: object title: Subscription description: Circular reference to Subscription (not expanded here). AddOn: nullable: true oneOf: - $ref: '#/components/schemas/AddOn' Quantity: type: integer format: int32 nullable: true StartDate: type: string format: date-time EndDate: type: string format: date-time nullable: true ExpirationDate: type: string format: date-time nullable: true RenewalDate: type: string format: date-time nullable: true NewRequiredQuantity: type: integer format: int32 nullable: true Rate: type: number format: decimal nullable: true DiscountCouponSubscription: allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false properties: RedeemedDate: type: string format: date-time nullable: true ExpireDate: type: string format: date-time nullable: true Subscription: nullable: true oneOf: - type: object title: Subscription description: Circular reference to Subscription (not expanded here). DiscountCoupon: nullable: true oneOf: - $ref: '#/components/schemas/DiscountCoupon' Invoice: example: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} InvoiceDate: string PaymentReminderSentDate: string Number: 0 BillingInvoiceStatus: 1 Subscription: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} BillingRenewalTerm: 1 Account: {} Plan: {} Quantity: 0 StartDate: string EndDate: string ExpirationDate: string RenewalDate: string NewRequiredQuantity: 0 IsPlanUpgradeRequired: false PlanUpgradeRequiredMessage: string SubscriptionAddOns: [] DiscountCouponSubscriptions: [] DiscountCode: string DiscountCouponExpirationDate: string LatestInvoice: {} Rate: 0 Amount: 0 AmountOutstanding: 0 InvoiceLineItems: - Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} StartDate: string EndDate: string Description: string UnitOfMeasure: string Quantity: 0 Rate: 0 Amount: 0 Tax: 0 Invoice: {} LineItemType: 1 EntityId: 0 StripeTaxReference: string StripeTaxLineItemId: string EntityUid: string IsUserGenerated: false StripeTaxCalculationId: string StripeTaxBehavior: string AmountCredit: 0 AmountDiscount: 0 AmountPaid: 0 AmountRefunded: 0 AmountSubtotal: 0 AmountTax: 0 AmountTaxRefunded: 0 IsTaxable: false HasPaymentGatewayTransactions: false StripePaymentTransactionIds: string StripeRefundTransactionIds: string StripeTaxRefundTransactionIds: string allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false properties: InvoiceDate: type: string format: date-time PaymentReminderSentDate: type: string format: date-time nullable: true Number: type: integer format: int32 BillingInvoiceStatus: $ref: '#/components/schemas/BillingInvoiceStatus' Subscription: nullable: true oneOf: - type: object title: Subscription description: Circular reference to Subscription (not expanded here). Amount: type: number format: decimal AmountOutstanding: type: number format: decimal InvoiceLineItems: type: array nullable: true items: $ref: '#/components/schemas/InvoiceLineItem' IsUserGenerated: type: boolean StripeTaxCalculationId: type: string maxLength: 50 nullable: true StripeTaxBehavior: type: string maxLength: 10 nullable: true AmountCredit: type: number format: decimal AmountDiscount: type: number format: decimal AmountPaid: type: number format: decimal AmountRefunded: type: number format: decimal AmountSubtotal: type: number format: decimal AmountTax: type: number format: decimal AmountTaxRefunded: type: number format: decimal IsTaxable: type: boolean HasPaymentGatewayTransactions: type: boolean StripePaymentTransactionIds: type: string nullable: true StripeRefundTransactionIds: type: string nullable: true StripeTaxRefundTransactionIds: type: string nullable: true AbstractBean: type: object x-abstract: true additionalProperties: false required: - Id - Created - CreatedByUser_Id - Updated - UpdatedByUser_Id properties: Uid: type: string maxLength: 10 nullable: true _objectType: type: string nullable: true Created: type: string readOnly: true format: date-time minLength: 1 Updated: type: string readOnly: true format: date-time minLength: 1 PlanFamily: example: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} SchemaLessData: {} Name: string IsActive: false IsDefault: false Plans: - Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} Name: string Description: string PlanFamily: {} AccountRegistrationMode: 1 IsQuantityEditable: false MinimumQuantity: 0 MaximumPeople: 0 MonthlyRate: 0 AnnualRate: 0 QuarterlyRate: 0 OneTimeRate: 0 SetupFee: 0 SkipSetupFeeOnPlanChange: false IsTaxable: false IsActive: false IsPerUser: false RequirePaymentInformation: false TrialPeriodDays: 0 TrialUntilDate: string ExpiresAfterMonths: 0 ExpirationDate: string PostLoginPath: string StripeTaxCodeId: string UnitOfMeasure: string PlanAddOns: [] ContentGroups: [] NumberOfSubscriptions: 0 allOf: - $ref: '#/components/schemas/AbstractSchemaLessBean' - type: object additionalProperties: nullable: true properties: Name: type: string maxLength: 250 nullable: true IsActive: type: boolean IsDefault: type: boolean Plans: type: array nullable: true items: type: object title: Plan description: Circular reference to Plan (not expanded here). AccountRegistrationMode: type: integer description: '`1` - Individual, `2` - Team' x-enumNames: - Individual - Team x-enum-descriptions: - '' - '' enum: - 1 - 2 PlanAddOn: allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false required: - IsUserSelectable properties: Plan: nullable: true oneOf: - type: object title: Plan description: Circular reference to Plan (not expanded here). AddOn: nullable: true oneOf: - $ref: '#/components/schemas/AddOn' IsUserSelectable: type: boolean AddOn: allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false required: - IsQuantityEditable - IsTaxable - IsBilledDuringTrial properties: Name: type: string maxLength: 250 nullable: true BillingAddOnType: maximum: 3 minimum: 1 oneOf: - $ref: '#/components/schemas/BillingAddOnType' IsQuantityEditable: type: boolean MinimumQuantity: type: integer format: int32 MonthlyRate: type: number format: decimal AnnualRate: type: number format: decimal SetupFee: type: number format: decimal UnitOfMeasure: type: string maxLength: 250 nullable: true IsTaxable: type: boolean IsBilledDuringTrial: type: boolean ExpiresAfterMonths: type: integer format: int32 ExpirationDate: type: string format: date-time nullable: true StripeTaxCodeId: type: string maxLength: 15 nullable: true PlanAddOns: type: array nullable: true items: type: object title: PlanAddOn description: Circular reference to PlanAddOn (not expanded here). ContentGroups: type: array nullable: true items: type: object title: ContentGroup description: Circular reference to ContentGroup (not expanded here). IsPerUser: type: boolean QuarterlyRate: type: number format: decimal OneTimeRate: type: number format: decimal SubscriptionCount: type: integer format: int32 Quantity: type: integer format: int32 DiscountCoupon: example: Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} UniqueIdentifier: string Name: string IsActive: false AmountOff: 0 PercentOff: 0 RedeemBy: string Duration: 1 DurationInMonths: 0 TimesRedeemed: 0 MaxRedemptions: 0 DiscountCouponPlans: - Uid: string _objectType: string Created: string Updated: string ActivityEventData: {} Plan: {} DiscountCoupon: {} ApplyToAddOns: false PlanUids: string allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false properties: UniqueIdentifier: type: string nullable: true Name: type: string nullable: true IsActive: type: boolean AmountOff: type: number format: decimal nullable: true PercentOff: type: number format: decimal nullable: true RedeemBy: type: string format: date-time nullable: true Duration: maximum: 3 minimum: 1 oneOf: - $ref: '#/components/schemas/BillingDiscountDuration' DurationInMonths: type: integer format: int32 nullable: true TimesRedeemed: type: integer format: int32 MaxRedemptions: type: integer format: int32 nullable: true DiscountCouponPlans: type: array nullable: true items: $ref: '#/components/schemas/DiscountCouponPlan' ApplyToAddOns: type: boolean PlanUids: type: string nullable: true BillingInvoiceStatus: type: integer description: >- `1` - Unpaid, `2` - Paid, `3` - Partial, `4` - Uncollected, `5` - Refunded, `6` - Uncollectible, `7` - Processing x-enumNames: - Unpaid - Paid - Partial - Uncollected - Refunded - Uncollectible - Processing x-enum-descriptions: - '' - '' - '' - '' - '' - '' - '' enum: - 1 - 2 - 3 - 4 - 5 - 6 - 7 InvoiceLineItem: allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false properties: StartDate: type: string format: date-time nullable: true EndDate: type: string format: date-time nullable: true Description: type: string nullable: true UnitOfMeasure: type: string maxLength: 250 nullable: true Quantity: type: number format: decimal nullable: true Rate: type: number format: decimal Amount: type: number format: decimal Tax: type: number format: decimal Invoice: nullable: true oneOf: - type: object title: Invoice description: Circular reference to Invoice (not expanded here). LineItemType: nullable: true oneOf: - $ref: '#/components/schemas/LineItemType' EntityId: type: integer format: int64 nullable: true StripeTaxReference: type: string maxLength: 10 nullable: true StripeTaxLineItemId: type: string maxLength: 50 nullable: true EntityUid: type: string nullable: true AbstractSchemaLessBean: allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object x-abstract: true additionalProperties: nullable: true properties: SchemaLessData: type: object nullable: true additionalProperties: {} BillingAddOnType: type: integer description: '`1` - Recurring, `2` - Usage, `3` - OneTime' x-enumNames: - Recurring - Usage - OneTime x-enum-descriptions: - '' - '' - '' enum: - 1 - 2 - 3 BillingDiscountDuration: type: integer description: '`1` - Forever, `2` - Once, `3` - Repeating' x-enumNames: - Forever - Once - Repeating x-enum-descriptions: - '' - '' - '' enum: - 1 - 2 - 3 DiscountCouponPlan: allOf: - $ref: '#/components/schemas/AbstractQcountBean' - type: object additionalProperties: false properties: Plan: nullable: true oneOf: - $ref: '#/components/schemas/Plan' DiscountCoupon: nullable: true oneOf: - type: object title: DiscountCoupon description: Circular reference to DiscountCoupon (not expanded here). LineItemType: type: integer description: >- `1` - Plan, `2` - PlanSetupFee, `3` - AddOn, `4` - AddOnSetupFee, `5` - Discount, `6` - Credit, `7` - PlanCredit, `8` - AddOnCredit x-enumNames: - Plan - PlanSetupFee - AddOn - AddOnSetupFee - Discount - Credit - PlanCredit - AddOnCredit x-enum-descriptions: - '' - '' - '' - '' - '' - '' - '' - '' enum: - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 securitySchemes: Bearer: type: http description: Enter your access token (OAuth / JWT). scheme: bearer bearerFormat: JWT ApiKey: type: apiKey description: 'Enter: Outseta {api_key}:{api_secret}' name: Authorization in: header ````