Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Edfermachado/proyectoSistemas/llms.txt

Use this file to discover all available pages before exploring further.

Tenants are the faculty or departmental organizations that own events, spaces, and users within UniEvents. Each tenant belongs to a university and can optionally be tagged with a category. When a tenant is created or its name is updated, a unique URL slug is automatically generated from the name. Tenants are the central multi-tenancy boundary — all events, spaces, and non-superadmin users are scoped to a specific tenant.

​
GET /api/tenants

Returns all tenants across all universities, ordered by creation date (newest first). Authentication: Not required. 
curl "https://your-domain.com/api/tenants"
200 Response 
[
  {
    "id": "tnt_uuid",
    "name": "Facultad de Ingeniería",
    "slug": "facultad-de-ingenieria",
    "description": "Facultad de Ingeniería y Tecnología de la Universidad Central.",
    "universityId": "univ_uuid",
    "categoryId": "cat_uuid",
    "createdAt": "2025-01-15T10:00:00.000Z"
  }
]
​
id
string
UUID of the tenant.
​
name
string
Display name of the faculty or department. Must be unique across the platform.
​
slug
string | null
URL-safe identifier auto-generated from the tenant name.
​
description
string | null
Optional description of the faculty.
​
universityId
string | null
UUID of the parent university this tenant belongs to.
​
categoryId
string | null
UUID of the category that classifies this faculty (e.g. Sciences, Humanities).
​
createdAt
string (ISO 8601)
Timestamp when the tenant was created.

​
POST /api/tenants

Creates a new tenant. A unique slug is generated automatically from the name field. Authentication: Not required at the route level. Content-Type: application/json
​
name
string
required
Display name of the new tenant. Must be unique across the platform.
​
description
string
Optional description of the faculty or department.
​
universityId
string
UUID of the university this tenant belongs to.
​
categoryId
string
UUID of the category to classify the tenant.
curl -X POST "https://your-domain.com/api/tenants" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Facultad de Ciencias",
    "description": "Facultad de Ciencias Naturales y Matemáticas.",
    "universityId": "univ_uuid",
    "categoryId": "cat_uuid"
  }'
201 Response 
{
  "id": "tnt_uuid_new",
  "name": "Facultad de Ciencias",
  "slug": "facultad-de-ciencias",
  "description": "Facultad de Ciencias Naturales y Matemáticas.",
  "universityId": "univ_uuid",
  "categoryId": "cat_uuid",
  "createdAt": "2025-08-20T11:30:00.000Z"
}

​
GET /api/tenants/{id}

Returns a single tenant by UUID. Authentication: Not required.
​
id
string
required
UUID of the tenant to retrieve.
curl "https://your-domain.com/api/tenants/tnt_uuid"
200 Response — Single tenant object with the same fields as the list response above. 404 Response 
{ "error": "Not found" }

​
PUT /api/tenants/{id}

Updates an existing tenant. Only fields included in the request body are modified. If name is updated, the slug is automatically regenerated. Authentication: Not required at the route level. Content-Type: application/json
​
id
string
required
UUID of the tenant to update.
​
name
string
Updated display name. Triggers slug regeneration if provided.
​
description
string
Updated description text.
​
categoryId
string
Updated category UUID.
curl -X PUT "https://your-domain.com/api/tenants/tnt_uuid" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Facultad de Ciencias Exactas, Naturales y Matemáticas.",
    "categoryId": "cat_uuid_new"
  }'
200 Response — The updated tenant object.

​
DELETE /api/tenants/{id}

Permanently deletes a tenant. Ensure that all associated users, spaces, and events are removed or reassigned before deletion to avoid orphaned records. Authentication: Not required at the route level.
​
id
string
required
UUID of the tenant to delete.
curl -X DELETE "https://your-domain.com/api/tenants/tnt_uuid"
204 Response — No content. Deletion was successful.

Build docs developers (and LLMs) love

Get started for freeTalk to us