Tenants API

Maintained by: Aether365 Team Audience: Developers Scope: Tenant API endpoints - reading and updating tenant configuration

Get Current Tenant

Returns the authenticated tenant's profile and plan information.

GET /tenants/me

Example Request

curl https://api.aether365.io/tenants/me \
  -H "Authorization: Bearer <token>"

Example Response

{
  "success": true,
  "data": {
    "id": "t_abc123",
    "email": "admin@example.com",
    "companyName": "Example Corp",
    "planTier": "pro",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-04-01T08:30:00Z"
  }
}

Response Fields

Field	Type	Description
id	string	Tenant identifier
email	string	Account owner email
companyName	string	Company name (derived from email domain)
planTier	string	Current plan: free, pro, enterprise
createdAt	string	ISO 8601 timestamp of account creation
updatedAt	string	ISO 8601 timestamp of last update

---

Update Tenant Profile

Updates the tenant's display name.

PATCH /tenants/me

Request Body

{
  "companyName": "Acme Security Ltd"
}

Field	Type	Required	Description
companyName	string	No	Display name for the tenant

Example Request

curl -X PATCH https://api.aether365.io/tenants/me \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"companyName": "Acme Security Ltd"}'

Example Response

{
  "success": true,
  "data": {
    "id": "t_abc123",
    "email": "admin@example.com",
    "companyName": "Acme Security Ltd",
    "planTier": "pro",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-04-10T12:00:00Z"
  }
}