monorepo/cloud/maplepress-backend/docs/API/create-tenant.md

Create Tenant

POST /api/v1/tenants

Create a new tenant (organization).

Authentication: Required (JWT Bearer token)

Headers:

• Content-Type: application/json
• Authorization: JWT {access_token}

Request Body:

Field	Type	Required	Description
name	string	Yes	Tenant/organization name
slug	string	Yes	URL-friendly tenant identifier

Example Request:

curl -X POST http://localhost:8000/api/v1/tenants \
  -H "Content-Type: application/json" \
  -H "Authorization: JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -d '{
    "name": "TechStart Inc",
    "slug": "techstart"
  }'

Example Response (201 Created):

{
  "id": "850e8400-e29b-41d4-a716-446655440000",
  "name": "TechStart Inc",
  "slug": "techstart",
  "status": "active",
  "created_at": "2024-10-24T00:00:00Z"
}

Error Responses:

This endpoint returns errors in RFC 9457 (Problem Details for HTTP APIs) format.

Content-Type: application/problem+json

400 Bad Request - Invalid input:

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid request body format"
}

401 Unauthorized - Missing or invalid JWT token:

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authentication required"
}

409 Conflict - Tenant slug already exists:

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "detail": "Tenant slug already exists"
}

500 Internal Server Error:

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Failed to create tenant"
}