---
title: "Get outbound prompt"
method: GET
path: "/agents/{agentId}/outbound-prompts/{promptId}"
tags: ["Agents"]
---

# Get outbound prompt

`GET /agents/{agentId}/outbound-prompts/{promptId}`

## Request

- Base URL: `https://api.telvana.com`
- URL: `https://api.telvana.com/agents/{agentId}/outbound-prompts/{promptId}`
- Auth: API key in header `x-api-key`

Retrieve a specific outbound prompt by ID

## Path parameters

- `agentId` string, required
- `promptId` string, required

## Response `200`

Outbound prompt retrieved successfully

- object
  - `data` object
    - `id` string, required: Unique identifier for the outbound prompt
    - `title` string, required: Title of the outbound prompt
    - `instructions` string, required: Instructions/prompt for outbound calls
    - `opening` string, nullable, required: Exact opening line for GPT-Live voices; {{variables}} allowed, and the line may choose between two texts by comparing a variable with a number, as {{count < 2 ? "text when under two" : "text otherwise, {{count}} allowed here too"}}
    - `personaName` string, nullable, required: Name the assistant gives on this prompt
    - `businessName` string, nullable, required: Business this prompt calls for, as spoken
    - `scope` string, nullable, required: What this prompt helps with, derived from it
    - `voiceCardEdited` boolean, required: True once this card was edited by hand
    - `voicePrompt` string, nullable, required: Hand-written GPT-Live voice prompt for this outbound prompt, opening line included; replaces the voice card for the voice model
    - `singlePrompt` string, nullable, required: This prompt in the single-prompt template; while set, instructions, voicePrompt and opening are rendered from it
    - `agentId` string, required: ID of the agent this prompt belongs to
    - `createdAt` string, date-time, required: Creation timestamp
    - `updatedAt` string, date-time, required: Last update timestamp

## Other responses

- `401`: Unauthorized - Invalid API key
- `404`: Agent or outbound prompt not found

---

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