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.

Universities are the top-level institutions in UniEvents. Each university contains one or more faculty tenants, which in turn own spaces, events, and users. Universities are publicly discoverable — no authentication is required to read them. When a university is created or renamed, a unique URL slug is automatically generated from the name. Note that deleting a university with associated tenants will fail; remove or reassign all dependent tenants first.

​
GET /api/universities

Returns all universities registered in the platform, ordered by creation date (newest first). Authentication: Not required. 
curl "https://your-domain.com/api/universities"
200 Response 
[
  {
    "id": "univ_uuid",
    "name": "Universidad Central de Venezuela",
    "slug": "universidad-central-de-venezuela",
    "description": "La universidad más antigua y prestigiosa de Venezuela.",
    "logoUrl": "https://cdn.supabase.io/storage/v1/object/public/logos/ucv.png",
    "createdAt": "2024-12-01T08:00:00.000Z"
  }
]
​
id
string
UUID of the university.
​
name
string
Full display name of the university. Must be unique across the platform.
​
slug
string | null
URL-safe identifier auto-generated from the university name.
​
description
string | null
Optional description of the institution.
​
logoUrl
string | null
Public URL for the university’s logo image.
​
createdAt
string (ISO 8601)
Timestamp when the university record was created.

​
POST /api/universities

Creates a new university. A unique slug is automatically generated from the name field. Authentication: Not required at the route level. Content-Type: application/json
​
name
string
required
Full name of the university. Must be unique across the platform.
​
description
string
Optional description or tagline for the institution.
​
logoUrl
string
Public URL pointing to the university’s logo image.
curl -X POST "https://your-domain.com/api/universities" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Universidad Simón Bolívar",
    "description": "Universidad tecnológica de excelencia ubicada en Sartenejas, Caracas.",
    "logoUrl": "https://cdn.supabase.io/storage/v1/object/public/logos/usb.png"
  }'
201 Response 
{
  "id": "univ_uuid_new",
  "name": "Universidad Simón Bolívar",
  "slug": "universidad-simon-bolivar",
  "description": "Universidad tecnológica de excelencia ubicada en Sartenejas, Caracas.",
  "logoUrl": "https://cdn.supabase.io/storage/v1/object/public/logos/usb.png",
  "createdAt": "2025-08-21T09:15:00.000Z"
}

​
GET /api/universities/{id}

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

​
PUT /api/universities/{id}

Updates an existing university. Only the 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 university to update.
​
name
string
Updated display name. Triggers slug regeneration if provided.
​
description
string
Updated description text.
​
logoUrl
string
Updated logo URL.
curl -X PUT "https://your-domain.com/api/universities/univ_uuid" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "La universidad más antigua de Venezuela, fundada en 1721."
  }'
200 Response — The updated university object.

​
DELETE /api/universities/{id}

Permanently deletes a university. If the university has associated tenants (faculties), the database constraint will prevent deletion and the API returns a 400 error. Authentication: Not required at the route level.
​
id
string
required
UUID of the university to delete.
curl -X DELETE "https://your-domain.com/api/universities/univ_uuid"
200 Response — Returns the deleted university object on success. 400 Response — Returned when the university cannot be deleted due to existing tenant associations. 
{
  "error": "No se pudo eliminar. Verifique que no tenga facultades asociadas."
}

Build docs developers (and LLMs) love

Get started for freeTalk to us