Privacidad y analítica
Utilizamos cookies técnicas necesarias y, solo si das tu consentimiento, analítica y pixels de marketing para mejorar la web y medir campañas.
Métodos, autenticación, escrituras, idempotencia, paginación y errores.
Actualizado el 1 de enero de 1970
Todo lo que se puede hacer dentro de una marca en Nömad está definido una sola vez como capacidad. La misma capacidad la usa Nödo en el chat, un agente externo por MCP y una integración por HTTP. Hay 532 capacidades en 26 apartados; 530 ya están disponibles y el resto se activa por fases.
Estado. Las capacidades marcadas «Disponible» funcionan hoy por HTTP con claves con alcances, por MCP y a través de Nödo, todas por la misma puerta de permisos. Las demás se activan por fases; esta página se genera del código y cambia con él.
Cada capacidad es un método: POST a su id con un cuerpo JSON que lleva la marca y la entrada. La respuesta es JSON con la salida tipada.
curl https://app.nomad.ooo/api/v1/works.list \
-H "Authorization: Bearer nmu_live_v1_…" \
-H "Content-Type: application/json" \
-d '{ "brand": "BRD-8C1TZA", "status": "active", "limit": 10 }'{
"data": {
"items": [{ "id": "…", "name": "Identidad visual", "status": "in_progress", "dueDate": null,
"progress": { "done": 3, "total": 7 }, "waitingOnBrand": 1 }],
"nextCursor": null
}
}Toda respuesta correcta es { "data": … }. Cada respuesta lleva X-Request-Id (cítalo si escribes a soporte), X-Nomad-Api-Version y RateLimit con lo que te queda del minuto. Un error es application/problem+json (RFC 9457) con un code estable.
nmu_live_v1_…, en tu cuenta › Desarrolladores. Actúan como tú, solo con los permisos y las marcas que elijas.nmw_live_v1_…, en el workspace › Desarrolladores. Una identidad de la organización con su propio acceso a las marcas: sigue funcionando aunque quien la creó se vaya.POST /api/credentials/revoke y se revoca, sin iniciar sesión.El campo brand acepta el identificador corto (BRD-8C1TZA) o el UUID. Para saber qué marcas puede usar un token, llama a brands.list o a GET /api/v1/me.
Con un token, una escritura se hace al momento, como si la hiciera su titular en la app: es tu integración. Los agentes externos (Claude, ChatGPT…) entran por MCP y siguen la política de agentes de la marca: solo consultar, con aprobación de la persona o directo.
Envía Idempotency-Key (8 a 128 caracteres) en cada escritura que puedas reintentar: la misma clave con la misma entrada responde una sola vez durante 24 horas (Idempotent-Replayed: true en la repetición) y con otra entrada responde idempotency_conflict.
Toda escritura con expectedRevision falla con revision_conflict si el registro cambió entretanto: vuelve a leer y reintenta.
Las listas devuelven items y nextCursor. Pasa cursor para la siguiente página; limit va de 1 a 50.
Cada error tiene un code estable, su estado HTTP y, cuando ayuda, detail (el permiso que falta) o issues (los campos). Un rechazo por uso trae además usage y message, una frase que puedes enseñar tal cual. La lista completa está en Errores.
HTTP/1.1 403 Forbidden
Content-Type: application/problem+json
{
"type": "https://docs.nomad.ooo/en/api/errors#error-insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "works.write",
"request_id": "…"
}Los cambios son aditivos: campos nuevos opcionales y capacidades nuevas. Un id publicado no cambia de significado; si hay que sustituirlo, el antiguo se mantiene mientras se anuncia el nuevo.