> ## 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. # Get ban safe health > Returns one number's present Health estimate and model metadata, retained open and acknowledged findings with their observation times, directly observed account state, the active Polymorfa restriction, and how that restriction lifts. Recorded findings and observed state remain separate from the estimate. Requires `sessions:read`. Project tokens only access resources in their own project. ## OpenAPI ````yaml api-reference/features/operate.json GET /platform/bansafe/health/{session} openapi: 3.0.3 info: title: Operate API methods version: 1.0.0 description: Task-focused operate methods across supported Polymorfa connection types. servers: [] security: [] paths: /platform/bansafe/health/{session}: get: tags: - Bansafe summary: Get ban safe health description: >- Returns one number's present Health estimate and model metadata, retained open and acknowledged findings with their observation times, directly observed account state, the active Polymorfa restriction, and how that restriction lifts. Recorded findings and observed state remain separate from the estimate. Requires `sessions:read`. Project tokens only access resources in their own project. operationId: managementGetBanSafeHealth parameters: - name: session in: path required: true schema: type: string description: Identifier of the connected Polymorfa session. 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__BanSafeNumberDetail' 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' security: - management__ApiKeyAuth: [] servers: - url: https://api.polymorfa.com - url: http://localhost:8080 description: local dev components: schemas: management__BanSafeNumberDetail: type: object additionalProperties: false properties: health: type: number minimum: 0 maximum: 100 nullable: true description: >- Estimate of present account Health. Higher is healthier. Read healthSource, healthReliability, and healthFeatureCoverage with it. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `number`; Numeric value: `0` through `100` (inclusive) | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `100` (inclusive) | band: type: string enum: - good - fair - poor - failing - unknown description: |- Specifies band for this management ban safe number detail. **Allowed values** | Value | Meaning | | --- | --- | | `good` | Good. | | `fair` | Fair. | | `poor` | Poor. | | `failing` | Failing. | | `unknown` | Unknown. | healthSource: type: string enum: - rules_v1 - ml_model - unavailable description: >- Estimator family. rules_v1 is deterministic; unavailable carries no numeric Health. **Allowed values** | Value | Meaning | | --- | --- | | `rules_v1` | Rules v1. | | `ml_model` | Ml model. | | `unavailable` | Unavailable. | healthEstimatorVersion: type: string nullable: true description: |- Version of the estimator that produced Health. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string` | | Alternative 2 | `null` | healthModelVersion: type: string nullable: true description: |- Learned-model artifact version. Null for rules_v1. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string` | | Alternative 2 | `null` | healthEvaluatedAt: type: string format: date-time nullable: true description: |- Timestamp for health evaluated at. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `date-time` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | healthFeatureCoverage: type: number minimum: 0 maximum: 1 nullable: true description: >- Specifies health feature coverage for this management ban safe number detail. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `number`; Numeric value: `0` through `1` (inclusive) | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `1` (inclusive) | healthReliability: type: string enum: - rules_based - validated - unavailable description: |- Support category, not a confidence score. **Allowed values** | Value | Meaning | | --- | --- | | `rules_based` | Rules based. | | `validated` | Validated. | | `unavailable` | Unavailable. | healthUnavailableReason: type: string nullable: true enum: - no_active_model - invalid_active_model - insufficient_fresh_features - null description: >- Specifies health unavailable reason for this management ban safe number detail. **Allowed values** | Value | Meaning | | --- | --- | | `no_active_model` | No active model. | | `invalid_active_model` | Invalid active model. | | `insufficient_fresh_features` | Insufficient fresh features. | | `null` | Null. | **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Value `no_active_model` or `invalid_active_model` or `insufficient_fresh_features` | | Alternative 2 | `null` | healthProbabilities: nullable: true allOf: - $ref: '#/components/schemas/management__BanSafeHealthProbabilities' description: >- Specifies health probabilities for this management ban safe number detail. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `object`; Required fields: `healthy`, `limited`, `restricted`, `banned` | | Alternative 2 | `null` | mostLikelyHealthState: type: string enum: - healthy - limited - restricted - banned - null nullable: true description: >- Specifies most likely health state for this management ban safe number detail. **Allowed values** | Value | Meaning | | --- | --- | | `healthy` | Healthy. | | `limited` | Limited. | | `restricted` | Restricted. | | `banned` | Banned. | | `null` | Null. | **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Value `healthy` or `limited` or `restricted` or `banned` | | Alternative 2 | `null` | healthExplanation: nullable: true allOf: - $ref: '#/components/schemas/management__BanSafeHealthExplanation' description: >- Specifies health explanation for this management ban safe number detail. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `object`; Required fields: `penalties`, `factors`, `measuredGroups`, `missingGroups` | | Alternative 2 | `null` | observedAccountState: nullable: true allOf: - $ref: '#/components/schemas/management__BanSafeObservedAccountState' description: >- Specifies observed account state for this management ban safe number detail. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `object`; Field `state`: `healthy` or `limited` or `restricted` or `banned`; Field `source`: `account_check` or `restriction_event`; Required fields: `state`, `observedAt`, `source` | | Alternative 2 | `null` | warmup: allOf: - $ref: '#/components/schemas/management__BanSafeNumberWarmup' description: Specifies warmup for this management ban safe number detail. findings: type: array items: $ref: '#/components/schemas/management__BanSafeFinding' description: Findings associated with this management ban safe number detail. liftRequires: type: string nullable: true description: |- The exact remaining condition for the restriction to lift. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string` | | Alternative 2 | `null` | appealState: type: string enum: - none - requested - granted - denied description: |- Specifies appeal state for this management ban safe number detail. **Allowed values** | Value | Meaning | | --- | --- | | `none` | None. | | `requested` | Requested. | | `granted` | Granted. | | `denied` | Denied. | required: - sessionId - session - phoneNumber - projectId - health - band - healthSource - healthEstimatorVersion - healthModelVersion - healthEvaluatedAt - healthFeatureCoverage - healthReliability - healthUnavailableReason - healthProbabilities - mostLikelyHealthState - healthExplanation - observedAccountState - enforcement - warmup - findings - liftRequires - appealState management__BanSafeHealthProbabilities: type: object additionalProperties: false properties: healthy: type: number minimum: 0 maximum: 1 description: |- Specifies healthy for this management ban safe health probability. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `1` (inclusive) | limited: type: number minimum: 0 maximum: 1 description: |- Specifies limited for this management ban safe health probability. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `1` (inclusive) | restricted: type: number minimum: 0 maximum: 1 description: >- Specifies restricted for this management ban safe health probability. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `1` (inclusive) | banned: type: number minimum: 0 maximum: 1 description: |- Specifies banned for this management ban safe health probability. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `1` (inclusive) | required: - healthy - limited - restricted - banned management__BanSafeHealthExplanation: type: object additionalProperties: false description: >- Bounded rules-v1 inputs and deductions. It is not a forecast or confidence score. properties: penalties: type: object additionalProperties: false properties: conduct: type: number minimum: 0 maximum: 100 description: |- Specifies conduct for this penalty. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `100` (inclusive) | delivery: type: number minimum: 0 maximum: 100 description: |- Specifies delivery for this penalty. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `100` (inclusive) | connection: type: number minimum: 0 maximum: 100 description: |- Specifies connection for this penalty. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `100` (inclusive) | restriction: type: number minimum: 0 maximum: 100 description: |- Specifies restriction for this penalty. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `100` (inclusive) | total: type: number minimum: 0 maximum: 100 description: |- Final total for this order or price summary. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `100` (inclusive) | required: - conduct - delivery - connection - restriction - total description: >- Structured penalties values for this management ban safe health explanation. factors: type: array maxItems: 8 items: $ref: '#/components/schemas/management__BanSafeHealthExplanationFactor' description: |- Factors associated with this management ban safe health explanation. **Value constraints** | Constraint | Accepted input | | --- | --- | | Array size | At most `8` items | measuredGroups: type: array maxItems: 5 uniqueItems: true items: type: string enum: - direct_condition - delivery - connection - conduct - cadence description: >- Measured groups associated with this management ban safe health explanation. **Allowed item values** | Item value | Meaning | | --- | --- | | `direct_condition` | Direct condition. | | `delivery` | Delivery. | | `connection` | Connection. | | `conduct` | Conduct. | | `cadence` | Cadence. | **Value constraints** | Constraint | Accepted input | | --- | --- | | Array size | At most `5` items | | Duplicates | Not accepted; every array item must be unique | missingGroups: type: array maxItems: 5 uniqueItems: true items: type: string enum: - direct_condition - delivery - connection - conduct - cadence description: >- Missing groups associated with this management ban safe health explanation. **Allowed item values** | Item value | Meaning | | --- | --- | | `direct_condition` | Direct condition. | | `delivery` | Delivery. | | `connection` | Connection. | | `conduct` | Conduct. | | `cadence` | Cadence. | **Value constraints** | Constraint | Accepted input | | --- | --- | | Array size | At most `5` items | | Duplicates | Not accepted; every array item must be unique | required: - penalties - factors - measuredGroups - missingGroups management__BanSafeObservedAccountState: type: object additionalProperties: false description: Direct account-state evidence. This is not an ML estimate. properties: state: type: string enum: - healthy - limited - restricted - banned description: |- Current lifecycle state of this resource. **Allowed values** | Value | Meaning | | --- | --- | | `healthy` | Healthy. | | `limited` | Limited. | | `restricted` | Restricted. | | `banned` | Banned. | observedAt: type: string format: date-time description: |- ISO 8601 timestamp when Polymorfa observed this state. **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | source: type: string enum: - account_check - restriction_event description: >- Specifies source for this management ban safe observed account state. **Allowed values** | Value | Meaning | | --- | --- | | `account_check` | Account check. | | `restriction_event` | Restriction event. | required: - state - observedAt - source management__BanSafeNumberWarmup: type: object additionalProperties: false properties: enabled: type: boolean description: Whether this feature is enabled. tenureSource: type: string enum: - history - link - plan - null nullable: true description: >- Retained evidence anchoring the ramp; null when legacy evidence cannot be classified. **Allowed values** | Value | Meaning | | --- | --- | | `history` | History. | | `link` | Link. | | `plan` | Plan. | | `null` | Null. | **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Value `history` or `link` or `plan` | | Alternative 2 | `null` | tenureDay: type: integer minimum: 0 description: >- Whole days since the number's known tenure lower bound; zero when unknown. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | allowance: type: integer minimum: 0 nullable: true description: |- Messages allowed today; null when the plan is disabled. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `integer`; Numeric value: `0` or greater | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | sentToday: type: integer minimum: 0 nullable: true description: >- Durable reservations in the active allowance window. Successful current reads return 0 before the first reservation; null remains accepted for older stored responses. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `integer`; Numeric value: `0` or greater | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | resetsAt: type: string format: date-time nullable: true description: |- Timestamp for resets at. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `date-time` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | curve: type: array items: $ref: '#/components/schemas/management__WarmupCurvePoint' description: Curve associated with this management ban safe number warmup. required: - enabled - tenureSource - tenureDay - allowance - sentToday - resetsAt - curve management__BanSafeFinding: type: object additionalProperties: false description: >- One safety finding, with the sentences to show a customer. A `not_measured` entry has no stored lifecycle and reports null timestamps; it is never reported as resolved and never omitted. properties: id: type: string format: uuid nullable: true description: |- Identifier for this resource. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `uuid` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `uuid` | key: type: string maxLength: 64 description: |- Specifies key for this management ban safe finding. **Value constraints** | Constraint | Accepted input | | --- | --- | | String length | At most `64` characters | title: type: string description: >- Customer-visible name of the check. A `not_measured` entry carries the same title as a stored one. summary: type: string description: >- The evidence sentence for this finding, with the numbers from `evidence` already filled in. A number the check could not read reads as `unknown`, and a `not_measured` entry therefore reads as the sentence with no numbers in it. Empty for a key Polymorfa has retired. fix: type: string description: >- What to change to clear the finding. Empty for a key Polymorfa has retired. status: type: string enum: - open - acknowledged - resolved - not_measured description: |- Current status of this resource or operation. **Allowed values** | Value | Meaning | | --- | --- | | `open` | Open. | | `acknowledged` | Acknowledged. | | `resolved` | Resolved. | | `not_measured` | Not measured. | severity: type: string enum: - info - warning - critical - null nullable: true description: >- Specifies severity for this management ban safe finding. **Allowed values** | Value | Meaning | | --- | --- | | `info` | Info. | | `warning` | Warning. | | `critical` | Critical. | | `null` | Null. | **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Value `info` or `warning` or `critical` | | Alternative 2 | `null` | occurrences: type: integer minimum: 0 description: |- Specifies occurrences for this management ban safe finding. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | reopenedCount: type: integer minimum: 0 description: |- Number of reopeneds. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | evidence: type: object additionalProperties: true description: >- Numbers only. Never message content, a message identifier, or a recipient identifier. sessionId: type: string format: uuid description: |- Identifier of the connected Polymorfa session. **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `uuid` | session: type: string description: Identifier of the connected Polymorfa session. phoneNumber: type: string description: Phone number in international format. firstSeenAt: type: string format: date-time nullable: true description: |- Timestamp for first seen at. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `date-time` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | lastSeenAt: type: string format: date-time nullable: true description: |- Timestamp for last seen at. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `date-time` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | acknowledgedAt: type: string format: date-time nullable: true description: |- Timestamp for acknowledged at. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `date-time` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | acknowledgedBy: type: string nullable: true description: |- Specifies acknowledged by for this management ban safe finding. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string` | | Alternative 2 | `null` | acknowledgementNote: type: string nullable: true maxLength: 500 description: >- Specifies acknowledgement note for this management ban safe finding. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; String length: At most `500` characters | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | String length | At most `500` characters | snoozedUntil: type: string format: date-time nullable: true description: |- Specifies snoozed until for this management ban safe finding. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `date-time` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | resolvedAt: type: string format: date-time nullable: true description: |- Timestamp for resolved at. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `date-time` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | resolveReason: type: string nullable: true enum: - clean - key_retired - number_removed - stale - null description: >- Specifies resolve reason for this management ban safe finding. **Allowed values** | Value | Meaning | | --- | --- | | `clean` | Clean. | | `key_retired` | Key retired. | | `number_removed` | Number removed. | | `stale` | Stale. | | `null` | Null. | **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Value `clean` or `key_retired` or `number_removed` or `stale` | | Alternative 2 | `null` | required: - id - key - title - summary - fix - status - severity - occurrences - reopenedCount - evidence - sessionId - session - phoneNumber - firstSeenAt - lastSeenAt - acknowledgedAt - acknowledgedBy - acknowledgementNote - snoozedUntil - resolvedAt - resolveReason 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` | management__BanSafeHealthExplanationFactor: type: object additionalProperties: false description: >- One factual rules-v1 input. penalty is the number of Health points this input subtracts. properties: group: type: string enum: - direct_condition - delivery - connection - conduct - cadence description: >- Specifies group for this management ban safe health explanation factor. **Allowed values** | Value | Meaning | | --- | --- | | `direct_condition` | Direct condition. | | `delivery` | Delivery. | | `connection` | Connection. | | `conduct` | Conduct. | | `cadence` | Cadence. | key: type: string enum: - observed_limited - observed_restricted - observed_banned - send_failures - receipt_errors - server_ack_tail - connection_failures - connection_churn - connection_disconnected - auto_reconnect_errors - keep_alive_errors - unanswered_first_contacts - unsolicited_sends - send_burst - fixed_send_rhythm description: >- Specifies key for this management ban safe health explanation factor. **Allowed values** | Value | Meaning | | --- | --- | | `observed_limited` | Observed limited. | | `observed_restricted` | Observed restricted. | | `observed_banned` | Observed banned. | | `send_failures` | Send failures. | | `receipt_errors` | Receipt errors. | | `server_ack_tail` | Server ack tail. | | `connection_failures` | Connection failures. | | `connection_churn` | Connection churn. | | `connection_disconnected` | Connection disconnected. | | `auto_reconnect_errors` | Auto reconnect errors. | | `keep_alive_errors` | Keep alive errors. | | `unanswered_first_contacts` | Unanswered first contacts. | | `unsolicited_sends` | Unsolicited sends. | | `send_burst` | Send burst. | | `fixed_send_rhythm` | Fixed send rhythm. | penalty: type: number minimum: 0 maximum: 100 description: >- Specifies penalty for this management ban safe health explanation factor. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` through `100` (inclusive) | observedValue: type: number description: >- Specifies observed value for this management ban safe health explanation factor. sampleSize: type: integer minimum: 0 description: >- Specifies sample size for this management ban safe health explanation factor. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | required: - group - key - penalty - observedValue - sampleSize management__WarmupCurvePoint: type: object additionalProperties: false properties: day: type: integer minimum: 0 description: |- Days since the number's first proven activity. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | allowance: type: integer minimum: 0 description: |- Messages allowed on that day. **Value constraints** | Constraint | Accepted input | | --- | --- | | Numeric value | `0` or greater | required: - day - allowance 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 organization 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' securitySchemes: management__ApiKeyAuth: type: http scheme: bearer description: >- Polymorfa server credential: a scoped pmfa_ organization key, or a pmfa_pt_ project token on project- and session-bound operations inside its exact authenticated project. Keys may be personal or service-account owned. Both enforce selected action scopes; organization keys can address team resources and every project in the organization. Listener and browser client credentials are rejected. ````