---
title: "Hold call session"
method: POST
path: "/sessions/{id}/hold"
tags: ["Call Session"]
---

# Hold call session

`POST /sessions/{id}/hold`

## Request

- Base URL: `https://HOSTNAME:8887/api`
- URL: `https://HOSTNAME:8887/api/sessions/{id}/hold`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/docs/sessions/:id/hold/post.ts> (a function with typed inputs; its response is checked against the schema)

Hold call session by it's session ID.

## Path parameters

- `id` string, required: The unique ID of the resource.

## Request body

- object
  - `extension_number` string, required: The extension number.

## Response `200`

Ok

## Other responses

- `4XX`: Error

---

[API](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api.md) - [All operations](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/revisions/577415d4a3d5?raw)