---
title: "Resume byo line"
method: POST
path: "/v1/byo-line/resume"
tags: ["Owner"]
---

# Resume byo line

`POST /v1/byo-line/resume`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/byo-line/resume`
- Auth: HTTP bearer

## Request body

- TestByoLineRequest

## Response `200`

OK

- ByoLineResponse
  - `line` object, nullable, required
    - `e164` string, required
    - `status` 'verifying' | 'connecting' | 'ready' | 'suspended' | 'removing', required
    - `preset` 'generic' | '3cx' | 'freepbx' | 'twilio-number' | 'twilio-trunk' | 'signalwire' | 'vonage' | 'bird' | 'telnyx' | 'cpaas', required
    - `codeSentAt` string, date-time, required
    - `attemptsLeft` integer, required
    - `settings` object[], nullable, required
      - `field` 'uri' | 'host' | 'port' | 'transport' | 'media' | 'codecs' | 'number' | 'twiml', required
      - `value` string, required
    - `test` object, nullable, required
      - `state` 'calling' | 'passed' | 'failed', required
      - `at` string, date-time, required
      - `reason` 'passed' | 'answered_elsewhere' | 'codec' | 'auth' | 'number' | 'unreachable' | 'busy' | 'not_routed', nullable, required
      - `field` 'uri' | 'host' | 'port' | 'transport' | 'media' | 'codecs' | 'number' | 'twiml', nullable, required
    - `working` boolean, required
    - `resumeAt` string, date-time, required
    - `stuck` boolean
    - `hook` object, nullable
      - `url` string, required
      - `mode` 'always' | 'ring_first' | 'after_hours' | 'backup', required
      - `ringSecs` integer, required
      - `opensMin` integer, required
      - `closesMin` integer, required
      - `days` integer[], required
      - `phoneReady` boolean, required

## Other responses

- `400`: Invalid request (body not JSON, or schema validation failed).
- `401`: Missing, expired or invalid bearer token.
- `413`: Body over the limit (64 KB; 512 KB for contact import).
- `500`: Unexpected server error (reported to Sentry).

---

[API](https://skmtc.dev/vicem/apis/vicem-api.md) · [All operations](https://skmtc.dev/vicem/apis/vicem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vicem/apis/vicem-api/revisions/9efcec07e5f4?raw)