API Reference
The Pia Cloud API is hosted at cloud.pia-ai.de and provides authentication, conversation sync, and AI proxy endpoints.
Base URL
Section titled “Base URL”https://cloud.pia-ai.deAuthentication
Section titled “Authentication”All authenticated endpoints require a Bearer token in the Authorization header:
Authorization: Bearer <jwt-token>POST /api/auth/register
Section titled “POST /api/auth/register”Create a new account.
POST /api/auth/login
Section titled “POST /api/auth/login”Authenticate and receive a JWT token.
Conversations
Section titled “Conversations”GET /api/conversations
Section titled “GET /api/conversations”List synced conversations.
POST /api/conversations/sync
Section titled “POST /api/conversations/sync”Upload encrypted conversation data.
Health
Section titled “Health”GET /health
Section titled “GET /health”Returns 200 OK if the server is running.