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

# Update pricing plan

> Update pricing plan. See the request and response schemas for the complete public API contract. This operation can change workspace data or trigger an external side effect; review the request before sending it and do not retry blindly after a timeout.



## OpenAPI

````yaml /openapi.json patch /api/v1/public/partner/billing/plans/{plan_id}
openapi: 3.1.0
info:
  description: >-
    Customer-facing API for managing outreach, leads, conversations, voice
    agents, knowledge bases, analytics, and webhooks.
  title: Sendora Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.sendora.ai
security: []
tags:
  - description: Build, launch, pause and stop campaigns, and enroll leads.
    name: Campaigns
  - description: Create, update, tag, enrich and import leads.
    name: Leads
  - description: Group leads into reusable lists.
    name: Lead lists
  - description: Find new prospects and research existing leads.
    name: Prospecting
  - description: Read conversations and send messages to leads.
    name: Inbox
  - description: Manage workspace-wide suppressions.
    name: Do not contact
  - description: Manage the content your agents answer from.
    name: Knowledge bases
  - description: Create, configure, test and publish voice agents.
    name: Voice agents
  - description: Give agents actions such as booking, lookups and transfers.
    name: Agent tools
  - description: Embed a voice agent on your website.
    name: Voice widgets
  - description: Start voice calls and read call results.
    name: Calls
  - description: Browse and preview the voices an agent can use.
    name: Voices
  - description: List numbers, bring your own, and route calls.
    name: Phone numbers
  - description: List the channel accounts connected to the workspace.
    name: Connected accounts
  - description: Register endpoints and review deliveries.
    name: Webhooks
  - description: Drive the workspace assistant programmatically.
    name: Copilot
  - description: Read workspace and campaign performance.
    name: Analytics
  - description: Track asynchronous operations.
    name: Jobs
  - description: Manage client workspaces, plans and branding.
    name: Agency
paths:
  /api/v1/public/partner/billing/plans/{plan_id}:
    patch:
      tags:
        - Agency
      summary: Update pricing plan
      description: >-
        Update pricing plan. See the request and response schemas for the
        complete public API contract. This operation can change workspace data
        or trigger an external side effect; review the request before sending it
        and do not retry blindly after a timeout.
      operationId: >-
        public_partner_update_plan_api_v1_public_partner_billing_plans__plan_id__patch
      parameters:
        - description: 'The pricing plan''s id: the `id` from List pricing plans.'
          in: path
          name: plan_id
          required: true
          schema:
            title: Plan Id
            type: string
        - in: header
          name: X-API-Key
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
        - in: header
          name: Authorization
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/api__v1__partner__schemas__AgencyPlanUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api__v1__partner__schemas__AgencyPlanOut'
          description: Successful Response
        '401':
          description: The X-API-Key header is missing, invalid, expired, or revoked.
        '402':
          description: >-
            The workspace is suspended for billing, or the request would exceed
            a plan or usage limit.
        '403':
          description: >-
            The key is valid but lacks the required scope, or the workspace has
            no active plan, lacks the entitlement, or has this feature turned
            off or view-only.
        '404':
          description: >-
            The resource does not exist or is not owned by the authenticated
            workspace.
        '410':
          description: The workspace behind this key has been deleted.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
        '500':
          description: >-
            An unexpected Sendora error occurred. Retry only if the operation is
            safe to repeat.
        '503':
          description: >-
            An entitlement or billing check is temporarily unavailable. Retry
            after the Retry-After interval.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - label: cURL
          lang: bash
          source: >-
            curl -X PATCH
            'https://api.sendora.ai/api/v1/public/partner/billing/plans/YOUR_ID'
            -H "X-API-Key: $SENDORA_API_KEY" -H "Content-Type: application/json"
            \
              -d '{"billing_interval":"month","currency":"example","description":"example"}'
        - label: Python
          lang: python
          source: >-
            import requests


            url =
            'https://api.sendora.ai/api/v1/public/partner/billing/plans/YOUR_ID'

            headers = {'X-API-Key': '$SENDORA_API_KEY'}

            response = requests.patch(url, headers=headers,
            json={'billing_interval': 'month', 'currency': 'example',
            'description': 'example'})

            response.raise_for_status()

            print(response.json())
        - label: JavaScript
          lang: javascript
          source: >-
            const response = await
            fetch("https://api.sendora.ai/api/v1/public/partner/billing/plans/YOUR_ID",
            {
              method: "PATCH",
              headers: { 'X-API-Key': process.env.SENDORA_API_KEY, 'Content-Type': 'application/json' },
              body: JSON.stringify({"billing_interval": "month", "currency": "example", "description": "example"}),
            });

            if (!response.ok) throw new Error(await response.text());

            console.log(await response.json());
        - label: Go
          lang: go
          source: >-
            req, err := http.NewRequest("PATCH",
            "https://api.sendora.ai/api/v1/public/partner/billing/plans/YOUR_ID",
            bytes.NewBufferString(`{"billing_interval": "month", "currency":
            "example", "description": "example"}`))

            if err != nil { log.Fatal(err) }

            req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY"))

            req.Header.Set("Content-Type", "application/json")

            resp, err := http.DefaultClient.Do(req)

            if err != nil { log.Fatal(err) }

            defer resp.Body.Close()
