> ## Documentation Index > Fetch the complete documentation index at: https://docs.telegent.com/llms.txt > Use this file to discover all available pages before exploring further. # Remove Blocked Numbers > Unblock phone numbers so they can call the subscriber again. **Prerequisites:** - Bearer token — `POST /v1.0/oauth2/tokens` - Subscriber ID and `CallFilterId` (`CFID-`) - Numbers must currently be on the blocked list — confirm with `GET /v1.0/subscribers/call-filter/blocked-numbers` **What this does:** Removes one or more phone numbers from the blocked list. After removal, calls from those numbers are handled normally according to the active filter mode (e.g., they will ring through in `BLACKLIST` mode unless they're caught by another rule). **Next steps:** - Verify the removal — `GET /v1.0/subscribers/call-filter/blocked-numbers` - Add to allowed instead — `POST /v1.0/subscribers/call-filter/allowed-numbers/add` ## OpenAPI ````yaml /api-reference/openapi.json post /v1.0/subscribers/call-filter/blocked-numbers/remove openapi: 3.0.3 info: title: mPaaS Core APIs version: 1.0.8 description: >- The Telegent mPaaS (Mobile Platform as a Service) API gives you full programmatic control over mobile phone numbers, messaging, voice routing, subscribers, and account management. Use these APIs to provision MVNO and IoT numbers, send and receive SMS/MMS, configure intelligent call routing, manage subscriber accounts, and apply AI Guardian controls. All requests require a Bearer token obtained from the Authentication endpoint. For support, visit https://support.telegent.com/support/home contact: name: Support email: support@telegent.com termsOfService: https://telegent.com/terms license: name: Use under LICX url: https://telegent.com/license servers: - url: https://api.telegent.com security: - BearerAuth: [] tags: - name: OAuth2 - name: AI Guardian - name: Accounts - name: Distributors - name: Message - name: Numbers - name: Voicemail - name: Packages - name: Products - name: Schedules - name: Services - name: Sims - name: Subscribers - name: Subscriptions - name: Voice - name: Workgroups paths: /v1.0/subscribers/call-filter/blocked-numbers/remove: post: tags: - Subscribers summary: Remove Blocked Numbers description: >- Unblock phone numbers so they can call the subscriber again. **Prerequisites:** - Bearer token — `POST /v1.0/oauth2/tokens` - Subscriber ID and `CallFilterId` (`CFID-`) - Numbers must currently be on the blocked list — confirm with `GET /v1.0/subscribers/call-filter/blocked-numbers` **What this does:** Removes one or more phone numbers from the blocked list. After removal, calls from those numbers are handled normally according to the active filter mode (e.g., they will ring through in `BLACKLIST` mode unless they're caught by another rule). **Next steps:** - Verify the removal — `GET /v1.0/subscribers/call-filter/blocked-numbers` - Add to allowed instead — `POST /v1.0/subscribers/call-filter/allowed-numbers/add` parameters: [] requestBody: required: true content: application/json: schema: type: object required: - SubscriberId - CallFilterId - Numbers properties: SubscriberId: type: string description: >- Telegent Subscriber ID. Format: `TSUID-` followed by a UUID. Create one via `POST /v1.0/subscribers/create` or look up existing IDs with `GET /v1.0/subscribers/get`. example: TSUID-C7AB61E0-9AD9-4512-ACA8-EDA284131441 CallFilterId: type: string description: >- Call Filter ID. Format: `CFID-` followed by a UUID. Returned by `POST /v1.0/subscribers/call-filter` (Create) or `GET /v1.0/subscribers/call-filter` (List). example: CFID-8e966d20-08b8-42bf-a11f-2fdf72c663d6 Numbers: type: array items: type: string description: >- One or more phone numbers (E.164 format) to remove from the list. example: - '+15555555555' responses: '200': description: Blocked Numbers Removed content: application/json: schema: type: object examples: example: value: FilterId: CFID-8e966d20-08b8-42bf-a11f-2fdf72c663d6 SubscriberId: TSUID-C7AB61E0-9AD9-4512-ACA8-EDA284131441 BlockedNumbers: - '+3333333333' '400': description: Bad Request content: text/plain: schema: $ref: '#/components/schemas/BadRequest_Result' application/json: schema: $ref: '#/components/schemas/BadRequest_Result' examples: example: value: StatusCode: 400 Message: >- Bad request: one or more required fields are missing or contain an invalid value. text/json: schema: $ref: '#/components/schemas/BadRequest_Result' '401': description: Unauthorized content: text/plain: schema: $ref: '#/components/schemas/Unauthorized_Result' application/json: schema: $ref: '#/components/schemas/Unauthorized_Result' examples: example: value: StatusCode: 401 Message: >- Unauthorized: Bearer token is missing, expired, or invalid. Re-authenticate via POST /v1.0/oauth2/tokens. text/json: schema: $ref: '#/components/schemas/Unauthorized_Result' '403': description: Forbidden content: text/plain: schema: $ref: '#/components/schemas/Forbidden_Result' application/json: schema: $ref: '#/components/schemas/Forbidden_Result' examples: example: value: StatusCode: 403 Message: >- Forbidden: your token does not have permission to access this resource. Check the ApiEndpoint scope. text/json: schema: $ref: '#/components/schemas/Forbidden_Result' '404': description: Not Found content: text/plain: schema: $ref: '#/components/schemas/NotFound_Result' application/json: schema: $ref: '#/components/schemas/NotFound_Result' examples: example: value: StatusCode: 404 Message: >- Not found: the requested resource does not exist or belongs to a different account. text/json: schema: $ref: '#/components/schemas/NotFound_Result' '405': description: Method Not Allowed content: text/plain: schema: $ref: '#/components/schemas/MethodNotAllowed_Result' application/json: schema: $ref: '#/components/schemas/MethodNotAllowed_Result' examples: example: value: StatusCode: 405 Message: >- Method not allowed: verify the HTTP method required for this endpoint. text/json: schema: $ref: '#/components/schemas/MethodNotAllowed_Result' '408': description: Request Timeout content: text/plain: schema: $ref: '#/components/schemas/RequestTimeout_Result' application/json: schema: $ref: '#/components/schemas/RequestTimeout_Result' examples: example: value: StatusCode: 408 Message: >- Request timeout: the server did not receive a complete request within the allowed time. Retry with exponential backoff. text/json: schema: $ref: '#/components/schemas/RequestTimeout_Result' '429': description: Too Many Requests content: text/plain: schema: $ref: '#/components/schemas/TooManyRequests_Result' application/json: schema: $ref: '#/components/schemas/TooManyRequests_Result' examples: example: value: StatusCode: 429 Message: >- Too many requests: rate limit exceeded. Slow your request cadence and retry after a short delay. text/json: schema: $ref: '#/components/schemas/TooManyRequests_Result' '500': description: Server Error content: text/plain: schema: $ref: '#/components/schemas/InternalServerError_Result' application/json: schema: $ref: '#/components/schemas/InternalServerError_Result' examples: example: value: StatusCode: 500 Message: >- Internal server error: an unexpected error occurred. If the problem persists contact support@telegent.com. text/json: schema: $ref: '#/components/schemas/InternalServerError_Result' '503': description: Service Unavailable content: text/plain: schema: $ref: '#/components/schemas/ServiceUnavailable_Result' application/json: schema: $ref: '#/components/schemas/ServiceUnavailable_Result' examples: example: value: StatusCode: 503 Message: >- Service unavailable: the API is temporarily unavailable. Retry after a short delay. text/json: schema: $ref: '#/components/schemas/ServiceUnavailable_Result' '504': description: Gateway Timeout content: text/plain: schema: $ref: '#/components/schemas/GatewayTimeout_Result' application/json: schema: $ref: '#/components/schemas/GatewayTimeout_Result' examples: example: value: StatusCode: 504 Message: >- Gateway timeout: an upstream service did not respond in time. Retry with exponential backoff. text/json: schema: $ref: '#/components/schemas/GatewayTimeout_Result' x-codeSamples: - lang: JSON source: |- { "SubscriberId": "TSUID-C7AB61E0-9AD9-4512-ACA8-EDA284131441", "CallFilterId": "CFID-8e966d20-08b8-42bf-a11f-2fdf72c663d6", "Numbers": ["+15555555555"] } - lang: cURL source: >- curl -X POST https://api.telegent.com/v1.0/subscribers/call-filter/blocked-numbers/remove \ -H 'Authorization: Bearer YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "SubscriberId": "TSUID-C7AB61E0-9AD9-4512-ACA8-EDA284131441", "CallFilterId": "CFID-8e966d20-08b8-42bf-a11f-2fdf72c663d6", "Numbers": ["+15555555555"] }' components: schemas: BadRequest_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false Unauthorized_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false Forbidden_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false NotFound_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false MethodNotAllowed_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false RequestTimeout_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false TooManyRequests_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false InternalServerError_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false ServiceUnavailable_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false GatewayTimeout_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false ````