> ## Documentation Index > Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt > Use this file to discover all available pages before exploring further. # Quote session tier change > Returns the full credit charge and effective time before confirmation. Null tierOverride restores project inheritance. Creating a quote does not change the number or consume credit. Quotes expire after ten minutes and are invalidated when the number or price changes. Requires `sessions:manage`. Project tokens only access resources in their own project. ## OpenAPI ````yaml api-reference/features/connect.json POST /platform/sessions/{sessionId}/tier-quotes openapi: 3.0.3 info: title: Connect API methods version: 1.0.0 description: Task-focused connect methods across supported Polymorfa connection types. servers: [] security: [] paths: /platform/sessions/{sessionId}/tier-quotes: post: tags: - Sessions summary: Quote session tier change description: >- Returns the full credit charge and effective time before confirmation. Null tierOverride restores project inheritance. Creating a quote does not change the number or consume credit. Quotes expire after ten minutes and are invalidated when the number or price changes. Requires `sessions:manage`. Project tokens only access resources in their own project. operationId: managementQuoteSessionTierChange parameters: - name: sessionId in: path required: true description: |- Database session UUID or stable session slug. **Value constraints** | Constraint | Accepted input | | --- | --- | | String length | `1` through `64` characters | schema: $ref: '#/components/schemas/management__SessionIdentifier' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/management__NumberTierQuoteRequest' responses: '200': description: Success headers: X-Request-Id: schema: type: string description: Stable request correlation identifier. Polymorfa-Version: schema: type: string description: API version applied to this response. content: application/json: schema: type: object additionalProperties: false properties: data: allOf: - $ref: '#/components/schemas/management__NumberTierChange' description: Structured data carried by this object. required: - data '400': $ref: '#/components/responses/management__BadRequest' '401': $ref: '#/components/responses/management__Unauthorized' '403': $ref: '#/components/responses/management__Forbidden' '404': $ref: '#/components/responses/management__NotFound' '409': $ref: '#/components/responses/management__Conflict' security: - management__ApiKeyAuth: [] servers: - url: https://api.polymorfa.com components: schemas: management__SessionIdentifier: type: string minLength: 1 maxLength: 64 description: Database session UUID or stable session slug. management__NumberTierQuoteRequest: type: object additionalProperties: false properties: projectId: allOf: - $ref: '#/components/schemas/management__ProjectId' description: |- Identifier of the Polymorfa project that owns this resource. **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `uuid` | tierOverride: type: string enum: - free - standard - pro - null nullable: true description: >- Specifies tier override for this management number tier quote request. **Allowed values** | Value | Meaning | | --- | --- | | `free` | Free. | | `standard` | Standard. | | `pro` | Pro. | | `null` | Null. | **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Value `free` or `standard` or `pro` | | Alternative 2 | `null` | required: - tierOverride management__NumberTierChange: type: object additionalProperties: false properties: id: type: string format: uuid description: |- Identifier for this resource. **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `uuid` | status: type: string enum: - quoted - queued - applied - rejected description: |- Current status of this resource or operation. **Allowed values** | Value | Meaning | | --- | --- | | `quoted` | Quoted. | | `queued` | Queued. | | `applied` | Applied. | | `rejected` | Rejected. | failureReason: type: string nullable: true description: |- Specifies failure reason for this management number tier change. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string` | | Alternative 2 | `null` | expiresAtMs: type: integer description: Specifies expires at ms for this management number tier change. quote: type: object additionalProperties: false properties: tier: type: string description: Specifies tier for this quote. tierOverride: type: string nullable: true description: |- Specifies tier override for this quote. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string` | | Alternative 2 | `null` | amountCents: type: number minimum: 0 multipleOf: 0.000001 description: |- Credits charged on application, with up to six decimal places. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | | Increment | Multiple of `0.000001` | priceVersion: type: string description: Specifies price version for this quote. action: type: string enum: - upgrade - downgrade - configure description: |- Action represented by this quote. **Allowed values** | Value | Meaning | | --- | --- | | `upgrade` | Upgrade. | | `downgrade` | Downgrade. | | `configure` | Configure. | effectiveAtMs: type: integer description: Specifies effective at ms for this quote. replacesWindowId: type: string format: uuid nullable: true description: |- Identifier for the replaces window. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `uuid` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `uuid` | required: - tier - tierOverride - amountCents - priceVersion - action - effectiveAtMs - replacesWindowId description: Structured quote values for this management number tier change. required: - id - status - failureReason - expiresAtMs - quote management__ProjectId: type: string format: uuid description: >- Project UUID. Optional where an operation can infer or search team scope; required where the operation creates a project-owned resource. management__ErrorEnvelope: type: object required: - error - data - docs properties: error: type: object required: - type - code - message - param properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - conflict_error - rate_limit_error - api_error - upstream_error description: |- Type discriminator for this object. **Allowed values** | Value | Meaning | | --- | --- | | `invalid_request_error` | Invalid request error. | | `authentication_error` | Authentication error. | | `permission_error` | Permission error. | | `conflict_error` | Conflict error. | | `rate_limit_error` | Rate limit error. | | `api_error` | Api error. | | `upstream_error` | Upstream error. | code: type: string description: Stable failure code. Use this value for programmatic handling. message: type: string description: Safe explanation of the failure. param: type: string nullable: true description: |- Invalid request field, or null when no field applies. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string` | | Alternative 2 | `null` | description: Error details returned when the operation fails. data: type: string nullable: true enum: - null description: |- Always null for a failed request. **Allowed values** | Value | Meaning | | --- | --- | | `null` | Null. | **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string` | | Alternative 2 | `null` | docs: type: string format: uri description: |- Documentation link to this failure code. **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `uri` | responses: management__BadRequest: description: A path, query, or request-body value did not pass validation. headers: X-Request-Id: schema: type: string description: Stable request correlation identifier. Polymorfa-Version: schema: type: string description: API version applied to this response. content: application/json: schema: $ref: '#/components/schemas/management__ErrorEnvelope' management__Unauthorized: description: Missing/invalid credential for this audience. headers: X-Request-Id: schema: type: string description: Stable request correlation identifier. Polymorfa-Version: schema: type: string description: API version applied to this response. content: application/json: schema: $ref: '#/components/schemas/management__ErrorEnvelope' management__Forbidden: description: Authenticated but lacks the required scope/role/audience. headers: X-Request-Id: schema: type: string description: Stable request correlation identifier. Polymorfa-Version: schema: type: string description: API version applied to this response. content: application/json: schema: $ref: '#/components/schemas/management__ErrorEnvelope' management__NotFound: description: >- The requested resource was not found inside the authenticated team or project scope. headers: X-Request-Id: schema: type: string description: Stable request correlation identifier. Polymorfa-Version: schema: type: string description: API version applied to this response. content: application/json: schema: $ref: '#/components/schemas/management__ErrorEnvelope' management__Conflict: description: The request conflicts with the resource's current state. headers: X-Request-Id: schema: type: string description: Stable request correlation identifier. Polymorfa-Version: schema: type: string description: API version applied to this response. content: application/json: schema: $ref: '#/components/schemas/management__ErrorEnvelope' securitySchemes: management__ApiKeyAuth: type: http scheme: bearer description: >- Send your team API key or project token as `Authorization: Bearer `. The credential must have the required permissions. Project tokens can access only their own project. ````