Agents

Update outbound prompt

Update an existing outbound prompt

put/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

Path parameters

agentIdstring required
Example:jm1u1cawc7dka1x84mrjvb4y

Unique identifier for the agent

promptIdstring required
Example:prompt_abc123

Unique identifier for the outbound prompt

Request body

titlestring

Updated title

instructionsstring

Updated instructions

openingstring nullable

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"}}

personaNamestring nullable

Name the assistant gives on this prompt (GPT-Live voice card)

businessNamestring nullable

Business this prompt calls for, as spoken (GPT-Live voice card)

voicePromptstring nullable

Optional hand-written prompt for the GPT-Live voice model on this outbound prompt's calls, opening line included; the full prompt still drives the backend. Empty or null clears it

singlePrompt'null' nullable

null stops using the single prompt (set in the portal), leaving instructions, voicePrompt and opening as they are

Response

Outbound prompt updated successfully

messagestring

Example response

{
  "data": {
    "id": "prompt_abc123",
    "title": "Updated Appointment Confirmation",
    "instructions": "Call {{firstName}} to confirm their appointment at {{appointmentTime}}. Be professional and courteous.",
    "agentId": "jm1u1cawc7dka1x84mrjvb4y",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-15T00:00:00.000Z"
  },
  "message": "Outbound prompt updated successfully"
}

Changes

No recorded changes to this operation across all 1 revision of this API.