API Reference

curl -X GET "https://api.promptcask.com/api/v1/prompts?workspace_id=ws_abc123&limit=10" \
  -H "x-api-key: pk_live_xxxxx"

{
  "data": [
    {
      "id": "prompt_01h",
      "name": "Email Writer",
      "slug": "email-writer",
      "status": "active",
      "version": 3,
      "tags": [
        "marketing",
        "email"
      ],
      "created_at": "2026-02-10T08:00:00Z",
      "updated_at": "2026-03-01T14:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 42
  }
}

curl -X POST "https://api.promptcask.com/api/v1/prompts" \
  -H "x-api-key: pk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "name": "Bug Report Summarizer",
    "system_prompt": "You summarize bug reports into structured tickets.",
    "user_prompt_template": "Summarize this bug report: {{report}}",
    "tags": ["engineering", "bugs"]
  }'

{
  "id": "prompt_02x",
  "name": "Bug Report Summarizer",
  "slug": "bug-report-summarizer",
  "status": "draft",
  "version": 1,
  "created_at": "2026-03-15T10:00:00Z"
}

curl -X GET "https://api.promptcask.com/api/v1/skill-files?workspace_id=ws_abc123" \
  -H "x-api-key: pk_live_xxxxx"

{
  "data": [
    {
      "id": "skill_01a",
      "name": "code-review.skill.md",
      "description": "Reviews pull requests and suggests improvements",
      "version": 2,
      "created_at": "2026-01-15T09:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 8
  }
}

curl -X POST "https://api.promptcask.com/api/v1/skill-files" \
  -H "x-api-key: pk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "name": "deploy-checker.skill.md",
    "content": "# Deploy Checker\n\nChecks deployment readiness...",
    "description": "Validates deployment prerequisites"
  }'

{
  "id": "skill_02b",
  "name": "deploy-checker.skill.md",
  "version": 1,
  "created_at": "2026-03-15T10:00:00Z"
}

curl -X GET "https://api.promptcask.com/api/v1/plugins?workspace_id=ws_abc123&status=active" \
  -H "x-api-key: pk_live_xxxxx"

{
  "data": [
    {
      "id": "plugin_01",
      "name": "Slack Notifier",
      "type": "integration",
      "status": "active",
      "version": "1.2.0",
      "config": {
        "channel": "#prompts"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 3
  }
}

curl -X POST "https://api.promptcask.com/api/v1/plugins" \
  -H "x-api-key: pk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "plugin_id": "slack-notifier",
    "config": { "channel": "#prompts", "notify_on": ["publish", "approve"] }
  }'

{
  "id": "plugin_02",
  "name": "Slack Notifier",
  "status": "active",
  "installed_at": "2026-03-15T10:00:00Z"
}

curl -X GET "https://api.promptcask.com/api/v1/snippets?workspace_id=ws_abc123" \
  -H "x-api-key: pk_live_xxxxx"

{
  "data": [
    {
      "id": "snip_01",
      "name": "Brand Voice Guidelines",
      "slug": "brand-voice",
      "content": "Always maintain a professional yet approachable tone...",
      "usage_count": 47,
      "created_at": "2026-01-20T12:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 15
  }
}

curl -X POST "https://api.promptcask.com/api/v1/snippets" \
  -H "x-api-key: pk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "name": "Safety Disclaimer",
    "content": "This AI-generated content should be reviewed by a human before use.",
    "tags": ["compliance"]
  }'

{
  "id": "snip_02",
  "name": "Safety Disclaimer",
  "slug": "safety-disclaimer",
  "created_at": "2026-03-15T10:00:00Z"
}

curl -X GET "https://api.promptcask.com/api/v1/logs?workspace_id=ws_abc123&prompt_id=prompt_01h&limit=5" \
  -H "x-api-key: pk_live_xxxxx"

{
  "data": [
    {
      "id": "log_01",
      "prompt_id": "prompt_01h",
      "model": "gpt-4o",
      "input_tokens": 245,
      "output_tokens": 512,
      "latency_ms": 1830,
      "status": "success",
      "created_at": "2026-03-14T16:45:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 5,
    "total": 128
  }
}

curl -X POST "https://api.promptcask.com/api/v1/logs" \
  -H "x-api-key: pk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "prompt_id": "prompt_01h",
    "model": "gpt-4o",
    "input_tokens": 200,
    "output_tokens": 450,
    "latency_ms": 1500,
    "status": "success"
  }'

{
  "id": "log_02",
  "created_at": "2026-03-15T10:00:00Z"
}

curl -X POST "https://api.promptcask.com/api/v1/search" \
  -H "x-api-key: pk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "query": "how to write professional emails",
    "types": ["prompt", "snippet"],
    "limit": 5
  }'

{
  "results": [
    {
      "type": "prompt",
      "id": "prompt_01h",
      "name": "Email Writer",
      "excerpt": "You are a professional email writer...",
      "similarity": 0.92
    },
    {
      "type": "snippet",
      "id": "snip_03",
      "name": "Email Tone Guidelines",
      "excerpt": "When writing professional emails, always...",
      "similarity": 0.85
    }
  ]
}

curl -X GET "https://api.promptcask.com/api/v1/outcomes?workspace_id=ws_abc123&prompt_id=prompt_01h" \
  -H "x-api-key: pk_live_xxxxx"

{
  "data": [
    {
      "id": "outcome_01",
      "log_id": "log_01",
      "prompt_id": "prompt_01h",
      "result": "pass",
      "score": 0.95,
      "criteria": "Follows brand voice guidelines",
      "created_at": "2026-03-14T17:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 64
  }
}

curl -X POST "https://api.promptcask.com/api/v1/outcomes" \
  -H "x-api-key: pk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "log_id": "log_01",
    "result": "pass",
    "score": 0.95,
    "criteria": "Output follows brand guidelines and is factually accurate"
  }'

{
  "id": "outcome_02",
  "created_at": "2026-03-15T10:00:00Z"
}

curl -X POST "https://api.promptcask.com/api/v1/feedback" \
  -H "x-api-key: pk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "log_id": "log_01",
    "rating": 4,
    "comment": "Good output but slightly too formal for our brand voice",
    "tags": ["accurate", "too_formal"]
  }'

{
  "id": "fb_01",
  "created_at": "2026-03-15T10:00:00Z"
}