---
title: "Call Guest Link"
method: POST
path: "/api/voice/calls/{call_id}/guest-link"
tags: ["voice-control", "voice-control"]
---

# Call Guest Link

`POST /api/voice/calls/{call_id}/guest-link`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/voice/calls/{call_id}/guest-link`
- Auth: none declared

Mint (or fetch) a guest link for a LIVE channel call.

The same row shape a native meeting uses — `voice_share_token`, role
`guest` — but keyed by the CALL id rather than a persistent meeting code,
because a phone call has no code and cannot be revived: the link is worth
something only while the line is open, and `/public/meetings/{token}/join`
refuses it with 409 once the call ends.

Idempotent by default: a second caller gets the link that already exists,
so the button can be pressed twice without quietly invalidating the link
a colleague is holding.

## Path parameters

- `call_id` string, required

## Request body

- CallGuestLinkRequest: Optional body. `reset` revokes every existing link for this call and mints a fresh one — the escape hatch for a link that reached the wrong person, mirroring the meeting's own reset.
  - `reset` boolean

## Response `200`

Successful Response

- CallGuestLinkResponse
  - `token` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/d84e7dc9977d?raw)