> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usefini.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get prompts

> Fetch the current merged prompts for one agent.

Returns the current prompt configuration for one agent as a merged view of the workspace template plus the agent's latest saved prompt version.

<Note>
  If the agent has no saved prompt version yet, this route still returns prompt content by falling back to the workspace template. In that case, the metadata comes from the template prompt, but `botId` is still the requested agent ID.
</Note>

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token containing your Fini workspace API key. Format: `Bearer fini_...` The key needs `read` scope.
</ParamField>

## Path parameters

<ParamField path="id" type="string" required>
  Agent ID whose prompts you want to read. Use [List agents](/en/api-reference/list-agents) to get the `botId`.
</ParamField>

## Response

Returns one merged [`Prompt`](/en/api-reference/prompts#prompt-object) object.

## Errors

<AccordionGroup>
  <Accordion title="401 Unauthorized" icon="lock">
    The API key is missing, malformed, revoked, or invalid.
  </Accordion>

  <Accordion title="403 Forbidden" icon="shield-halved">
    The API key does not include the `read` scope required for this route.
  </Accordion>

  <Accordion title="404 Not Found" icon="ghost">
    The agent ID does not exist.
  </Accordion>

  <Accordion title="406 Not Acceptable" icon="circle-question">
    Current controller behavior: if the agent belongs to a different workspace, this route returns `406` with an invalid-agent message rather than `403`.
  </Accordion>

  <Accordion title="500 Internal Server Error" icon="triangle-exclamation">
    Fini failed while loading the prompt data from storage.
  </Accordion>
</AccordionGroup>