REST API

Selu exposes an HTTP API on port 3000 by default. This API is primarily used by the web UI itself and is not a full public REST API. There is no OpenAPI spec and no versioned URL prefix.

Base URL

http://localhost:3000/api

Authentication

All endpoints (except the health check) require an active session cookie. Log in through the /login page in your browser to obtain a session. There are no API tokens or Bearer headers.

Caution

Because authentication relies on session cookies, calling these endpoints from scripts or external tools requires you to first authenticate through the login flow and forward the resulting session cookie.

Endpoints

Health

Method	Path	Auth	Description
GET	/api/health	No	Health check. Returns server status.

Pipes (channels)

Method	Path	Auth	Description
GET	/api/pipes	Yes	List all configured pipes.
POST	/api/pipes	Yes	Create a new pipe.
DELETE	/api/pipes/{pipe_id}	Yes	Delete a pipe.

LLM providers

Method	Path	Auth	Description
GET	/api/providers	Yes	List available LLM providers.
PUT	/api/providers/{id}/key	Yes	Set the API key for a provider.
PUT	/api/providers/{id}/region	Yes	Set the region for a provider.

Credentials — system

Method	Path	Auth	Description
GET	/api/credentials/system/{capability_id}	Yes	List system credentials for a capability.
PUT	/api/credentials/system/{capability_id}/{name}	Yes	Set a system credential.
DELETE	/api/credentials/system/{capability_id}/{name}	Yes	Delete a system credential.

Credentials — user

Method	Path	Auth	Description
GET	/api/credentials/user/{user_id}/{capability_id}	Yes	List user credentials for a capability.
PUT	/api/credentials/user/{user_id}/{capability_id}/{name}	Yes	Set a user credential.
DELETE	/api/credentials/user/{user_id}/{capability_id}/{name}	Yes	Delete a user credential.

Tool policies

Method	Path	Auth	Description
GET	/api/tool-policies	Yes	List tool policies.
PUT	/api/tool-policies	Yes	Bulk set tool policies.
DELETE	/api/tool-policies	Yes	Delete a user tool policy.

Approvals

Method	Path	Auth	Description
GET	/api/approvals	Yes	List pending tool approvals.
POST	/api/approvals/{id}	Yes	Resolve (approve or deny) a pending approval.