Overview Tesslate Studio exposes a REST API through FastAPI. All endpoints are served from the Orchestrator backend. Authenticated endpoints require a valid JWT token (via Authorization: Bearer {token} header) or an HTTP-only session cookie.
This reference organizes every endpoint by router. For each endpoint, you will find the HTTP method, path, a brief description, and whether authentication is required.
Visit http://localhost:8000/docs (local) or https://your-domain/docs (production) to access the interactive Swagger UI, which includes live request testing and schema documentation.
Auth Endpoints Authentication, registration, and session management.
Method Path Description Auth POST /api/auth/registerRegister a new user (email + password) No POST /api/auth/loginLogin with email and password (returns JWT) No POST /api/auth/logoutLogout and invalidate session Yes POST /api/auth/forgot-passwordRequest password reset email No POST /api/auth/reset-passwordReset password using token from email No POST /api/auth/verifyVerify email address No GET /api/auth/google/authorizeInitiate Google OAuth login No GET /api/auth/google/callbackGoogle OAuth callback handler No GET /api/auth/github/authorizeInitiate GitHub OAuth login No GET /api/auth/github/callbackGitHub OAuth callback handler No POST /api/auth/2fa/verifyVerify 2FA email code No POST /api/auth/2fa/resendResend 2FA verification code No POST /api/auth/verify-pod-accessVerify pod access token (K8s internal) No
User Endpoints User profile management.
Method Path Description Auth GET /api/users/meGet current user profile Yes PATCH /api/users/meUpdate current user profile Yes GET /api/users/{id}Get user public profile No
Project Endpoints Project CRUD, file operations, container management, and assets.
Project Management Method Path Description Auth GET /api/projectsList user’s projects Yes POST /api/projectsCreate a new project Yes GET /api/projects/{id}Get project details Yes PATCH /api/projects/{id}Update project metadata Yes DELETE /api/projects/{id}Delete a project Yes GET /api/projects/{id}/statusGet project container status Yes
Container Lifecycle Method Path Description Auth POST /api/projects/{id}/startStart project containers Yes POST /api/projects/{id}/stopStop project containers Yes POST /api/projects/{id}/restartRestart project containers Yes POST /api/projects/{id}/containersAdd a container to the project Yes DELETE /api/projects/{id}/containers/{container_id}Remove a container Yes PATCH /api/projects/{id}/containers/{container_id}Update container config Yes POST /api/projects/{id}/containers/{container_id}/startStart a single container Yes POST /api/projects/{id}/containers/{container_id}/stopStop a single container Yes
File Operations Method Path Description Auth GET /api/projects/{id}/filesList all project files Yes GET /api/projects/{id}/files/{path}Read a file Yes PUT /api/projects/{id}/files/{path}Write/update a file Yes DELETE /api/projects/{id}/files/{path}Delete a file Yes POST /api/projects/{id}/files/renameRename/move a file Yes POST /api/projects/{id}/files/directoryCreate a directory Yes
Assets Method Path Description Auth GET /api/projects/{id}/assetsList project assets Yes POST /api/projects/{id}/assetsUpload an asset Yes DELETE /api/projects/{id}/assets/{asset_id}Delete an asset Yes
Connections and Previews Method Path Description Auth GET /api/projects/{id}/connectionsList container connections Yes POST /api/projects/{id}/connectionsCreate a container connection Yes DELETE /api/projects/{id}/connections/{conn_id}Delete a connection Yes GET /api/projects/{id}/previewsList browser previews Yes POST /api/projects/{id}/previewsCreate a browser preview Yes DELETE /api/projects/{id}/previews/{preview_id}Delete a preview Yes
Snapshots Method Path Description Auth GET /api/projects/{id}/snapshotsList project snapshots (timeline) Yes POST /api/projects/{id}/snapshotsCreate a manual snapshot Yes POST /api/projects/{id}/snapshots/{snapshot_id}/restoreRestore from snapshot Yes
Chat Endpoints AI agent chat management and streaming.
Method Path Description Auth GET /api/chat/history/{project_id}Get chat history for a project Yes GET /api/chat/{chat_id}Get a specific chat with messages Yes POST /api/chat/streamStream agent response (SSE) Yes POST /api/chat/cancelCancel an in-progress agent run Yes DELETE /api/chat/{chat_id}Delete a chat Yes WS /api/chat/ws/{chat_id}WebSocket for real-time chat Yes
Git Endpoints Git operations executed inside project containers.
Method Path Description Auth POST /api/git/initInitialize a Git repository Yes POST /api/git/cloneClone a repository into project Yes POST /api/git/commitStage and commit changes Yes POST /api/git/pushPush commits to remote Yes POST /api/git/pullPull changes from remote Yes GET /api/git/status/{project_id}Get Git status (changed files) Yes GET /api/git/branches/{project_id}List branches Yes POST /api/git/checkoutCheckout a branch Yes
Git Provider Endpoints Multi-provider Git integration (GitHub, GitLab, Bitbucket).
Method Path Description Auth GET /api/git-providers/providersList connected Git providers Yes GET /api/git-providers/{provider}/reposList repositories from provider Yes POST /api/git-providers/{provider}/connectConnect a Git provider (OAuth) Yes DELETE /api/git-providers/{provider}/disconnectDisconnect a Git provider Yes
Deployment Endpoints External deployments to Vercel, Netlify, and Cloudflare.
Method Path Description Auth GET /api/deployments/{project_id}List deployments for a project Yes POST /api/deploymentsCreate a new deployment Yes POST /api/deployments/deploy-allDeploy all containers in a project Yes GET /api/deployments/{deployment_id}/statusGet deployment status Yes DELETE /api/deployments/{deployment_id}Delete a deployment record Yes
Deployment Credentials Method Path Description Auth GET /api/deployment-credentialsList connected deployment providers Yes POST /api/deployment-credentialsStore deployment credentials Yes DELETE /api/deployment-credentials/{id}Remove deployment credentials Yes
Deployment OAuth Method Path Description Auth GET /api/deployment-oauth/{provider}/authorizeInitiate OAuth for deployment provider Yes GET /api/deployment-oauth/{provider}/callbackOAuth callback handler Yes
Marketplace Endpoints Browse, purchase, and manage AI agents and project templates.
Agents Method Path Description Auth GET /api/marketplace/agentsBrowse marketplace agents Optional GET /api/marketplace/agents/{slug}Get agent details Optional POST /api/marketplace/agentsPublish a new agent Yes PATCH /api/marketplace/agents/{id}Update an agent Yes DELETE /api/marketplace/agents/{id}Delete an agent Yes POST /api/marketplace/agents/{id}/purchasePurchase an agent Yes POST /api/marketplace/agents/{id}/forkFork an agent Yes GET /api/marketplace/agents/{id}/reviewsGet agent reviews Optional POST /api/marketplace/agents/{id}/reviewsSubmit a review Yes
Bases (Project Templates) Method Path Description Auth GET /api/marketplace/basesList project templates Optional GET /api/marketplace/bases/browseBrowse with pagination and filters Optional GET /api/marketplace/bases/{slug}Get base details Optional GET /api/marketplace/bases/{slug}/versionsList available git tag versions Optional POST /api/marketplace/basesSubmit a new base Yes GET /api/marketplace/bases/{id}/reviewsGet base reviews Optional POST /api/marketplace/bases/{id}/reviewsSubmit a review Yes
User Library Method Path Description Auth GET /api/marketplace/library/agentsList purchased agents Yes GET /api/marketplace/library/basesList purchased bases Yes
Billing Endpoints Subscription management, credits, and usage tracking.
Method Path Description Auth GET /api/billing/subscriptionGet current subscription details Yes POST /api/billing/checkoutCreate Stripe checkout session Yes POST /api/billing/portalCreate Stripe customer portal session Yes GET /api/billing/creditsGet credit balance Yes POST /api/billing/credits/purchasePurchase credit package Yes GET /api/billing/usageGet usage history Yes POST /api/webhooks/stripeStripe webhook handler No
Admin Endpoints Platform administration (requires superuser role).
Method Path Description Auth GET /api/admin/metricsPlatform-wide metrics Superuser GET /api/admin/usersList all users Superuser GET /api/admin/users/{id}Get user details Superuser PATCH /api/admin/users/{id}Update user (ban, change tier) Superuser GET /api/admin/projectsList all projects Superuser GET /api/admin/agentsList all marketplace agents Superuser PATCH /api/admin/agents/{id}Moderate an agent Superuser
Theme Endpoints Public theme API (no authentication required).
Method Path Description Auth GET /api/themesList all available themes No GET /api/themes/{id}Get theme details No
Additional Endpoints Shell Sessions Method Path Description Auth POST /api/shell/sessionsCreate a shell session Yes WS /api/shell/ws/{session_id}WebSocket for terminal I/O Yes DELETE /api/shell/sessions/{id}Close a shell session Yes
Secrets (Environment Variables) Method Path Description Auth GET /api/secrets/{project_id}List project secrets Yes POST /api/secrets/{project_id}Set a secret Yes DELETE /api/secrets/{project_id}/{key}Delete a secret Yes
Kanban (Task Board) Method Path Description Auth GET /api/kanban/{project_id}Get kanban board Yes POST /api/kanban/{project_id}/columnsCreate a column Yes PATCH /api/kanban/{project_id}/columns/{id}Update a column Yes DELETE /api/kanban/{project_id}/columns/{id}Delete a column Yes POST /api/kanban/{project_id}/tasksCreate a task Yes PATCH /api/kanban/{project_id}/tasks/{id}Update a task Yes DELETE /api/kanban/{project_id}/tasks/{id}Delete a task Yes POST /api/kanban/{project_id}/tasks/{id}/commentsAdd a comment Yes
Background Tasks Method Path Description Auth GET /api/tasks/{task_id}Get background task status Yes
Feedback Method Path Description Auth GET /api/feedbackList feedback posts Yes POST /api/feedbackSubmit feedback Yes POST /api/feedback/{id}/upvoteUpvote a post Yes POST /api/feedback/{id}/commentsComment on a post Yes
Referrals and Creators Method Path Description Auth GET /api/referrals/codeGet user’s referral code Yes POST /api/referrals/applyApply a referral code Yes GET /api/creators/dashboardCreator program dashboard Yes POST /api/creators/payoutRequest creator payout Yes
Health and Configuration Method Path Description Auth GET /healthBackend health check No GET /api/configPublic config (deployment mode, app domain) No
Common Response Patterns
{ "id" : "550e8400-e29b-41d4-a716-446655440000" , "name" : "My App" , "slug" : "my-app-k3x8n2" , "created_at" : "2026-01-09T12:00:00Z" , "status" : "running" }
{ "detail" : "Project not found" }
Common status codes:
400 Bad Request (invalid input, validation errors)401 Unauthorized (authentication required)403 Forbidden (insufficient permissions)404 Not Found (resource does not exist)422 Unprocessable Entity (Pydantic validation error)500 Internal Server Error (unexpected server error)
{ "items" : [ ... ], "total" : 42 , "page" : 1 , "total_pages" : 3 }
List endpoints support pagination via skip and limit query parameters (or page and limit for marketplace browse endpoints). 
