> ## 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. # Appeal ban safe enforcement > Files one appeal against a number's restriction. Every open finding on the number must be acknowledged first, otherwise the request is refused with `findings_unacknowledged`. Filing an appeal does not change the restriction. Requires a signed-in organization owner, admin, or developer. Requires a verified dashboard bearer and current organization authorization. Organization keys and project tokens are not accepted. ## OpenAPI ````yaml api-reference/features/operate.json POST /platform/bansafe/enforcement/{session}/appeal 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/enforcement/{session}/appeal: post: tags: - Bansafe summary: Appeal ban safe enforcement description: >- Files one appeal against a number's restriction. Every open finding on the number must be acknowledged first, otherwise the request is refused with `findings_unacknowledged`. Filing an appeal does not change the restriction. Requires a signed-in organization owner, admin, or developer. Requires a verified dashboard bearer and current organization authorization. Organization keys and project tokens are not accepted. operationId: managementAppealBanSafeEnforcement parameters: - name: session in: path required: true schema: type: string description: Identifier of the connected Polymorfa session. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/management__AppealBanSafeEnforcementInput' 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__BanSafeAppealReceipt' 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__ConsoleSession: [] servers: - url: https://api.polymorfa.com - url: http://localhost:8080 description: local dev components: schemas: management__AppealBanSafeEnforcementInput: type: object additionalProperties: false properties: note: type: string minLength: 1 maxLength: 1000 description: >- Specifies note for this management appeal ban safe enforcement input. **Value constraints** | Constraint | Accepted input | | --- | --- | | String length | `1` through `1000` characters | required: - note management__BanSafeAppealReceipt: type: object additionalProperties: false properties: 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. rung: type: string enum: - none - notify - throttle - block_cold - suspend description: |- Specifies rung for this management ban safe appeal receipt. **Allowed values** | Value | Meaning | | --- | --- | | `none` | None. | | `notify` | Notify. | | `throttle` | Throttle. | | `block_cold` | Block cold. | | `suspend` | Suspend. | appealState: type: string enum: - none - requested - granted - denied description: |- Specifies appeal state for this management ban safe appeal receipt. **Allowed values** | Value | Meaning | | --- | --- | | `none` | None. | | `requested` | Requested. | | `granted` | Granted. | | `denied` | Denied. | requestedAt: type: string format: date-time nullable: true description: |- Timestamp for requested at. **Accepted alternatives** | Alternative | Accepted input | | --- | --- | | Alternative 1 | Type: `string`; Format: `date-time` | | Alternative 2 | `null` | **Value constraints** | Constraint | Accepted input | | --- | --- | | Format | `date-time` | liftRequires: type: string description: Specifies lift requires for this management ban safe appeal receipt. message: type: string description: Human-readable message associated with this result. required: - sessionId - session - rung - appealState - requestedAt - liftRequires - message 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 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' 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' ````