---
title: "Unassign the number from the inbox"
method: POST
path: "/numbers/{number}/unassign-from-inbox"
tags: ["Numbers"]
---

# Unassign the number from the inbox

`POST /numbers/{number}/unassign-from-inbox`

REQUIRED SCOPES <code>['numbers:write']</code><br>Unassign the number from the inbox

## Path parameters

- `number` string, required

## Request body

- object
  - `reassign_number_id` integer — This parameter is preferred and is used in priority. The ID of reassignable number. Required if property 'reassign' is 'null' or not provided.
  - `reassign` string — Source type and source id to take number for reassigning, format: '{sourcePath}:{sourceId}'. Possibile values: App\\\Teams\\\Team:{your ID}. Required if 'reassign_number_id' is not provided

## Response `200`

OK

- NumberResource — Class NumberResource
  - `id` integer
  - `organization_id` integer
  - `country` string
  - `state` string
  - `city` string
  - `number` string
  - `number_vendor_id` integer
  - `country_calling_code` string
  - `national_number` string
  - `formattedNumber` string
  - `formatted_number` string
  - `short_code` integer
  - `is_landline` integer
  - `is_toll_free` boolean
  - `is_mobile` boolean
  - `is_aircall` boolean
  - `voice` boolean
  - `use_organization_call_settings` boolean
  - `voice_outbound` boolean
  - `mms` boolean
  - `disabled` boolean
  - `has_profile` boolean
  - `verified_status` string
  - `area_code` object
    - `id` integer
    - `area_code` string
    - `state_code` string
    - `state_name` string
    - `country_code` string
    - `time_zone` string
    - `group_id` integer
  - `landline` object
    - `id` integer
    - `number_id` integer
    - `address_sid` string
    - `sid` string
    - `document_sid` string
    - `status` string
    - `verification_attempts` integer
    - `last_verify_attempt_at` string
    - `landline_name` string
    - `street_address` string
    - `city` string
    - `state` string
    - `zip_code` string
    - `completed` integer
    - `created_at` string
    - `updated_at` string
  - `number_vendor` object
    - `id` integer
    - `is_active` boolean
    - `key` string
    - `name` string
    - `credentials_prefix` string
    - `twilio_sid` string
    - `twilio_auth_token` string
    - `is_billable` integer
    - `created_at` string
    - `updated_at` string
  - `number_caller_id` object
    - `caller_id_sid` string
    - `verified` boolean
    - `failed_reason` string
  - `call_forwarding` object
    - `id` integer
    - `number_id` integer
    - `is_active` boolean
    - `is_screening` boolean
    - `is_call_whisper` boolean
    - `call_whisper` string
    - `country` string
    - `number` string
    - `country_calling_code` string
    - `national_number` string
    - `formatted_number` string
    - `extension` string
    - `created_at` string
    - `updated_at` string
  - `numberable_id` integer
  - `numberable_type` string
  - `numberable` union
    - object
      - `id` integer
      - `organization_id` integer
      - `owner_id` integer
      - `team_id` integer
      - `name` string
      - `created_at` string
      - `updated_at` string
    - object
      - `id` integer
      - `organization_id` integer
      - `owner_id` integer
      - `name` string
      - `inbox_identifier` string
      - `last_assigned_user_id` integer
      - `default_assigned_user_id` integer

## Other responses

- `422` — Unprocessable Entity
- `500` — Invalid Number

---

[API](https://skmtc.net/salesmessage/apis/salesmessage-public-api.md) · [All operations](https://skmtc.net/salesmessage/apis/salesmessage-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/salesmessage/salesmessage-public-api/revisions/e96b3e58b041/schema)