ROroarkhq
Agent

Set an agent's prompt

Changed on

Sets the agent's API-managed prompt. This is its own version history (source: API_MANAGED), separate from prompts observed on calls, edited in the app, or managed by config-as-code. Setting the same content twice is a no-op (no new version). Roark does not run your agent and no metric reads this prompt: it is stored and versioned for your reference.

put/v1/agent/{agentId}/prompts

Request

  • Base URL
    https://api.roark.ai
  • URL
    https://api.roark.ai/v1/agent/{agentId}/prompts
  • Auth
    HTTP bearer

Path parameters

agentIdstring uuid required

Request body

promptstring required

The prompt content to set.

Response

The prompt was set (or already matched the current version).

Changes