Sign in

v172

OpenAPI 3.1.0raw.githubusercontent.com2026-08-0826148911.7 MB
Prompts

Update a prompt

patch/v2/prompts/{id}

Path parameters

idstring required

Unique identifier of the prompt

Unique identifier of the prompt

Request body

ownerstring
domain_idstring uuid
createdstring
updatedstring
created_by_idstring uuid nullable
updated_by_idstring uuid nullable
display_namestring

The prompt’s name, meant to be displayable in the UI.

descriptionstring nullable

The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose

pathstring

Entity storage path.

With workspace-level API keys, use the format project/folder/subfolder/.... The first element identifies the project, followed by nested folders (auto-created as needed). Example: Default/agents.

With project-level API keys, the project is predetermined by the API key, so the path is relative to that project. Example: agents. For backward compatibility, a leading project name is ignored when it matches the scoped project.

Example request

{
  "prompt": {
    "model": "anthropic/claude-3-5-sonnet-20241022",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant"
      },
      {
        "role": "user",
        "content": "Hello!"
      }
    ],
    "temperature": 0.5
  },
  "path": "Default"
}

Response

Prompt updated.

_idstring required
type'prompt' required
ownerstring required
domain_idstring uuid required
createdstring required
updatedstring required
created_by_idstring uuid nullable
updated_by_idstring uuid nullable
display_namestring required

The prompt’s name, meant to be displayable in the UI.

descriptionstring nullable

The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose

Example response

{
  "prompt_config": {
    "messages": [
      {
        "content": [
          {
            "image_url": {
              "url": "https://picsum.photos/id/1/200/300"
            }
          }
        ]
      }
    ]
  },
  "prompt": {
    "fallbacks": [
      {
        "model": "openai/gpt-4o-mini"
      }
    ],
    "retry": {
      "count": 3,
      "on_codes": [
        429,
        500,
        502,
        503,
        504
      ]
    },
    "cache": {
      "ttl": 3600
    },
    "load_balancer": {
      "type": "weight_based",
      "models": [
        {
          "model": "openai/gpt-4o",
          "weight": 0.7
        },
        {
          "model": "anthropic/claude-3-5-sonnet",
          "weight": 0.3
        }
      ]
    },
    "timeout": {
      "call_timeout": 30000
    },
    "model": "openai/gpt-4o"
  }
}