API Reference
Projects API
Create and list projects and API keys.
List projects
GET /api/projectsAuth: Clerk session required
Response:
{
"projects": [
{
"id": "683012345abcdef01234567",
"name": "My Portfolio",
"createdAt": "2026-05-20T10:00:00.000Z"
}
]
}Create project
POST /api/projectsAuth: Clerk session required
Body:
{ "name": "My New Project" }Validation: Name must be 2–60 characters.
Response (201):
{
"projectId": "683012345abcdef01234567",
"apiKey": "mtr_a1b2c3d4e5f6..."
}The full API key is only returned once during creation.
List API keys
GET /api/projects/keys?projectId=683012345abcdef01234567Auth: Clerk session required
Response:
{
"keys": [
{
"id": "683012345abcdef01234568",
"label": "Default",
"keyPreview": "mtr_a1b2...ef01",
"createdAt": "2026-05-20T10:00:00.000Z",
"lastUsedAt": "2026-05-23T08:30:00.000Z"
}
]
}Create API key
POST /api/projects/keysAuth: Clerk session required
Body:
{
"projectId": "683012345abcdef01234567",
"label": "Production Key"
}Response (201):
{ "apiKey": "mtr_new_key_value_here..." }