Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/HelenaLM32/ECHO/llms.txt

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

The venues API lets venue managers list, register, and update physical spaces on ECHO. Public GET endpoints require no authentication and can be used by any client to browse available venues. Endpoints that create or modify venue records require a valid Bearer token in the Authorization header. See Authenticate with the ECHO API for details on obtaining a token.
The base URL for all endpoints on a local development server is http://localhost:8084. Replace this with your deployed API URL in production.

​
Get all venues

GET /venues
Returns a list of all venues registered on ECHO. This endpoint is public and requires no authentication.

​
Example

curl -X GET http://localhost:8084/venues

​
Response fields

​
id
number
required
Unique identifier for the venue.
​
name
string
required
Display name of the venue.
​
address
string
required
Physical address of the venue.
​
capacity
number
Maximum occupancy of the venue.
​
telefono
string
Contact phone number.
​
email
string
Contact email address.
​
sitioWeb
string
Venue website URL.
​
horario
string
Opening hours as a free-text string (e.g., Lun-Vie 10:00-20:00).
​
images
string[]
List of URLs for uploaded venue photos. Up to 3 images.

​
Get venues by manager

GET /venues/user/{userId}
Returns all venues managed by a specific user. This endpoint is public.

​
Path parameters

​
userId
number
required
The numeric ID of the venue manager.

​
Example

curl -X GET http://localhost:8084/venues/user/7

​
Get venue by ID

GET /venues/{id}
Returns a single venue record by its numeric ID. This endpoint is public.

​
Path parameters

​
id
number
required
The numeric ID of the venue to retrieve.

​
Example

curl -X GET http://localhost:8084/venues/12

​
Error codes

StatusMeaning
404No venue exists with the given ID.

​
Create venue

POST /venues
Registers a new venue on ECHO. The request must use multipart/form-data encoding to support image uploads. Authentication is required.
Up to 3 images can be attached by repeating the images field. Accepted formats are JPEG and PNG.

​
Form parameters

​
name
string
required
Display name of the venue.
​
address
string
required
Full physical address of the venue.
​
capacity
number
Maximum occupancy. Omit if unknown.
​
telefono
string
Contact phone number for the venue.
​
email
string
Contact email address for the venue.
​
sitioWeb
string
Venue website URL.
​
horario
string
Opening hours as a free-text string (e.g., Lun-Vie 10:00-20:00).
​
images
file[]
One or more image files to associate with the venue. Repeat this field for each file. Up to 3 images are supported.

​
Example

curl -X POST http://localhost:8084/venues \
  -H "Authorization: Bearer <token>" \
  -F "name=Galería Moderna" \
  -F "address=Carrer de l'Art 12, Barcelona" \
  -F "capacity=150" \
  -F "telefono=+34 93 123 4567" \
  -F "email=info@galeriamoderna.es" \
  -F "sitioWeb=https://galeriamoderna.es" \
  -F "horario=Lun-Vie 10:00-20:00" \
  -F "images=@/path/to/photo1.jpg" \
  -F "images=@/path/to/photo2.jpg"

​
Error codes

StatusMeaning
400Missing required fields or invalid data.
401No valid authentication token provided.

​
Update venue

PUT /venues/{id}
Replaces the venue record with the provided data. Uses multipart/form-data to allow image replacement. Authentication is required.

​
Path parameters

​
id
number
required
The numeric ID of the venue to update.

​
Form parameters

​
name
string
Updated display name.
​
address
string
Updated physical address.
​
capacity
number
Updated maximum occupancy.
​
telefono
string
Updated contact phone number.
​
email
string
Updated contact email address.
​
sitioWeb
string
Updated website URL.
​
horario
string
Updated opening hours string.
​
images
file[]
Replacement image files. Repeat this field for each file. Up to 3 images are supported.

​
Example

curl -X PUT http://localhost:8084/venues/12 \
  -H "Authorization: Bearer <token>" \
  -F "name=Galería Moderna Renovada" \
  -F "capacity=200"

​
Error codes

StatusMeaning
401No valid authentication token provided.
403Not authorized to update this venue.
404No venue exists with the given ID.

​
Delete venue

DELETE /venues/{id}
Permanently removes a venue from ECHO. Authentication is required.
This action is irreversible. Deleting a venue also removes all associated events and reviews.

​
Path parameters

​
id
number
required
The numeric ID of the venue to delete.

​
Example

curl -X DELETE http://localhost:8084/venues/12 \
  -H "Authorization: Bearer <token>"

​
Error codes

StatusMeaning
401No valid authentication token provided.
403Not authorized to delete this venue.
404No venue exists with the given ID.

Build docs developers (and LLMs) love

Get started for freeTalk to us