# API Authentication & Reference

> Understand HTTP REST API boundaries and JWT authorization headers.

- **Category**: Platform & Reference
- **Last Verified**: 2026-07-14

Kubeletto offers a complete JSON REST API at `https://api.kubeletto.com/v1`. Authentication requires passing an Authorization bearer header.

## Authentication Header

```http
Authorization: Bearer kl_secret_xxxxxxxxxxxxxxxxxxxxxxxx
```

## Core Routes Reference

| Method | Endpoint | Description |
| --- | --- | --- |
| GET | /v1/projects | List all tenant projects. |
| POST | /v1/projects | Create a new project. |
| GET | /v1/services/:id | Get service runtime status. |
| POST | /v1/deployments | Trigger a container deployment. |
| GET | /v1/logs/stream | SSE stream for container output. |