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

# Set the workspace's default agent billing plan

> Marks one plan as the workspace default, replacing whichever held the marker before — one marker per workspace, which is why this is a PUT on a singleton rather than a per-plan flag. Changes nothing for already-attached customers; it only decides what apply-default-plan applies. Deleting the marked plan clears the marker with it.



## OpenAPI

````yaml put /v1/ai/billing/default-plan
openapi: 3.1.0
info:
  title: Hyperline API
  version: 0.0.0
servers:
  - url: https://api.hyperline.co
  - url: https://sandbox.api.hyperline.co
security: []
paths:
  /v1/ai/billing/default-plan:
    put:
      tags:
        - AI > Billing
      summary: Set the workspace's default agent billing plan
      description: >-
        Marks one plan as the workspace default, replacing whichever held the
        marker before — one marker per workspace, which is why this is a PUT on
        a singleton rather than a per-plan flag. Changes nothing for
        already-attached customers; it only decides what apply-default-plan
        applies. Deleting the marked plan clears the marker with it.
      operationId: setAgentDefaultPlan
      requestBody:
        description: Which plan holds the default marker
        content:
          application/json:
            schema:
              type: object
              properties:
                plan_id:
                  type: string
                  minLength: 1
                  description: >-
                    Billing plan reference. On policy writes, omission preserves
                    the current plan and null detaches it.
                  example: aiplan_example
                auto_apply:
                  type: boolean
                  description: >-
                    Whether eligible newly ingested customers receive the
                    default plan automatically.
                  example: false
              required:
                - plan_id
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  plan_id:
                    type: string
                    description: >-
                      Billing plan reference. On policy writes, omission
                      preserves the current plan and null detaches it.
                    example: aiplan_example
                  auto_apply:
                    type: boolean
                    description: >-
                      Whether eligible newly ingested customers receive the
                      default plan automatically.
                    example: false
                required:
                  - plan_id
                  - auto_apply
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '404':
          description: Plan not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '409':
          description: The request conflicts with the current configuration.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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