---
title: "Test call with version config"
method: POST
path: "/agent/{id}/versions/{versionId}/test-call"
tags: ["Agent Versioning - Versions"]
deprecated: true
---

# Test call with version config

`POST /agent/{id}/versions/{versionId}/test-call`

> **Deprecated.**

**Deprecated.** Test-calls are exempt from the v1 write-block and remain functional. Migrate to `POST /agent/{id}/branches/{branchId}/test-call` with `revisionId`. Will be removed at the sunset date.

|
Initiate a test call using a specific published version's configuration.
The response always includes `conversationId` and `callId`. For `webcall`
and `chat`, it also includes `token`, `roomName`, and `host`. Those fields
are omitted for `telephony`.

## Path parameters

- `id` string, required
- `versionId` string, required

## Request body

- TestCallRequest
  - `mode` 'webcall' | 'chat' | 'telephony' — Test call mode. Defaults to `webcall` when omitted.
  - `toPhone` string — Phone number to call. Required only when `mode` is `telephony`. Omit for `webcall` and `chat`.

## Response `200`

Test call initiated

- object
  - `status` boolean
  - `data` object
    - `conversationId` string, required — Conversation ID created for the test call
    - `callId` string, required — Call ID created for the test call
    - `token` string — Returned for webcall and chat modes only
    - `roomName` string — Returned for webcall and chat modes only
    - `host` string — Returned for webcall and chat modes only

## Other responses

- `400` — Invalid input
- `401` — Unauthorized access
- `403` — Forbidden. Returned for workflow_graph agents when the organization lacks conversational agents access.
- `404` — Agent or version not found
- `500` — Internal server error

## Changes

- **2026-07-23** `a9c928635312` — 1 breaking, 1 info
  - added the pattern `^[a-f\d]{24}$` to the `path` request parameter `id`
  - endpoint deprecated
- **2026-07-17** `4f549f4b38c5` — 1 info
  - endpoint reactivated
- **2026-07-17** `f6ed52db5f7c` — 1 info
  - endpoint deprecated
- **2026-05-26** `5a6b4e19f353` — 7 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the optional property `data/host` to the response with the `200` status
  - added the optional property `data/roomName` to the response with the `200` status
  - …3 more
- **2026-04-20** `801f1d220d57` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smallest-inc/apis/agent-management-api/changes/agent/:id/versions/:versionId/test-call/post.md)

---

[API](https://skmtc.dev/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.dev/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/274a178284a4/schema)