> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gigstack.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Turn a feature off for a team (pricing v3)

> Pricing v3 accounts only (409 features_v3_only), for a feature turned on from the app (409 feature_not_subscribed otherwise). Takes the team's seat off the usage subscription now, without proration: nothing is refunded and nothing more is charged. The feature stays on until the next cut, which the period already billed covers (`result.kind: feature_off`, `result.ends_at`), and gigstack turns it off then. Turning it on again before that only puts the seat back. Repeating it returns the same end. A feature turned on free is off at once (`result.ends_at: null`). Requires a billing-account administrator.



## OpenAPI

````yaml openapi.json POST /teams/{id}/billing/features/deactivate
openapi: 3.0.3
info:
  title: gigstack API v2
  description: >
    # gigstack API v2


    Build customer, invoice and payment integrations. Start with the
    [quickstart](https://docs.gigstack.io/quickstart), then select the [issuing
    country](https://docs.gigstack.io/concepts/shared-fields).


    ## Authentication and environments


    Use Authorization: Bearer YOUR_API_KEY. Standard live and test keys use
    https://api.gigstack.io/v2. Internal staging uses
    https://gigstack-staging-9z9nnaat.uc.gateway.dev/v2 and separate keys. Test
    mode is a data mode within an environment; a body field does not switch a
    key's mode.


    See [authentication](https://docs.gigstack.io/authentication) for key
    handling, OAuth team scope and gigstack Connect. Internal partner
    provisioning is outside this public contract; health probes have their own
    security declarations. Operations marked unavailable have no configured
    public gateway route.


    ## Read the operation contract


    Response envelopes, pagination and retry rules differ by endpoint. HTTP
    success alone does not prove external fiscal completion or movement of
    money. Reconcile ambiguous writes before retrying. Use [responses and
    recovery](https://docs.gigstack.io/responses) and the operation's error
    codes; document credits and daily limits are not generic retryable rate
    limits.


    The issuing team's configuration selects Mexico or Colombia; customer
    country and currency do not. Read
    [Mexico](https://docs.gigstack.io/countries/mexico) or
    [Colombia](https://docs.gigstack.io/countries/colombia) before choosing
    fiscal fields. Accepted public input differs from a provider's direct
    payload.


    Examples and schema checks do not imply every operation has been executed
    live. [Verification coverage](https://docs.gigstack.io/verification)
    distinguishes source review, offline checks and observed staging behavior.
    Documentation describes operations and does not authorize execution.
  version: 2.0.0
  contact:
    name: Gigstack API Support
    url: https://gigstack.io
    email: support@gigstack.io
  license:
    name: Proprietary
    url: https://gigstack.io/terms
  termsOfService: https://gigstack.io/terms
servers:
  - url: https://api.gigstack.io/v2
    description: >
      Public API for standard live and test-mode keys. Test data is isolated by
      the key mode

      (`livemode: false`). Internal staging is a separate deployment and key
      store; see

      https://docs.gigstack.io/authentication#environments for its base URL.
security:
  - bearerAuth: []
externalDocs:
  description: Complete API Documentation & Guides
  url: https://docs.gigstack.io
paths:
  /teams/{id}/billing/features/deactivate:
    post:
      tags:
        - Account Billing
      summary: Turn a feature off for a team (pricing v3)
      description: >-
        Pricing v3 accounts only (409 features_v3_only), for a feature turned on
        from the app (409 feature_not_subscribed otherwise). Takes the team's
        seat off the usage subscription now, without proration: nothing is
        refunded and nothing more is charged. The feature stays on until the
        next cut, which the period already billed covers (`result.kind:
        feature_off`, `result.ends_at`), and gigstack turns it off then. Turning
        it on again before that only puts the seat back. Repeating it returns
        the same end. A feature turned on free is off at once (`result.ends_at:
        null`). Requires a billing-account administrator.
      operationId: accountBillingFeatureDeactivate
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountBillingFeatureActivateInput'
      responses:
        '200':
          description: Inspect the returned state before reporting completion.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - success
                  - data
                  - timestamp
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/AccountBillingOperation'
                  timestamp:
                    type: number
              examples:
                unknown:
                  value:
                    success: true
                    data:
                      id: c03839fa-20e3-4b56-86ba-d41d92e67f19
                      team_id: team_example
                      billing_account_id: account_example
                      effect_scope: billing_account_shared
                      provider_environment: sandbox
                      action: checkout
                      status: outcome_unknown
                      created_at: 1791500000000
                      updated_at: 1791500000000
                      recovery_available_at: 1791500600000
                      result: null
                      error:
                        code: billing_result_unconfirmed
                        message: Read the original operation before retrying
                        retryable: false
                      resolution: null
                    timestamp: 1791500000000
        '400':
          description: Invalid body, cursor or fiscal fields.
        '401':
          description: Verified Firebase or personal MCP identity required.
        '403':
          description: Current membership or billing administrator authority required.
        '404':
          description: Team, plan, or operation not found in scope.
        '409':
          description: >-
            Account lock, changed operation parameters, ambiguous customer or
            incompatible plan state. Read current state before deciding the next
            action.
        '502':
          description: >-
            Billing result unconfirmed or upstream unavailable. Read the
            original operation ID before retrying.
        '503':
          description: >-
            Runtime project, application origin or internal service
            authorization is not configured.
      security:
        - bearerAuth: []
components:
  schemas:
    AccountBillingFeatureActivateInput:
      type: object
      properties:
        operation_id:
          type: string
          pattern: >-
            ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4[a-fA-F0-9]{3}-[89abAB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}$
        feature:
          type: string
          pattern: ^[A-Za-z0-9_-]{1,160}$
          example: self_invoice_portal
          description: Catalog key of a paid team feature, e.g. `self_invoice_portal`.
      required:
        - operation_id
        - feature
      additionalProperties: false
    AccountBillingOperation:
      type: object
      additionalProperties: false
      required:
        - id
        - team_id
        - billing_account_id
        - effect_scope
        - provider_environment
        - action
        - status
        - created_at
        - updated_at
        - recovery_available_at
        - result
        - error
        - resolution
      properties:
        id:
          type: string
        team_id:
          type: string
        billing_account_id:
          type: string
        effect_scope:
          type: string
          enum:
            - billing_account_shared
        provider_environment:
          type: string
          enum:
            - sandbox
            - production
        action:
          type: string
          enum:
            - checkout
            - checkout.cancel
            - upgrade
            - portal
            - fiscal.update
        status:
          type: string
          enum:
            - processing
            - handoff_ready
            - completed
            - failed
            - outcome_unknown
            - cancelled
        created_at:
          type: number
        updated_at:
          type: number
        recovery_available_at:
          type: number
        result:
          oneOf:
            - type: object
              nullable: true
              enum:
                - null
            - type: object
              additionalProperties: false
              required:
                - kind
                - checkout_operation_id
                - session_id
                - status
              properties:
                kind:
                  type: string
                  enum:
                    - checkout_cancellation
                checkout_operation_id:
                  type: string
                session_id:
                  type: string
                status:
                  type: string
                  enum:
                    - expired
                    - complete
            - type: object
              additionalProperties: false
              required:
                - kind
                - plan_id
              properties:
                kind:
                  type: string
                  enum:
                    - free_plan
                plan_id:
                  type: string
            - type: object
              additionalProperties: false
              required:
                - kind
                - session_id
                - url
                - expires_at
              properties:
                kind:
                  type: string
                  enum:
                    - checkout
                session_id:
                  type: string
                url:
                  type: string
                  nullable: true
                expires_at:
                  type: number
                  nullable: true
            - type: object
              additionalProperties: false
              required:
                - kind
                - intent
                - url
                - expires_at
              properties:
                kind:
                  type: string
                  enum:
                    - portal
                intent:
                  type: string
                  enum:
                    - manage
                    - cancel_subscription
                    - update_payment_method
                url:
                  type: string
                expires_at:
                  type: number
                  nullable: true
                  enum:
                    - null
            - type: object
              additionalProperties: false
              required:
                - kind
                - subscription
              properties:
                kind:
                  type: string
                  enum:
                    - subscription
                subscription:
                  $ref: '#/components/schemas/AccountBillingSubscription'
            - type: object
              additionalProperties: false
              required:
                - kind
                - fiscal
              properties:
                kind:
                  type: string
                  enum:
                    - fiscal
                fiscal:
                  $ref: '#/components/schemas/AccountBillingFiscal'
        error:
          type: object
          additionalProperties: false
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
          required:
            - code
            - message
            - retryable
          nullable: true
        resolution:
          type: object
          additionalProperties: false
          required:
            - action
            - resolved_at
          properties:
            action:
              type: string
              enum:
                - released_for_new_operation
            resolved_at:
              type: number
          nullable: true
    AccountBillingSubscription:
      type: object
      additionalProperties: false
      required:
        - id
        - status
        - plan_id
        - billing_cycle
        - currency
        - current_period_start
        - current_period_end
        - cancel_at
        - trial_end
        - cancel_at_period_end
        - items
      properties:
        id:
          type: string
        status:
          type: string
        plan_id:
          type: string
          nullable: true
        billing_cycle:
          type: string
          nullable: true
        currency:
          type: string
          nullable: true
        current_period_start:
          type: number
          nullable: true
        current_period_end:
          type: number
          nullable: true
        cancel_at:
          type: number
          nullable: true
        trial_end:
          type: number
          nullable: true
        cancel_at_period_end:
          type: boolean
        items:
          type: array
          description: >-
            What the subscription charges. Pricing v3 accounts carry the fixed
            RFC fee (lookup key v3_mx_taxpayer_fee) and the metered credits
            (v3_mx_credit). Amounts are minor units before tax; a metered item
            has no quantity.
          items:
            type: object
            additionalProperties: false
            required:
              - id
              - price_id
              - lookup_key
              - unit_amount
              - quantity
              - interval
              - usage_type
              - current_period_end
            properties:
              id:
                type: string
              price_id:
                type: string
                nullable: true
              lookup_key:
                type: string
                nullable: true
              unit_amount:
                type: number
                nullable: true
              quantity:
                type: number
                nullable: true
              interval:
                type: string
                nullable: true
              usage_type:
                type: string
                nullable: true
              current_period_end:
                type: number
                nullable: true
    AccountBillingFiscal:
      type: object
      additionalProperties: false
      required:
        - team_id
        - billing_account_id
        - effect_scope
        - provider_environment
        - exists
        - editable
        - source
        - customer_id
        - fiscal
        - warnings
        - stripe_synced
      properties:
        team_id:
          type: string
        billing_account_id:
          type: string
        effect_scope:
          type: string
          enum:
            - billing_account_shared
        provider_environment:
          type: string
          enum:
            - sandbox
            - production
        exists:
          type: boolean
        editable:
          type: boolean
        source:
          type: string
          enum:
            - client
            - seed
        customer_id:
          type: string
          nullable: true
        fiscal:
          type: object
          additionalProperties: false
          required:
            - legal_name
            - rfc
            - tax_system
            - use
            - email
            - phone
            - address
          properties:
            legal_name:
              type: string
              nullable: true
            rfc:
              type: string
              nullable: true
            tax_system:
              type: string
              nullable: true
            use:
              type: string
              nullable: true
            email:
              type: string
              nullable: true
            phone:
              type: string
              nullable: true
            address:
              type: object
              additionalProperties: false
              required:
                - zip
                - street
                - exterior
                - interior
                - neighborhood
                - municipality
                - city
                - state
                - country
              properties:
                zip:
                  type: string
                  nullable: true
                street:
                  type: string
                  nullable: true
                exterior:
                  type: string
                  nullable: true
                interior:
                  type: string
                  nullable: true
                neighborhood:
                  type: string
                  nullable: true
                municipality:
                  type: string
                  nullable: true
                city:
                  type: string
                  nullable: true
                state:
                  type: string
                  nullable: true
                country:
                  type: string
                  nullable: true
        warnings:
          type: array
          items:
            type: string
        stripe_synced:
          type: boolean
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        **Authentication Method:** HTTP Bearer token.


        The runtime requires the literal `Bearer ` prefix — a bare token in the

        `Authorization` header is rejected with `401 unauthorized`.


        **Header Format:** `Authorization: Bearer YOUR_API_KEY`


        Your API key is a JWT. Live keys operate on live data (`livemode:
        true`);

        test keys operate on isolated test data (`livemode: false`).


        **Get your key at:**
        [app.gigstack.pro/settings?tab=api](https://app.gigstack.pro/settings?tab=api)


        **Errors:** credential failures are answered by the authentication layer
        with a raw

        `{ "message": … }` body, not the standardized envelope — `401` for a
        missing, malformed or

        expired token, `403` for a revoked key or a plan without API access. See
        the `Unauthorized`

        and `AuthForbidden` responses.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.