GET
/
v1
/
orgs
/
{org_id}
/
workspaces
/
{workspace_id}
/
deployments
List Deployments
curl --request GET \
  --url https://apps.sarvam.ai/api/app-authoring/v1/orgs/{org_id}/workspaces/{workspace_id}/deployments \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "name": "Customer Support Line",
      "deployment_id": "dep-a1b2c3d4",
      "status": "active",
      "description": "Main support deployment for EN and HI",
      "app_id": "my-support-agent",
      "app_version": 3,
      "phone_numbers": [
        "+918047168000"
      ],
      "channel_direction": "inbound",
      "inbound_config": {
        "start_time": "09:00",
        "end_time": "18:00",
        "allowed_days": [
          "Monday",
          "Tuesday",
          "Wednesday",
          "Thursday",
          "Friday"
        ],
        "timezone": "Asia/Kolkata"
      },
      "created_by": "user@company.com",
      "created_at": "2026-03-01T10:00:00Z",
      "updated_by": "user@company.com",
      "updated_at": "2026-03-15T14:30:00Z"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0,
  "next_page_uri": null,
  "prev_page_uri": null
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
org_id
string
required
​
workspace_id
string
required

Query Parameters

​
offset
integer
default:0

Number of records to skip

Required range: x >= 0
​
limit
integer
default:10

Number of records to return (max 100)

Required range: 1 <= x <= 100
​
sort_by
string | null

Field to sort by

​
sort_order
string | null

Sort order (asc or desc)

​
search
string | null

Search query string

Response

Successful Response

Paginated list of deployments.

​
items
DeploymentRecord · object[]
required

List of deployments on this page

​
total
integer
required

Total number of deployments matching the query

​
limit
integer
required

Maximum number of items per page

​
offset
integer
required

Number of items skipped

​
next_page_uri
string | null

URI to fetch the next page, or null if this is the last page

​
prev_page_uri
string | null

URI to fetch the previous page, or null if this is the first page