Skip to main content
GET
Python

Authorizations

Authorization
string
header
required

Project API key (sk-kupe-...) or a Supabase user JWT.

Response

200 - application/json

Successful Response

Caller identity derived from the verified Principal.

API keys are always scoped to one org + project, so SDK clients can list agents without the caller passing those IDs. JWT (dashboard) callers are not project-scoped; org_id and project_id are null.

auth
enum<string>
required

Credential type: project API key (sk-kupe-...) or a Supabase user JWT.

Available options:
api_key,
jwt
org_id
string | null
required

Org scoped to this API key. Null for JWT callers.

project_id
string | null
required

Project scoped to this API key. Null for JWT callers.

user_id
string | null
required

Supabase user id. Set for JWT callers.

api_key_id
string | null
required

API key row id. Set for API-key callers.