Skip to main content

​
List active prompts

GET /api/prompts
Returns the active version of every prompt in a project. There is one prompt per pipeline step, and exactly one version of each prompt is active at a time.

​
Query parameters

​
projectSlug
string
The project slug. Required if projectId is not provided.
​
projectId
string
The project UUID. Required if projectSlug is not provided.

​
Response

{
  "prompts": [
    {
      "id": "uuid",
      "stepId": "classify",
      "content": "You are a helpful classifier...",
      "outputSchema": { "type": "object", "properties": { ... } },
      "createdAt": "2026-04-01T12:00:00.000Z",
      "updatedAt": "2026-04-08T09:30:00.000Z"
    }
  ]
}

​
Example

curl "https://app.artanis.ai/api/prompts?projectSlug=my-project" \
  -H "x-api-key: $ARTANIS_API_KEY" \
  -H "x-org-slug: my-org"

​
Get a prompt with version history

GET /api/prompts/{promptId}
Returns a single prompt and every version of it (active and inactive), oldest first.

​
Path parameters

​
promptId
string
required
The prompt UUID.

​
Response

{
  "id": "uuid",
  "stepId": "classify",
  "outputSchema": { ... },
  "versions": [
    {
      "id": "uuid",
      "content": "...",
      "isActive": false,
      "createdAt": "2026-03-01T00:00:00.000Z"
    },
    {
      "id": "uuid",
      "content": "...",
      "isActive": true,
      "createdAt": "2026-04-01T00:00:00.000Z"
    }
  ]
}
Use the list endpoint to discover prompt IDs, then call the detail endpoint for full version history when you need to diff versions.