> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Organization's Service Versions

> Retrieve a list of available versions for a specified service within an organization.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="org_id" type="string" required>
  The unique identifier of the organization.
</ParamField>

<ParamField path="service" type="string" required>
  The name of the service whose versions you want to retrieve.\
  <br />Valid values: `"api_server"`, `"ws_server"`
</ParamField>

### Response

<ResponseField name="data" type="object">
  Contains the list of available versions for the requested service.
</ResponseField>

<ResponseField name="data.versions" type="array">
  An array of available versions.
</ResponseField>

<ResponseField name="data.versions[].id" type="string">
  The unique identifier of the version.
</ResponseField>

<ResponseField name="data.versions[].friendly_name" type="string">
  A human-readable name for the version.
</ResponseField>

<ResponseField name="data.versions[].created_at" type="string (ISO 8601)">
  The timestamp when the version was created.
</ResponseField>

<ResponseField name="data.versions[].git_sha" type="string">
  The Git SHA hash of the version.
</ResponseField>

<ResponseField name="data.versions[].tags" type="array">
  Tags categorizing the version, e.g., `["latest"]`, `["stable"]`.
</ResponseField>

<ResponseField name="data.versions[].currently_supported" type="boolean">
  Whether this version is currently supported.
</ResponseField>

<ResponseField name="data.versions[].recommended_upgrade_to" type="string | null">
  The recommended version to upgrade to, if applicable.
</ResponseField>

<ResponseField name="data.versions[].service" type="string">
  The name of the service this version belongs to.
</ResponseField>

<ResponseField name="data.versions[].placement_group" type="string">
  The placement group of this version.
</ResponseField>

<ResponseField name="errors" type="null">
  Always `null` on success.
</ResponseField>

<ResponseExample>
  ```json Response   theme={null}
  {
    "data": {
      "versions": [
        {
          "created_at": "2024-11-28T19:05:17.003Z",
          "git_sha": "",
          "friendly_name": "Latest",
          "tags": ["latest"],
          "currently_supported": true,
          "recommended_upgrade_to": null,
          "service": "api_server",
          "id": "adf1064d-5080-4055-8493-0d4fdc3c8106",
          "placement_group": "blandshared"
        },
        {
          "created_at": "2024-11-27T00:28:30.286Z",
          "git_sha": "",
          "friendly_name": "v1.0.1",
          "tags": ["stable"],
          "currently_supported": true,
          "recommended_upgrade_to": null,
          "service": "api_server",
          "id": "a46f516b-b01f-4ea6-9c7b-5b05fca49d4f",
          "placement_group": "blandshared"
        }
      ]
    },
    "errors": null
  }

  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)