---
title: "Get the prompt for an agent"
method: POST
path: "/api/v1/agentic/agents/prompt"
tags: ["Agentic - Agents"]
---

# Get the prompt for an agent

`POST /api/v1/agentic/agents/prompt`

## Request

- Base URL: `https://api.voicelogica.ai`
- URL: `https://api.voicelogica.ai/api/v1/agentic/agents/prompt`
- Auth: API key in header `x-api-key`

Get the prompt for an agent

## Headers

- `x-api-key` string, required
- `x-company-id` string

## Response `200`

Prompt retrieved successfully

- object
  - `prompt` string, required: Main/systemic system prompt (agent.systemPrompt)
  - `additionalCallSystemPrompt` string: Additional call instructions from phone settings (agentPhoneSettings.systemPrompt). During calls both are merged at runtime.
  - `agentId` string: The agent ID. If not provided the default agent will be used
  - `destination` 'prod' | 'version': Where the prompt was written (update only)
  - `agentVersionId` string: Saved version id when destination was "version"
  - `versionNumber` number: Saved version number when destination was "version"
  - `promptCharacters` string: Prompt size against the plan cap, e.g. "18420/20000". A write over the cap is REJECTED and nothing is saved, so check this before composing a longer prompt.
  - `promptCharactersRemaining` number: Characters still available before the plan cap is hit. Negative means the prompt would be rejected.
  - `promptBudgetHint` string: Present only when prompt space is running low: tells you to move reference content to a knowledge file with add_knowledge_text instead of growing the prompt.

## Other responses

- `401`: Unauthorized
- `403`: Invalid CSRF
- `404`: Agent not found
- `429`: Rate limit exceeded
- `500`: Internal Server Error

---

[API](https://skmtc.dev/voicelogica/apis/voice-logica-api.md) · [All operations](https://skmtc.dev/voicelogica/apis/voice-logica-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voicelogica/apis/voice-logica-api/revisions/30f76840084e?raw)