curl --request POST \
  --url https://app.thinnest.ai/api/v1/phone-numbers/{number}/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "toWorkspace": "org_5c1d7e2a-9b3f-4a6e-8d20-7f4b1c9e3a58"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({toWorkspace: 'org_5c1d7e2a-9b3f-4a6e-8d20-7f4b1c9e3a58'})
};

fetch('https://app.thinnest.ai/api/v1/phone-numbers/{number}/move', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.thinnest.ai/api/v1/phone-numbers/{number}/move"

payload = { "toWorkspace": "org_5c1d7e2a-9b3f-4a6e-8d20-7f4b1c9e3a58" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "number": "918041234567",
  "source": "rented",
  "from": "org_9e4b2c71-3d5a-4f80-b6e1-2a7c0d8f5b93",
  "to": "org_5c1d7e2a-9b3f-4a6e-8d20-7f4b1c9e3a58",
  "paidThrough": "2026-10"
}

{
  "error": "`toWorkspace` is required: the `org_…` id of the workspace to move the number to.",
  "code": "validation_failed"
}

{
  "error": "Unauthorized",
  "code": "unauthorized"
}

{
  "error": "Moving a number between workspaces needs a developer's key: from your own workspace, or acting as one of your customers with Thinnest-Workspace.",
  "code": "number_move_needs_developer"
}

{
  "error": "Workspace not found.",
  "code": "workspace_not_found"
}

{
  "error": "That workspace has not sent its business details. An Indian number is held in the name of the business using it, so send them for that workspace first (PUT /api/v1/phone-numbers/business-details with its Thinnest-Workspace).",
  "code": "number_move_needs_business_details"
}

{
  "error": "That workspace was deleted on 2026-10-01 and is erased on 2026-10-31. Restore it before moving a number to it.",
  "code": "workspace_deleted"
}

{
  "error": "Over 240 requests a minute. Slow down and retry.",
  "code": "rate_limit_resources",
  "limit": {
    "name": "resources",
    "perMinute": 240
  }
}

{
  "error": "We could not move that number just now. It is still in this workspace, answered by no agent. Try again in a few minutes.",
  "code": "number_move_unavailable"
}