API Reference

REST API base URL: https://api.mlpipeline-cloud.com/v1

Authentication

All requests require an API key in the Authorization header:

Authorization: Bearer <your-api-key>

Prompts

GET /prompts

List all prompts in your workspace.

curl https://api.mlpipeline-cloud.com/v1/prompts \
  -H "Authorization: Bearer $API_KEY"

POST /prompts

Create a new prompt version.

{
  "name": "customer-support/greeting",
  "template": "Hello {{ customer_name }}...",
  "model": "claude-3-sonnet",
  "parameters": {"temperature": 0.7}
}

GET /prompts/{name}

Retrieve a prompt by name.

PUT /prompts/{name}

Update a prompt (creates a new version).

DELETE /prompts/{name}

Archive a prompt.

Executions

POST /executions

Execute a prompt with variables.

{
  "prompt_name": "customer-support/greeting",
  "variables": {"customer_name": "Alice"}
}

GET /executions/{id}

Retrieve execution details including tokens, cost, latency.

Evaluations

POST /evaluations

Schedule an evaluation run.

GET /evaluations/{id}

Get evaluation results.

Webhooks

POST /webhooks

DELETE /webhooks/{id}

Remove a webhook.

Error responses

All errors return JSON:

{
  "error": {
    "code": "invalid_request",
    "message": "Prompt name is required"
  }
}

Status codes: 200, 201, 400, 401, 404, 429, 500.