REST API Overview - Artanis API

Base URL

https://app.artanis.ai

For self-hosted deployments, substitute your own host.

Every list endpoint requires you to identify which project to read from. You can pass either:

Query parameter	Example	When to use
`projectSlug`	`?projectSlug=my-project`	Most cases — the slug is stable and human-readable
`projectId`	`?projectId=4f8c...`	When you already have the internal UUID

Detail endpoints (e.g. GET /api/prompts/{id}) take the resource ID directly in the path and do not need a project parameter.

All endpoints return JSON. List endpoints wrap their results in a top-level key matching the resource name:

{
  "prompts": [ ... ]
}

Detail endpoints return the resource object directly:

{
  "id": "...",
  "stepId": "...",
  ...
}

Timestamps are ISO 8601 strings in UTC.

Status	Body	Cause
`400`	`{"error": "projectSlug or projectId is required"}`	Missing required query param
`401`	`{"error": "Not authenticated"}`	Missing or invalid credentials
`403`	`{"error": "Forbidden"}`	Resource does not belong to your organization
`404`	`{"error": "Not found"}`	Resource does not exist

Active prompt versions and version history

Knowledge base documents and version history

Traces, spans, approved outputs, and feedback