Update the current user’s tenant name and/or slug. Requires a valid JWT access token. The tenant is resolved from the authenticated user — no tenant ID is needed in the URL.

• Both name and slug are required in the request body.
• The slug must be unique across all tenants in the system.
• The slug must be lowercase alphanumeric characters and hyphens only (pattern: ^[a-z0-9-]+$).
• Only the tenant owner can update the tenant.
• Returns the full updated tenant on success.

sequenceDiagram
    actor User

    User->>+FE: fills Tenant Settings form

    FE->>FE: validate form
    alt form is invalid
        FE-->>User: show error messages <br> disable submit button
    end

    User->>FE: submits Tenant Settings form

    FE->>+BE: PUT /api/v1/tenant <br> Authorization: Bearer {accessToken} <br> UpdateTenantRequest

    BE->>BE: validate request
    alt request is invalid
        BE-->>FE: 400 Bad Request <br> ErrorResponse
    end

    BE->>BE: resolve tenant from JWT
    alt access token missing or invalid
        BE-->>FE: 401 Unauthorized <br> ErrorResponse
    end

    BE->>DB: check if slug is taken by another tenant
    alt slug already taken
        BE-->>FE: 409 Conflict <br> ErrorResponse
    end

    BE->>DB: UPDATE tenant SET name, slug, updated_at

    BE->>-FE: 200 OK <br> TenantResponse

    FE->>-User: show success message, display updated settings

PUT /api/v1/tenant UpdateTenantRequest:

{
  "name": "Míra's Studio",
  "slug": "mira-studio"
}

200 OK TenantResponse:

{
  "data": {
    "id": 1,
    "name": "Míra's Studio",
    "slug": "mira-studio",
    "createdAt": "2026-04-01T08:00:00Z",
    "updatedAt": "2026-04-29T10:00:00Z"
  }
}

400 Bad Request (validation) ErrorResponse:

{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Validation failed",
  "errors": [
    { "field": "slug", "message": "must match ^[a-z0-9-]+$" }
  ]
}

401 Unauthorized (missing or invalid access token) ErrorResponse:

{
  "status": 401,
  "code": "AUTHENTICATION_FAILED",
  "message": "Access token is missing or invalid"
}

409 Conflict (slug already taken) ErrorResponse:

{
  "status": 409,
  "code": "CONFLICT_TENANT",
  "message": "Slug is already taken by another tenant"
}

Frontend

Validations

Backend

Validations

Test Cases