API Reference
Use the Promptic API to manage AI Components, optimize prompts, inspect traces, evaluate results, and deploy the configuration that performs best for your data.
Get started
The production API is available at:
https://promptic.eu/api/v1Create an API key from AI Application settings → API Keys, then send it as a Bearer token. Each API key is scoped to one AI Application.
curl https://promptic.eu/api/v1/components \
-H "Authorization: Bearer $PROMPTIC_API_KEY"Authentication
Create credentials and authenticate API or SDK requests.
Pagination
Page through list endpoints with limit and offset.
Errors
Understand status codes and structured error responses.
OpenAPI schema
Download the complete OpenAPI 3.1 specification.
Explore endpoints
AI Application
Get current AI application GET
Retrieve details for the authenticated AI application.
List AI applications GET
List all AI applications for the current user.
Components
List all components GET
Retrieve all AI components in your AI application.
Create a component POST
Create a new AI component to organize prompts and traces.
Get a component GET
Retrieve details for a specific component.
Experiments
Create a tool-selection experiment POST
Atomically configure tools, cases, prompt settings, and evaluation.
Create an experiment POST
Set up a new prompt optimization experiment.
Start an experiment POST
Start a pending experiment to begin optimization.
Duplicate an experiment POST
Clone an experiment with its dataset cases and evaluators; optionally seed from the source's best optimized prompt.
Get best iteration GET
Retrieve the highest-scoring iteration.
Evaluators & Dataset cases
Create evaluator(s) POST
Add evaluation criteria to score prompt performance.
Create dataset case(s) POST
Add canonical JSON inputs and optional expected outputs for training and evaluation.
Deployment
Deploy experiment POST
Deploy an optimized experiment to a component.
Get deployed prompt GET
Retrieve the currently deployed prompt, model, and score.
Traces
List traces GET
Query traces with filtering by status, component, and time range.
Ingest OTLP traces POST
Send OpenTelemetry trace data in JSON or protobuf format.
Get tracing stats GET
Get aggregated tracing statistics for your AI application.
Storage
Create a presigned upload POST
Reserve a storage object and get a short-lived direct-upload descriptor.
Complete a direct upload
Validate the uploaded file and record its actual size.
Get a download URL GET
Return a short-lived signed GET URL for a storage object.
Artifacts
List artifacts for a trace GET
List the artifacts referenced by a trace's spans.
Upload an artifact POST
Register an artifact from a storage object or inline base64 content.
Get artifact metadata GET
Retrieve metadata and a content URL for an artifact.
Download artifact content GET
Redirect to a short-lived provider URL for the artifact bytes.