Generate editable Prompt demonstrations without saving

POST
/v1/scopes/{scope_id}/prompts/{prompt_key}/demonstrations

Generate exactly the requested number of typed input/output suggestions for a supported built-in operation. The caller must explicitly create or replace a Prompt Artifact to save suggestions. Requires scope.admin, matching Prompt creation and replacement.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer credential resolved to an opaque authenticated Principal by the Server deployment.

In: header

Path Parameters

scope_id*string
Match.*\S.*
Length1 <= length <= 256
prompt_key*string

Value in

  • "memory.extract"
  • "memory.rerank"
  • "experience.incubate"
  • "experience.generate"
  • "skill.generate"
  • "handoff.generate"
  • "profile.generate"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/scopes/string/prompts/memory.extract/demonstrations" \  -H "Content-Type: application/json" \  -d '{    "instructions": "string",    "demonstration_count": 1  }'
{  "prompt_key": "memory.extract",  "demonstrations": [    {      "input": null,      "expected_output": null    }  ]}

Read scoped Prompt configuration and built-in defaults GET

Read one saved Prompt head and the current Runtime's built-in instructions without creating a revision or calling inference. Auto selects the built-in instructions even when an Auto revision exists. Disabled built-in operations remain readable; effective and builtin are null for externally managed components. Status describes availability, not whether returning the configured text executes it. A saved head additionally requires its Artifact read permission. artifact_etag is the condition for replacing that Artifact; it is not an ETag for this combined view.

Get the authenticated Principal and Access capabilities GET

Next Page