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.

Categories define the creative disciplines that organize content on ECHO. Every item, service, and project belongs to a category. Both endpoints are public — no authentication is required to browse categories. Use the slug field to build filtered marketplace URLs or to reference a specific discipline in your integration.
Categories are managed by ECHO administrators. The list below reflects the seeded categories available on every ECHO instance. Additional categories may be added over time.

​
Get all categories

GET /categories Returns all active and inactive categories. 
curl -X GET http://localhost:8084/categories
Response 
[
  {
    "id": 1,
    "name": "Diseño Gráfico",
    "slug": "graphic-design",
    "description": "Graphic design and visual communication services.",
    "iconUrl": "https://cdn.example.com/icons/graphic-design.svg",
    "isActive": true
  }
]
​
id
number
required
Unique identifier for the category.
​
name
string
required
Display name of the category. Unique across all categories. Maximum 100 characters.
​
slug
string
required
URL-friendly identifier for the category. Unique across all categories. Use this value to filter or link to category-specific pages (e.g., /marketplace?category=graphic-design).
​
description
string
A short description of the creative discipline.
​
iconUrl
string
URL of the category icon. Maximum 255 characters.
​
isActive
boolean
required
Whether the category is currently active on the marketplace. Inactive categories are hidden from public-facing filters.

​
Get category by ID

GET /categories/{id} Returns a single category by its numeric ID.
​
id
number
required
The numeric ID of the category to retrieve.
curl -X GET http://localhost:8084/categories/1
Response 
{
  "id": 1,
  "name": "Diseño Gráfico",
  "slug": "graphic-design",
  "description": "Graphic design and visual communication services.",
  "iconUrl": "https://cdn.example.com/icons/graphic-design.svg",
  "isActive": true
}

​
Seeded categories

The following categories are pre-loaded on every ECHO instance. Use their slugs when filtering content or assigning categories to items and services.
NameSlug
Diseño Gráficographic-design
Fotografíaphotography
Ilustraciónillustration
Arte 3D3d-art
Arquitecturaarchitecture
Modafashion
Comiccomic
Producción Musicalmusic-production
Video y Ediciónvideo-editing
When creating a service, the category field accepts the category name as a string (e.g., "Diseño Gráfico"). When registering an item, use the numeric category_id instead. See Items and Services for details.

Build docs developers (and LLMs) love

Get started for freeTalk to us