---
title: "Get Signed Url"
method: GET
path: "/v1/convai/conversation/get-signed-url"
tags: ["Agents Platform"]
---

# Get Signed Url

`GET /v1/convai/conversation/get-signed-url`

Get a signed url to start a conversation with an agent with an agent that requires authorization

## Query parameters

- `agent_id` string, required — Agent id (agent_…) or speech engine external id (seng_), resolved to the same underlying resource.
- `include_conversation_id` boolean — Whether to include a conversation_id with the response. If included, the conversation_signature cannot be used again.
- `branch_id` string, nullable — The ID of the branch to use
- `environment` string, nullable — The environment to use for resolving environment variables (e.g. 'production', 'staging'). Defaults to 'production'.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- ConversationSignedUrlResponseModel
  - `signed_url` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/e77a0a530a82/schema)