components:
  schemas:
    api__v1__partner__schemas__AgencyPlanUpdate:
      properties:
        billing_interval:
          anyOf:
            - enum:
                - month
                - year
              type: string
            - type: 'null'
          description: Billing interval returned by the Sendora API.
          title: Billing Interval
        currency:
          anyOf:
            - maxLength: 3
              minLength: 3
              type: string
            - type: 'null'
          description: Currency returned by the Sendora API.
          title: Currency
        description:
          anyOf:
            - maxLength: 500
              type: string
            - type: 'null'
          description: Description returned by the Sendora API.
          title: Description
        features:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          description: Features returned by the Sendora API.
          title: Features
        included_credit_cents:
          anyOf:
            - maximum: 10000000
              minimum: 0
              type: integer
            - type: 'null'
          description: Included credit cents returned by the Sendora API.
          title: Included Credit Cents
        is_active:
          anyOf:
            - type: boolean
            - type: 'null'
          description: Is active returned by the Sendora API.
          title: Is Active
        name:
          anyOf:
            - maxLength: 120
              minLength: 1
              type: string
            - type: 'null'
          description: Name returned by the Sendora API.
          title: Name
        price_cents:
          anyOf:
            - maximum: 10000000
              minimum: 0
              type: integer
            - type: 'null'
          description: Price cents returned by the Sendora API.
          title: Price Cents
        sendora_wholesale_cents:
          anyOf:
            - maximum: 10000000
              minimum: 0
              type: integer
            - type: 'null'
          description: Sendora wholesale cents returned by the Sendora API.
          title: Sendora Wholesale Cents
        sort_order:
          anyOf:
            - maximum: 9999
              minimum: 0
              type: integer
            - type: 'null'
          description: Sort order returned by the Sendora API.
          title: Sort Order
        trial_days:
          anyOf:
            - maximum: 365
              minimum: 0
              type: integer
            - type: 'null'
          description: Trial days returned by the Sendora API.
          title: Trial Days
      required: []
      title: AgencyPlanUpdate
      type: object
    api__v1__partner__schemas__AgencyPlanOut:
      properties:
        billing_interval:
          default: month
          description: Billing interval returned by the Sendora API.
          enum:
            - month
            - year
          title: Billing Interval
          type: string
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          description: Created at returned by the Sendora API.
          title: Created At
        currency:
          default: usd
          description: Currency returned by the Sendora API.
          maxLength: 3
          minLength: 3
          title: Currency
          type: string
        description:
          anyOf:
            - maxLength: 500
              type: string
            - type: 'null'
          description: Description returned by the Sendora API.
          title: Description
        features:
          description: Features returned by the Sendora API.
          items:
            type: string
          title: Features
          type: array
        id:
          description: The pricing plan's id. Pass it to any endpoint that takes `plan_id`.
          title: Id
          type: string
        included_credit_cents:
          default: 0
          description: Included credit cents returned by the Sendora API.
          maximum: 10000000
          minimum: 0
          title: Included Credit Cents
          type: integer
        is_active:
          default: true
          description: Is active returned by the Sendora API.
          title: Is Active
          type: boolean
        name:
          description: Name returned by the Sendora API.
          maxLength: 120
          minLength: 1
          title: Name
          type: string
        price_cents:
          default: 0
          description: Price cents returned by the Sendora API.
          maximum: 10000000
          minimum: 0
          title: Price Cents
          type: integer
        sendora_wholesale_cents:
          default: 0
          description: Sendora wholesale cents returned by the Sendora API.
          maximum: 10000000
          minimum: 0
          title: Sendora Wholesale Cents
          type: integer
        sort_order:
          default: 0
          description: Sort order returned by the Sendora API.
          maximum: 9999
          minimum: 0
          title: Sort Order
          type: integer
        trial_days:
          default: 0
          description: Trial days returned by the Sendora API.
          maximum: 365
          minimum: 0
          title: Trial Days
          type: integer
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          description: Updated at returned by the Sendora API.
          title: Updated At
      required:
        - name
        - id
      title: AgencyPlanOut
      type: object
    HTTPValidationError:
      properties:
        detail:
          description: Detail returned by the Sendora API.
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      required: []
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          description: Loc returned by the Sendora API.
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          description: Msg returned by the Sendora API.
          title: Message
          type: string
        type:
          description: Type returned by the Sendora API.
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Customer API key created in the Sendora dashboard.
      in: header
      name: X-API-Key
      type: apiKey

````

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