API docs.

Modularis Agents tiene una API REST completa para todo lo que hace el portal. Si querés integrar tu propio backend, esto es lo que necesitás saber.

Versión interactiva en Swagger: https://agents.modularis.pro/api-docs — OpenAPI 3.0 con cada endpoint, schemas y "try it out".

Autenticación

Todas las llamadas requieren tu tenant_token (lo generaste al signup, empieza con mt_). Mandalo por header:

X-API-Key: mt_a96218eb90ba5b20d439eb2c24014e2e26c99100

O como query param: ?token=mt_...

GET /tenants/me

Devuelve info de tu tenant: empresa, plan, cuota usada, subscription_status, trial_ends_at.

GET /tenants/{key}/prompt/template/active

POST /tenants/{key}/prompt/template

Get del prompt vigente. POST crea una versión nueva (rollback disponible).

GET /tenants/{key}/secrets

PUT /tenants/{key}/secrets/{secret_key}

DELETE /tenants/{key}/secrets/{secret_key}

Los valores se cifran con Fernet antes de guardarse. Nunca exponemos el plaintext en logs.

GET /tenants/{key}/variables

PUT /tenants/{key}/variables/{var_key}

agent_name, company_name, currency, etc. — placeholders del prompt.

GET /tenants/{key}/catalog

POST /tenants/{key}/catalog

POST /tenants/{key}/catalog/import-csv

POST /tenants/{key}/catalog/sync-shopify

POST /tenants/{key}/catalog/search

CRUD + bulk import + búsqueda híbrida (semantic pgvector + full-text Spanish).

POST /tenants/{key}/storage/upload

GET /tenants/{key}/storage/files

GET /tenants/{key}/storage/usage

500MB por defecto. JPEG, PNG, WebP, GIF. Quota atómica vía UPDATE...RETURNING.

GET /tenants/{key}/conversations

GET /tenants/{key}/conversations/{id}/turns

Listado paginado + detalle de turnos con tool_calls del agente.

POST /agent/webhook/{tenant_key}?webhook_secret={secret}

Recibe mensajes de UltraMSG / Meta Cloud. Verifica firma + procesa con Claude tool_use + responde.

Si querés que tu propio backend sincronice con cambios de billing, podemos configurar un endpoint custom — escribínos a hola@modularis.pro.

Early access: el SDK oficial (Python + Node) está en beta. Si lo querés probar, escribínos.