Tools de ops
El worklist compartido (board/backlog/sprints). Estas tools operan sobre tu propia identidad — el gateway te autentica una sola vez y cada llamada respeta tu scope y los proyectos a los que tenés acceso. No hace falta llamarlas por nombre: pedile a Claude lo que querés en castellano ("mostrame lo que está bloqueado en el proyecto X") y elige la tool sola.
Índice completo de las 83 tools de los cuatro dominios: Todas las tools. Otros dominios: analytics. Cómo conectarte primero: Conectar.
Qué significa "permiso" acá
Dos capas, siempre las dos aplican:
-
Scope del token — read
solo puede consultar; write además
crea/edita/asigna/borra, con un techo: un ítem raíz
(sin
parent_id) no puede cerrarse endoneconwrite— el tope esto_be_human_reviewed, ydoneen la raíz es de Daniel. Una subtask (conparent_id) sí puede cerrarsedoneconwrite. admin no tiene techo — no se ofrece por OAuth, solo lo llevan tokens de máquina. -
Filtro real por proyecto — además del scope, ops
filtra cada lectura y escritura contra
ops.mcp_authz: ves y tocás solo los ítems/sprints de los proyectos a los que tenés acceso (o todos, si sos global-admin real). El scope del token nunca amplía esto — solo puede restringir más.
Tools de ops (65)
| Tool | Qué hace | Inputs | Permiso | Ejemplo de prompt |
|---|---|---|---|---|
ops_list |
Lista ítems del worklist, filtrados y devueltos como texto + array estructurado. Acotado por default: sin limit devuelve a lo sumo 200 ítems (nunca el board entero) y, si trunca, lo avisa en el texto con el after_id de la próxima página. |
epica?, status? (backlog/todo/wip/blocked/to_be_human_reviewed/done), owner?, sprint_id? (-1=todos, 0=backlog, N=sprint puntual), limit? (default 200, máx 1000), after_id? (id del último ítem visto, para paginar) |
read alcanza. Filtrado por ops.mcp_authz: solo ves los proyectos a los que tenés acceso. |
"Mostrame los ítems en wip del proyecto AI Factory." |
ops_add |
Crea un ítem nuevo (crea la épica si no existe). | epica/lane, title, status?, owner?, repo?, links?, priority? (P0/P1/P2), parent_id?, plan_ref?, agent_role?, seniority?, sprint_id?, seq_order?, pipeline_type?, custom_fields? (dispatch_mode/ticket_type/qa_verified), project_id? |
write o admin. En un ítem raíz no podés crearlo ya en done con write. El project_id resuelto se valida contra tu authz. |
"Creá un ítem en la épica dynamo llamado 'Revisar el deploy de QA', prioridad P1." |
ops_update |
Actualiza los campos de un ítem existente (solo los que mandás). | id, status?, owner?, title?, repo?, blocker_note?, links?, append_note?, priority?, parent_id?, plan_ref?, agent_role?, seniority?, epica?/lane?, sprint_id?, seq_order?, pipeline_type?, custom_fields? (dispatch_mode/ticket_type/qa_verified) |
write o admin. Mismo techo done en raíz que ops_add. Reparentar un ítem para esquivar ese techo (sacarlo de raíz o promover una subtask a raíz) también requiere admin. |
"Marcá el ítem 761 como blocked con la nota 'esperando decisión de Daniel'." |
ops_assign |
Asigna un ítem a un owner (atajo de ops_update). |
id, owner |
write o admin. Filtrado por proyecto igual que ops_update. |
"Asigná el ítem 42 a mid." |
ops_delete |
Borra un ítem y todas sus notas, de forma permanente. | id |
write o admin. Es irreversible — la validación de proyecto corre antes de borrar. | "Borrá el ítem de prueba 999." |
ops_sprints |
Lista todos los sprints con sus fechas, si están activos y cuántos ítems tiene cada uno. | ninguno | read alcanza. Mismo filtro por proyecto que ops_list. |
"¿Qué sprint está activo ahora mismo?" |
ops_sprint_activate |
Deprecada — hoy es un no-op. El sprint activo se
deriva de start_date/end_date, ya no
de un flag que alguien prende. Para mover cuál está activo, editá las
fechas con ops_sprint_update. Sigue en la superficie para
no romper a quien la llame, y contesta explicando eso. |
sprint_id? (ignorado) |
No escribe nada, así que read le alcanza. | "Activá el sprint 5." → te va a redirigir a ops_sprint_update. |
ops_sprint_add |
Crea un sprint nuevo, con fechas opcionales. Sin project_id, cae al proyecto default (mismo criterio que ops_add); con project_id: null explícito, crea un sprint GLOBAL (visible a todos los proyectos). |
name, start_date? (YYYY-MM-DD), end_date? (YYYY-MM-DD), project_id? (nombre, uuid, o null para global) |
write o admin. Un sprint GLOBAL (project_id: null) solo lo puede pedir un caller admin. |
"Creá el Sprint 11 del proyecto AI Factory, del 10 al 24 de agosto." |
ops_render |
Renderiza el board completo a markdown. En el gateway el path se ignora — siempre te devuelve el markdown como contenido, nunca escribe a disco. |
path? (ignorado acá — solo tiene efecto en el MCP local, ver Para desarrolladores) |
read alcanza. Filtrado por proyecto igual que ops_list. |
"Renderizame el board completo." |
ops_projects |
Lista los PROYECTOS que ves — id, nombre y si están dentro de tu entitlement. Es la forma de descubrir valores válidos para project/project_id en vez de adivinar un nombre. |
ninguno | read alcanza. Devuelve solo lo tuyo: es el catálogo de tu propio acceso. | "¿A qué proyectos tengo acceso?" |
ops_notes |
Lee el historial de notas de un ítem, de la más vieja a la más nueva. Ahí viven los bloques ## FIX REQUERIDO del loop de autorreparación, los HANDOFF, la explicación de un blocker y las notas de cierre. |
id, limit? |
read alcanza. Filtrado por proyecto igual que ops_list. |
"¿Por qué está bloqueado el ítem 761? Leeme sus notas." |
ops_attachments |
Lista los adjuntos de un ítem — solo metadata: id, nombre, tipo, tamaño y quién lo subió. Nunca los bytes: el binario no viaja por MCP, así que sirve para saber que un ticket trae archivos que no podés leer. | item_id |
read alcanza. | "¿El ítem 812 tiene archivos adjuntos?" |
ops_generate_chain |
Genera la cadena de subtasks de un ítem raíz que todavía no tiene hijos, según su pipeline_type/ticket_type. Es idempotente: si la raíz ya tiene subtasks, no hace nada. |
id |
write o admin — crea ítems, mismo gate que ops_add. |
"Generá la cadena de subtasks del ítem 766." |
ops_epic_upsert |
Crea o renombra una ÉPICA, o la mueve a otro proyecto. Jerarquía: proyecto > épica > ítem. Sin id crea; con id edita. Es la única forma de renombrar o mover una épica — ops_add solo puede crearla implícitamente por nombre. |
id?, name, project_id? |
write o admin. | "Renombrá la épica 'dynamo' a 'Dynamo Core'." |
ops_epic_archive |
Archiva (o desarchiva) una ÉPICA. Archivarla la saca del board y de la cola del dispatcher, pero no borra nada: sus ítems siguen existiendo y se abren por id. archived=false la trae de vuelta. |
id, archived? |
write o admin. Reversible. | "Archivá la épica 'migracion-vieja'." |
ops_epic_list |
Lista las ÉPICAS de un proyecto con su id — el que piden ops_epic_upsert y ops_epic_archive. Por default solo las activas; con include_archived=true también las archivadas, que es como encontrás una para desarchivarla. Incluye las épicas globales. |
project_id?, include_archived? |
read alcanza. | "¿Qué épicas archivadas tiene el proyecto AI Factory?" |
ops_taxonomy_list |
Lista los catálogos de un proyecto: los valores de taxonomía (dri, status, role, seniority) y los de campos custom (cf:hito y compañía). |
project_id? |
read alcanza. | "¿Qué hitos hay definidos en el proyecto AI Factory?" |
ops_taxonomy_upsert |
Crea o actualiza UN valor de un catálogo — de taxonomía (dri/status/role/seniority) o de un campo custom (cf:<field_key>). |
kind, value, label?, color?, sort?, project_id?, epica_id? |
write o admin. | "Agregá el hito 'Cierre Q3' al proyecto AI Factory." |
ops_taxonomy_archive |
Archiva (o desarchiva) UN valor de un catálogo. Lo saca del catálogo activo sin borrarlo ni tocar los ítems que ya lo tienen puesto. | kind, value, archived?, project_id? |
write o admin. Reversible. | "Archivá el hito 'Cierre Q1', ya no se usa." |
ops_custom_field_upsert |
Crea o renombra la DEFINICIÓN de un campo custom del proyecto — el campo en sí (p.ej. hito), no sus valores. Una vez que existe, sus valores se cargan con ops_taxonomy_upsert usando kind: cf:<field_key>. |
field_key, label?, sort?, project_id? |
write o admin. | "Creá un campo custom 'hito' en el proyecto AI Factory." |
ops_custom_field_archive |
Archiva (o desarchiva) la DEFINICIÓN de un campo custom. Lo saca del catálogo activo; no borra la definición ni los valores ya guardados en los ítems. | field_key, archived?, project_id? |
write o admin. Reversible. | "Archivá el campo custom 'hito'." |
ops_sprint_update |
Edita el nombre y las fechas de un sprint. Acá se define cuál es el sprint activo: se deriva de start_date/end_date, no de un flag. Si las fechas se solapan con otro sprint del mismo proyecto, la DB lo rechaza. |
id, name?, start_date?, end_date? |
write o admin. | "Corré el Sprint 11 una semana: del 17 al 31 de agosto." |
ops_sprint_delete |
Borra un sprint. Solo funciona si tiene cero ítems asignados: con ítems responde 409 diciendo cuántos son, nunca cascadea. | id |
write o admin. Nunca borra ítems. | "Borrá el sprint 12, quedó vacío." |
ops_factory_status |
Estado agregado del factory: si el modo ejecutar está ON, con qué cuenta corre, y qué agentes están en vuelo. El campo intent ya no existe (ADR-0127: murió ops.factory_intent). |
— | read. Solo lectura por diseño: encender la fábrica es exclusivamente humano (ADR-0113). | "¿Está corriendo la fábrica? ¿Con qué cuenta?" |
ops_factory_diagnose |
El selector se explica (ADR-0128): cola elegible AHORA, exclusiones con motivo (predecesor_abierto, sprint_mismatch, dispatch_mode_manual, …), último tick de la VM y agentes en vuelo. Filtrado por los proyectos del token. |
— | read. | "¿Por qué no está corriendo nada en el factory?" |
ops_sync_rule_add |
Crea una regla de sync cross-proyecto: los ítems del proyecto ORIGEN que matchean el filtro se clonan en el DESTINO, y el par queda vinculado (bidireccional por default). Requiere acceso a los DOS proyectos. | name, source_project_id, target_project_id, direction?, filter_owner?, filter_sprint_scope?, target_epica?, synced_fields?, status_map?, active? |
write o admin, y acceso a los dos proyectos. | "Cloná al proyecto Cliente X los ítems de AI Factory que sean de mid." |
ops_sync_rule_list |
Lista las reglas de sync. Muestra las reglas donde cualquiera de los dos lados sea un proyecto tuyo — que es como averiguás por qué apareció un ítem clonado en tu proyecto. | id?, source_project_id?, target_project_id?, active? |
read alcanza. | "¿Por qué se me clonan ítems en el proyecto Cliente X?" |
ops_sync_rule_update |
Edita una regla existente — pausarla/reanudarla, o cambiar su filtro, synced_fields o status_map. Origen y destino no son editables: para eso se pausa y se crea otra. |
id, name?, direction?, filter_owner?, filter_sprint_scope?, target_epica?, synced_fields?, status_map?, active? |
write o admin, y acceso a los dos proyectos de la regla. | "Pausá la regla de sync 3." |
ops_sync_link_add |
Vincula dos ítems que YA existen bajo una regla de sync — la reconciliación de pares que alguien clonó a mano antes de que la regla existiera. No crea ningún ítem: solo el vínculo, para que de ahora en más se propaguen. | rule_id, source_item_id, target_item_id |
write o admin. Cada ítem tiene que estar del lado que le corresponde en la regla. | "Vinculá el ítem 812 con su copia 940 bajo la regla 3." |
ops_sync_link_list |
Lista los vínculos de sync (los pares ítem↔clon), por regla o por ítem. item_id matchea de cualquiera de los dos lados: la pregunta es "¿este ítem está sincronizado?", no "¿de qué lado está?". |
rule_id?, item_id? |
read alcanza. | "¿El ítem 812 está sincronizado con algo?" |
ops_sync_link_remove |
Desvincula un par ítem↔clon por id de vínculo. No borra ningún ítem: solo deja de propagar entre los dos. Reversible con ops_sync_link_add. |
id |
write o admin. Nunca borra ítems. | "Desvinculá el par de sync 17." |
ops_intake_mapping_health |
Valores de formulario que llegaron por /api/intake/support SIN fila activa en ops.intake_field_mappings — pendientes y ya resueltos, agrupados por form/target_field/valor. Complementa el punto ciego de ops_factory_diagnose (un ticket sin ticket_type nunca genera cadena, así que esa tool no lo ve). |
form_id?, since_days? |
read. Filtrado por los proyectos del token. | "¿Hay valores del form de soporte sin mapeo activo?" |
ops_planner_config_get |
Lee la configuración del planner del proyecto: habilitado, vistas, paneles, mapeo de campos (fase, entregable, cantidad, código, título, visibilidad al cliente), palabras excluidas y flags de publicación (todo apagado/vacío por defecto). | project_id |
read alcanza. | "¿Cómo está configurado el planner del proyecto Acme?" |
ops_planner_config_set |
Cambia solo los campos que se pasan (null limpia uno anulable): General, Campos, visibilidad al cliente y flags de publicación. |
project_id, campos de configuración |
write o admin. project-admin del proyecto (o global-admin). | "Activá el planner en Acme y mapeá la fase al campo Fase." |
ops_status_semantics_set |
Fija por estado el % de avance, el rol (abierto, activo, revisión, hecho, en pausa, bloqueado…), la etiqueta para el cliente, el orden y el color. | project_id, statuses, remove? |
write o admin. project-admin del proyecto (o global-admin). | "Marcá 'En revisión' como 50% de avance." |
ops_stage_list |
Lista las etapas del plan como árbol (Etapa › Fase, máx. 2 niveles), con fechas propias o derivadas de sus fases/ítems, conteo de ítems y can_admin. |
project_id, epica_id?, include_archived? |
read alcanza. | "¿Qué etapas y fases tiene HyPro?" |
ops_stage_upsert |
Sin id crea; con id actualiza solo lo enviado (null limpia). Las fechas de una fase caen dentro de las de su etapa. Los ítems se asignan con stage_id en ops_add/ops_update. |
project_id, id?, parent_id?, epica_id?, name, client_label?, sort?, start_date?, target_date? |
write o admin. project-admin del proyecto (o global-admin). | "Etapa 'Piloto' con cierre el 30 de noviembre." |
ops_stage_archive |
El proyecto se resuelve desde la propia etapa, nunca desde el llamante. | id, archived? |
write o admin. project-admin del proyecto de la etapa (o global-admin). | "Archivá la etapa E1.F3." |
ops_status_history |
Una fila por cambio (item_id, estado anterior y nuevo, quién, cuándo), registrada por trigger en toda vía de escritura. Paginada. |
project_id, item_id?, since?, until?, limit?, after_id? |
read alcanza. | "¿Cuándo pasó el ítem 812 a Hecho?" |
ops_sync_rule_preview |
Muestra qué crearía, actualizaría y retiraría el motor en el proyecto cliente y qué campos viajan con su valor mapeado. No escribe nada. | rule_id, item_id?, root_item_id?, limit? |
read. global-admin. | "Simulá la regla 3 antes de activarla." |
ops_sync_rule_resync |
Cada raíz de la épica origen se replanifica contra el estado real del proyecto cliente. Idempotente. | rule_id |
write o admin. global-admin. | "Resincronizá la regla 3." |
ops_sync_runs |
Por regla (sus corridas), por corrida (detalle y eventos) o por ítem (su historia de réplica). | rule_id?, run_id?, item_id?, limit?, before? |
read. global-admin o project-admin del proyecto ORIGEN. | "¿Qué hizo la última corrida de la regla 3?" |
ops_sync_rule_revisions |
Una fila por versión, la más nueva primero, con quién y cuándo la cambió. | rule_id, limit?, before_version? |
read. global-admin o project-admin del proyecto ORIGEN. | "¿Quién cambió la regla 3?" |
ops_sync_engine_switch |
Sin argumentos lee si los triggers están encolando cambios; con outbox_enabled lo enciende o apaga. |
outbox_enabled? |
write o admin. Leer: cualquiera. Cambiar: global-admin. | "¿Está encendida la réplica?" |
ops_project_config_copy |
Copia por parts (estados, campos, DRI, planner, palabras excluidas). dry_run para ver antes de aplicar. |
from_project, to_project, parts?, dry_run?, overwrite? |
write o admin. project-admin del destino (o global-admin). | "Copiá la configuración de la plantilla al proyecto Acme." |
ops_sprint_series_add |
Por ejemplo 17 sprints semanales desde una fecha de inicio; el fin es inclusivo. | project_id, start_date, duration_days, count, name_pattern?, first_number? |
write o admin. project-admin del proyecto (o global-admin). | "Creá 17 sprints semanales desde el 3 de noviembre." |
ops_plan_snapshot |
Árbol de ítems con fechas efectivas, avance, atraso y códigos, más KPIs, fases, entregables, carga por sprint, hitos y responsables. | project_id, epica_id?, today?, include_history?, view? |
read alcanza. | "Mostrame el plan de Acme." |
ops_client_publish |
Genera un HTML autocontenido (proyección cliente, CSP estricta, marca de la organización) y lo guarda como nueva versión que lee el portal. dry_run para ver sin publicar. |
project_id, dry_run?, as_of?, include_html?, include_payload? |
write o admin. project-admin del proyecto (o global-admin). | "Publicá el plan de Acme al cliente." |
ops_client_unpublish |
Marca la última versión como retirada; el portal deja de servirla de inmediato. | project_id |
write o admin. project-admin del proyecto (o global-admin). | "Despublicá el plan de Acme." |
ops_client_publication_get |
Metadatos de la versión (por defecto la última), si es la vigente y si el portal la serviría. | project_id, version?, include_html?, include_payload? |
read. Requiere project-admin del proyecto (o global-admin). | "¿Qué versión del plan ve hoy el cliente?" |
ops_client_publication_list |
Metadatos, de la más nueva a la más vieja (se conservan las últimas 20), más la versión que el portal sirve. | project_id |
read. Requiere project-admin del proyecto (o global-admin). | "Listá las publicaciones de Acme." |
ops_automation_list |
Publicación programada del plan al cliente y el correo semanal de avance, con cadencia, estado y próxima corrida. | project_id, include_archived? |
read. Requiere project-admin del proyecto (o global-admin). | "¿Qué automatizaciones tiene Acme?" |
ops_automation_get |
Con include_candidates suma las personas que pueden recibir el correo. |
project_id, id, include_candidates? |
read. Requiere project-admin del proyecto (o global-admin). | "Detalle de la automatización 4." |
ops_automation_set |
Sin id crea (kind y name obligatorios); con id edita parcial; archived:true archiva. |
project_id, id?, name, kind, cadencia y destinatarios |
write o admin. project-admin del proyecto (o global-admin). | "Programá el informe semanal los lunes a las 8." |
ops_automation_run |
dry_run es TRUE por defecto: muestra lo que saldría sin enviar ni publicar nada. |
project_id, id, dry_run?, as_of?, include_html? |
write o admin. project-admin del proyecto (o global-admin). | "Mostrame cómo saldría el informe semanal." |
ops_automation_test_send |
Mismo render que el real, sin publicar el plan. Solo encola; el runner de la app ops lo envía. | project_id, id |
write o admin. project-admin del proyecto (o global-admin). | "Mandame una prueba del informe semanal." |
ops_automation_runs |
Más nuevas primero (máx. 100): slot, disparador, estado, intentos y conteos de entrega. | project_id, automation_id?, status?, limit? |
read. Requiere project-admin del proyecto (o global-admin). | "¿Falló algún envío esta semana?" |
ops_email_template_upsert |
Siempre se valida antes de guardar con el motor de plantillas seguro: variables desconocidas rechazadas, nunca limpiadas en silencio. | project_id, name, subject, html, text?, dry_run? |
write o admin. project-admin del proyecto (o global-admin). | "Guardá la plantilla 'Informe Acme'." |
ops_email_template_get |
Por name o id; sin ninguno, lista las plantillas y describe la integrada «Informe semanal». |
project_id, name?, id?, include_archived? |
read. Requiere project-admin del proyecto (o global-admin). | "¿Qué plantillas de correo hay en Acme?" |
ops_email_template_archive |
Se rechaza (409) mientras una automatización viva la use. | project_id, name?, id? |
write o admin. project-admin del proyecto (o global-admin). | "Archivá la plantilla 'Informe Acme'." |
ops_factory_summary |
Contadores del header de /live de la AI Factory: running, queued, blocked y max_parallel. Solo enteros agregados, sin ids ni títulos. Solo existe para el proyecto AI Factory. |
project_id? (default: AI Factory; otro valor se rechaza) |
read. Miembro del proyecto AI Factory. | "¿Cuántos agentes de la fábrica están corriendo y cuántos en cola?" |
ops_replica_mode_get |
Si el proyecto está en MODO RÉPLICA (D58): su contenido (ítems, notas, adjuntos, vínculos) lo escribe solo el worker de réplica — toda escritura da 409 REPLICA_MODE_READONLY — y la configuración sigue editable. Devuelve quién y cuándo lo activó y las reglas que lo alimentan. |
project_id |
read. Cualquier miembro del proyecto. | "¿El proyecto HyPro está en modo réplica?" |
ops_replica_mode_set |
ENCIENDE el modo réplica — de una vía e IRREVERSIBLE (no hay forma de apagarlo). Solo sobre un proyecto VACÍO (cero ítems, incluidos archivados; si no, 409 REPLICA_MODE_NOT_EMPTY). dry_run es true por default: solo corre el preflight. |
project_id, dry_run? (default true) |
write o admin. Solo global-admin. | "Corré el preflight del modo réplica para el proyecto HyPro (dry run)." |
ops_factory_capacity_get |
Perilla de capacidad de la AI Factory: max_parallel efectivo, su origen (source), techo, tope duro (hard_cap), trabajo en curso (wip), último cambio y el bloque tier (perfil de VM registrado, tier actual y tabla de tiers). El max_parallel efectivo es el mínimo entre el valor del board, el techo del ambiente y el cupo del perfil registrado (source profile_clamped cuando el cupo del perfil recorta). |
Sin argumentos. | read. Miembro del proyecto AI Factory. | "¿Con cuánto paralelismo está corriendo la fábrica ahora?" |
ops_factory_capacity_set |
Cambia la perilla de capacidad de la fábrica de PROD: max_parallel (1..40, nunca por encima del techo del ambiente ni del cupo del perfil de VM registrado; o null para volver al default) con reason; o vm_profile (reposo, media, ola, turbo) con reason, que solo devuelve el comando gh para redimensionar la VM, no la redimensiona. |
max_parallel?, vm_profile?, reason |
write o admin. Solo global-admin. | "Subí el paralelismo de la fábrica a 12 por la ola de hoy." |
ops_token_mint, ops_token_list y
ops_token_revoke ya no existen en el
gateway — las reemplazan dynamo_token_mint,
dynamo_token_list y dynamo_token_revoke
(mismo comportamiento, mismo gate), porque los tokens de máquina
dejaron de ser de ops y pasaron a ser del gateway. Ver la sección
de abajo.
Tools del gateway (4)
No son de ningún dominio en particular — las expone el propio
gateway. Las tres de dynamo_token_* son para
máquinas (el dispatcher, agent-factory): Claude no
soporta un flujo sin humano de por medio, así que estos siguen
siendo bearers opacos, no OAuth.
| Tool | Qué hace | Inputs | Permiso | Ejemplo de prompt |
|---|---|---|---|---|
dynamo_session_status |
Quién sos, contra qué ambiente estás (con PROD ⚠️ si aplica), tu scope y expiración de token, y tu estado en los cuatro dominios (ops, analytics, forms, auth). Reemplaza a los cuatro *_session_status sueltos. |
solo_gateway? (bool, default false — con true se salta la consulta a los otros tres dominios) |
Cualquier token autenticado — read alcanza. | "Decime quién soy y contra qué ambiente estoy conectado." |
dynamo_token_mint |
Emite un token opaco de máquina (mcp.machine_tokens) para un user_id. Devuelve el token en claro una sola vez — después solo queda su hash. expires_at es obligatorio y no puede pasar los 90 días. |
user_id (uuid), scope (read/write/admin), label?, expires_at (ISO-8601, obligatorio, ≤ 90 días) |
Global-admin real (authz.isGlobalAdmin === true) y los caps de tu propia sesión: acuñar read/write exige caps.write; acuñar admin exige que tu sesión YA sea admin. Un grant OAuth read no acuña nada — una sesión no puede crear un token más poderoso que ella. |
"Emitime un token de máquina write para el dispatcher, user_id tal-y-tal." |
dynamo_token_list |
Lista los tokens de máquina existentes (id, user_id, scope, label, expiración, revocación). Nunca el valor en claro ni el hash. | ninguno | Global-admin real, mismo gate que dynamo_token_mint. |
"Mostrame los tokens de máquina vigentes." |
dynamo_token_revoke |
Revoca un token de máquina por id. Revocar uno inexistente o ya revocado da error explícito, no un no-op silencioso. | id (int) |
Global-admin real, mismo gate que dynamo_token_mint. |
"Revocá el token de máquina 7." |
Errores esperados (401/403/503) y qué hacer con cada uno: Troubleshooting.