EchoStash
Docs

OpenAPI Spec

Full OpenAPI 3.0 specification

OpenAPI 3.0 Specification

PLP is defined as an OpenAPI 3.0 specification. The canonical spec includes YAML, Markdown, and JSON Schema formats in the PLP repository.

Endpoint Summary

  • GET /.well-known/plp — Discovery (capabilities, version)
  • GET /prompts — List prompts (paginated)
  • GET /prompts/{id} — Get latest version
  • GET /prompts/{id}/{version} — Get specific version
  • PUT /prompts/{id} — Create or update (upsert)
  • DELETE /prompts/{id} — Delete prompt
  • POST /prompts/{id}/publish — Publish a version
  • POST /prompts/{id}/deploy — Deploy to environment
  • POST /prompts/{id}/eval — Run eval suite
  • GET|POST|DELETE /context-store/* — Asset management
  • GET|POST|DELETE /prompts/{id}/context/* — Context mappings

Required vs Optional

Required: Discovery, GET prompt, PUT prompt, DELETE prompt

Optional: List, Publish, Deploy, Eval, Context Store. The discovery endpoint declares which capabilities a server supports.

Authentication

Bearer token via Authorization: Bearer <key>. Authentication is optional per the spec — servers may allow unauthenticated access to public prompts.

Status Codes

  • 200 — Success (update, get)
  • 201 — Created (new prompt)
  • 204 — Deleted
  • 404 — Not found
  • 409 — Conflict (version exists)