type.com

Trabaja con espacios compartidos, hilos, documentos, habilidades, aplicaciones, automatizaciones y herramientas conectadas.

Servidor MCP alojado

npx add-mcp 'https://api.type.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Type MCP permite que los clientes de IA compatibles trabajen con tu espacio de trabajo de Type a través de un servidor de Model Context Protocol alojado y protegido con OAuth. No requiere la CLI de Type, un proceso local ni una clave de API.

A través de Type MCP, un cliente puede leer tu espacio de trabajo, gestionar Spaces y Channels, crear y actualizar documentos y skills, crear y publicar Type Apps, ejecutar automatizaciones y llamar a tus integraciones conectadas. Cada solicitud se ejecuta como el usuario de Type que inició sesión en la organización seleccionada durante el inicio de sesión, con los mismos permisos que la aplicación web y la CLI de Type.

Instalar Type MCP

Para Claude, abre el instalador de un clic:

Conectar Type a Claude

Claude te pedirá que revises el conector, inicies sesión en Type, selecciones una organización y apruebes la conexión.

Para ChatGPT, abre el instalador de ChatGPT:

Conectar Type a ChatGPT

Inicia sesión en Type y sigue los pasos en la página: activa el modo Desarrollador en la configuración de Seguridad e inicio de sesión de ChatGPT, abre Plugins, añade una conexión llamada Type con la URL del servidor que se muestra en la página, elige OAuth y aprueba el acceso a Type. La disponibilidad del modo Desarrollador depende de tu cuenta de ChatGPT y de la política del espacio de trabajo.

Para configurar manualmente otro cliente MCP compatible, usa esta URL del servidor:

https://api.type.com/mcp

El cliente debe admitir servidores MCP remotos Streamable HTTP y OAuth. El servidor solo acepta solicitudes POST en esa URL y publica sus metadatos de OAuth en /.well-known/oauth-protected-resource/mcp.

Type MCP publica instrucciones del servidor durante la inicialización. Los clientes que respetan las instrucciones del servidor MCP las muestran al modelo como guía permanente para crear automatizaciones, aplicaciones, integraciones y skills en Type en lugar de scripts locales, trabajos cron o clientes API ad hoc, y para comenzar con type_whoami para confirmar el usuario y la organización que iniciaron sesión. Si también usas la CLI de Type, su instalador añade la misma guía a tus archivos de instrucciones globales de Claude Code y Codex.

Acciones disponibles

Las herramientas de Type MCP se agrupan por prefijo. Las herramientas de lectura están anotadas como de solo lectura; cualquier otra herramienta es una acción de escritura que tu cliente MCP debe pedirte que apruebes.

ÁreaHerramientasQué hacen
Identidadtype_auth_status, type_whoami, type_orgs_listConfirman la autenticación, muestran el usuario que inició sesión y la organización seleccionada, y listan tus membresías de organización.
Spacestype_spaces_list, type_spaces_get, type_spaces_create, type_spaces_update, type_spaces_archive, type_spaces_merge, type_spaces_members, type_spaces_add_member, type_spaces_remove_member, type_spaces_join, type_spaces_leave, type_spaces_set_autoreplyDescubren y gestionan Spaces, membresías y autoreply.
Channelstype_channels_list, type_channels_create, type_channels_update, type_channels_archive, type_channels_merge, type_channels_set_autoreplyDescubren y gestionan Channels dentro de un Space.
Búsqueda e hilostype_search_workspace, type_threads_recent, type_threads_list, type_thread_get, type_threads_batch, type_thread_replyBuscan mensajes nativos del espacio de trabajo, hilos, Spaces, personas, archivos, documentos y aplicaciones; listan y leen hilos; responden en un hilo y mencionan a compañeros.
Documentostype_documents_list, type_documents_pull, type_documents_pushListan, leen, crean y actualizan documentos Markdown, incluidos enlaces públicos.
Skillstype_skills_list, type_skills_inspect, type_skills_push, type_skills_syncListan, inspeccionan, crean y actualizan paquetes de skills para la organización o un Space.
Appstype_apps_list, type_apps_resolve, type_apps_scaffold, type_apps_checkout, type_apps_save_source, type_apps_deploy_development, type_apps_prepare, type_apps_publish_first, type_apps_get_publish_approval, type_apps_publish, type_apps_get_build, type_apps_logs, type_apps_resolve_session, type_apps_get_access, type_apps_set_access, type_apps_shareCrean, previsualizan, publican y comparten Type Apps sin una copia local.
Automatizacionestype_scheduled_actions_list, type_scheduled_actions_get, type_scheduled_actions_create, type_scheduled_actions_update, type_scheduled_actions_delete, type_synced_events_list, type_synced_events_get, type_synced_events_create, type_synced_events_update, type_synced_events_set_enabled, type_synced_events_delete, type_synced_events_poll, type_synced_events_send, type_automations_test, type_automations_status, type_automations_history, type_slack_channelsCrean, prueban e inspeccionan acciones programadas y eventos sincronizados.
Integracionestype_integrations_available, type_integrations_connections, type_integrations_list, type_integrations_tools, type_integrations_call, type_integrations_connect, type_integrations_connection_status, type_integrations_create, type_integrations_disconnect, type_integrations_save_custom_api, type_integrations_verify, type_integrations_request, type_integrations_permissions, type_integrations_set_grant, type_integrations_set_personal_mode, type_integrations_delete_grantDescubren, conectan, llaman y gestionan permisos para servicios conectados y Custom APIs.

Type MCP puede responder en un hilo existente con type_thread_reply, pero no crea hilos nuevos ni lee archivos adjuntos más allá de los resultados de búsqueda. Usa Type en sí, type-cli threads create para iniciar una nueva tarea de agente, o type-cli sessions push para importar una transcripción local.

Las respuestas de las herramientas son JSON. Una llamada fallida devuelve isError: true con { "ok": false, "error": { "code", "message" } }, donde code es invalid_input, not_found, forbidden, conflict o unexpected_error. Los esquemas de entrada son estrictos: los campos desconocidos se rechazan, así que usa los esquemas actuales que tu cliente descubra en lugar de adivinar nombres de campos.

Spaces, Channels e IDs estables

Usa type_spaces_list para listar los Spaces visibles para ti. Expone Spaces de producto regulares, no feeds de alertas, contenedores de mensajes directos, Spaces archivados ni Spaces dedicados de Sidekick. Cada resultado incluye un id de Space estable, su visibilidad y un valor de isMember. Pasa el ID exacto como spaceId a las herramientas de hilos y skills; no derives un ID de un nombre de Space, slug o URL.

La lista puede incluir un Space público con isMember: false. Puedes leer los hilos de ese Space público, pero las operaciones solo para miembros siguen sin estar disponibles. Usa type_channels_list solo con el ID de un Space donde isMember: true para listar sus Channels. Cada resultado incluye su id de Channel estable, el spaceId propietario, nombre, slug, estado de isDefault, configuración de autoreply y fuentes conectadas. Un ID de Channel solo es válido con el ID de su Space propietario.

Cada Space tiene un destino predeterminado que se muestra como Threads. type_channels_list lo devuelve con name: "Threads" y isDefault: true mientras conserva su ID estable y su slug persistido. Usa isDefault, no el nombre ni el slug, para identificarlo.

HerramientaEntrada requeridaResultado
type_spaces_listNingunaSpaces regulares visibles, IDs estables y estado de membresía.
type_channels_listSpace de miembro spaceIdChannels activos en ese Space, incluidos Threads.

Gestionar Spaces y Channels

Las herramientas de gestión toman referencias de space y channel en lugar de spaceId y channelId. Una referencia puede ser un ID estable, un slug o un nombre exacto; los nombres ambiguos se rechazan, así que prefiere los IDs del descubrimiento.

  • type_spaces_create toma name, un description opcional y visibility (public por defecto, o private). type_spaces_update cambia cualquiera de esos en un Space existente.
  • type_spaces_members, type_spaces_add_member y type_spaces_remove_member gestionan la membresía; member acepta un correo electrónico, ID de usuario o nombre para mostrar exacto. type_spaces_join y type_spaces_leave actúan sobre el usuario que inició sesión.
  • type_spaces_set_autoreply y type_channels_set_autoreply toman un booleano explícito de enabled. El autoreply de Space controla las respuestas de webhook y el valor predeterminado para hilos nuevos; el autoreply de Channel controla las respuestas a hilos nuevos en ese Channel.
  • type_channels_create y type_channels_update toman space más name y un description opcional.
  • type_spaces_archive y type_channels_archive ocultan un Space o Channel. type_spaces_merge toma source, target y un threadsChannelName anulable; type_channels_merge toma space, source y target. Las fusiones mueven el contenido al destino y archivan el origen, y son destructivas. Las fusiones de Space requieren un administrador de organización, y el destino predeterminado de Threads no se puede archivar ni fusionar.

Estas herramientas aplican las mismas comprobaciones de permisos que la CLI de Type y siempre actúan como el usuario autenticado en la organización seleccionada; nunca aceptan una anulación de actor u organización.

Encontrar y leer hilos

Para la recuperación del espacio de trabajo, comienza con type_search_workspace cuando el usuario haya proporcionado un tema. Usa type_threads_recent para preguntas sobre hilos más recientes o recientemente activos sin una consulta; su orden predeterminado es por fecha de creación. Luego llama a type_threads_batch para varios IDs de hilos candidatos o type_thread_get para uno solo.

type_search_workspace toma un query de 1 a 200 caracteres, una lista opcional de types (messages, threads, spaces, users, files, docs, apps) y un limit opcional por tipo de hasta 50. Reduce types cuando se conozca el tipo objetivo.

type_threads_list usa una entrada plana con ámbito de Space. Requiere spaceId y acepta un channelId opcional, además de marcas de tiempo ISO opcionales de from / to, status (open, closed o all), limit y cursor:

{ "spaceId": "space-id", "channelId": "channel-id" }

type_threads_recent usa un scope anidado opcional. Omite scope para hilos recientes en toda la organización. Pasa solo spaceId para cada Channel en un Space, o incluye el channelId de ese Space para reducir el resultado. También acepta status, sort (created o activity), limit y cursor:

{ "scope": { "spaceId": "space-id" } }
{ "scope": { "spaceId": "space-id", "channelId": "channel-id" } }

type_threads_recent no acepta spaceId ni channelId de nivel superior. La forma anidada garantiza que un Channel siempre se empareje con su Space propietario.

Para cualquiera de las herramientas, omitir channelId significa todos los hilos en el ámbito seleccionado, no solo Threads. Para seleccionar solo el destino predeterminado de Threads, pasa el ID estable del elemento isDefault: true devuelto por type_channels_list. Las herramientas de listado devuelven 20 hilos por defecto y como máximo 50 por página.

type_thread_get devuelve 50 mensajes por página por defecto (como máximo 500) dentro de un presupuesto de texto que por defecto es de 12 000 caracteres (maxTextChars, como máximo 48 000). type_threads_batch lee hasta 10 hilos con un presupuesto compartido que por defecto es de 24 000 caracteres (maxTotalChars, como máximo 48 000) y 25 mensajes por hilo (perThreadLimit, como máximo 50). Si algún hilo solicitado no se puede leer, todo el lote falla.

Las lecturas de hilos siguen la visibilidad del Space. Puedes listar o leer hilos en un Space público incluso cuando su resultado de type_spaces_list tenga isMember: false. Los hilos de Spaces privados siguen disponibles solo para miembros.

Responder en un hilo

type_thread_reply publica una respuesta en un hilo existente como el usuario que inició sesión. Toma el threadId (el ID de hilo estable devuelto por las herramientas de búsqueda y hilos), el content de la respuesta como texto plano y un replyMode opcional:

{
  "threadId": "thread_123",
  "content": "@Fletcher Richman can you review this? cc <@user_01…>",
  "replyMode": "chat"
}

Menciona a un compañero escribiendo @Display Name (sin distinción de mayúsculas y minúsculas, comparado con los miembros de la organización) o <@user_id> (exacto; encuentra IDs con type_search_workspace y el tipo users). Las menciones resueltas se muestran como chips de mención y notifican a esa persona. #space-name enlaza un Space. El resultado incluye las URL del mensaje y del hilo, mentions (quién fue resuelto y notificado) y unresolvedMentions (tokens que no coincidieron con nadie). Una entrada en unresolvedMentions significa que nadie fue notificado por ese nombre, así que busca a la persona y reintenta con <@user_id> cuando la mención sea importante. Una respuesta es un mensaje de equipo (replyMode: "chat"), que nunca inicia ni reanuda una respuesta de IA, o un prompt de IA (replyMode: "prompt"), que solicita al agente del hilo que responda. Cuando se omite replyMode, una respuesta que resolvió una mención de usuario se envía como mensaje de equipo y cualquier otra respuesta se envía como prompt de IA, por lo que un mensaje dirigido a un compañero no activa al agente. Responder requiere acceso al Space del hilo, los hilos cerrados rechazan respuestas y los hilos de mensajes directos no son compatibles.

Los resultados de hilos y los resultados de búsqueda con ubicación usan una ubicación normalizada:

{
  "location": {
    "space": { "id": "space-id", "name": "Product", "slug": "product" },
    "placement": { "type": "threads" }
  }
}

La colocación en Canal nombrado incluye la identidad estable del Canal:

{
  "location": {
    "space": { "id": "space-id", "name": "Product", "slug": "product" },
    "placement": {
      "type": "channel",
      "channel": {
        "id": "channel-id",
        "name": "Launch",
        "slug": "launch"
      }
    }
  }
}

Los resultados de búsqueda y de hilos recientes también incluyen IDs de hilo estables, URLs web y metadatos de paginación. Las herramientas de hilos devuelven URLs de citas y metadatos de truncamiento.

Trabajar con documentos

type_documents_list lista los documentos Markdown a los que puedes acceder, con un query opcional para búsqueda por título o contenido y paginación limit / offset. type_documents_pull devuelve el Markdown de un documento y su currentRevisionId.

type_documents_push crea o actualiza un documento a partir de Markdown en línea; el MCP alojado nunca lee archivos de tu máquina.

  • Para crear, pasa spaceId, title y contentMarkdown. Debes ser miembro de ese Space.
  • Para actualizar, pasa documentId, contentMarkdown y el baseRevisionId que recibiste de type_documents_pull. Si el documento cambió desde esa extracción, la actualización se rechaza con un error conflict; extrae de nuevo antes de reintentar.
  • Establece public: true para publicar un enlace público. Los documentos están limitados al Space a menos que lo solicites explícitamente.

Conserva el ID de documento devuelto para actualizaciones posteriores. Si quieres un archivo local sincronizado con un documento de Type, usa la CLI de Type, que registra esa asignación por ti.

Trabajar con skills

Los skills pueden ser de toda la organización o estar adjuntos a un Space. No están adjuntos a un Canal individual porque cada Canal comparte los skills de su Space. Un objetivo con ámbito de Space requiere isMember: true para ese Space.

Usa uno de estos objetivos exactos con type_skills_list, type_skills_push o type_skills_sync:

{ "scope": "global" }
{ "scope": "space", "spaceId": "space-id-returned-by-type_spaces_list" }

Un paquete de skill incluye un name, un handle, un description opcional y de 1 a 100 files. Cada archivo tiene un filename relativo, un category de script, reference o asset, su texto content y, para scripts, scriptEntrypoint y scriptLanguage opcionales (valores python, javascript, typescript o shell).

type_skills_push crea un nuevo skill. Si ya existe un skill con el mismo nombre para el objetivo, falla a menos que pases force: true, que actualiza ese skill cuando es la única coincidencia. type_skills_sync actualiza el skill nombrado por skillId, o crea uno cuando se omite skillId. type_skills_inspect devuelve un skill y el contenido completo de sus archivos empaquetados.

La creación y actualización de skills son acciones de escritura. Revisa el paquete propuesto y el objetivo de Space estable en tu cliente MCP antes de aprobarlos.

Construir y publicar apps

Type MCP expone el ciclo de vida completo de Type App sin un checkout local. El alojamiento local de Vite y la supervisión de archivos siguen siendo funciones de la CLI de Type.

  1. Descubre una app con type_apps_list o type_apps_resolve.
  2. Crea una nueva app en un Space con type_apps_scaffold (spaceRef y title), o abre una existente con type_apps_checkout. Ambos devuelven el árbol de archivos editable y un buildId.
  3. Envía el árbol completo creado con type_apps_save_source, pasando el expectedSourceGeneration que recibiste para que un checkout obsoleto no pueda sobrescribir código fuente compartido más reciente. Conserva el checkpoint devuelto y los hashes de fuente. Las fuentes están limitadas a 256 archivos y 8 MiB en total.
  4. Implementa ese checkpoint en el backend de desarrollo con type_apps_deploy_development y resuelve el acceso de vista previa con type_apps_resolve_session.
  5. Crea un borrador alojado revisable con type_apps_prepare.
  6. Para una app nueva, publica la primera versión en vivo con type_apps_publish_first. Para una app que ya está en vivo, lee type_apps_get_publish_approval, revísalo con el usuario y luego pasa los hashes aprobados a type_apps_publish.
  7. Inspecciona el progreso con type_apps_get_build y los registros del backend con type_apps_logs (target de development o production).
  8. Gestiona el acceso con type_apps_get_access, type_apps_set_access (workspace, channel con un spaceRef, o public) y type_apps_share, que crea un enlace público y opcionalmente permite escrituras de datos públicas.

Publicar, cambiar el acceso y compartir cambian lo que otras personas pueden ver. Apruébalos solo después de revisar el borrador. No hay herramienta de reversión; publica la fuente deseada como un nuevo borrador en su lugar.

Ejecutar automatizaciones

Las herramientas de automatización toman una referencia space y actúan sobre el agente de ese Space.

Acciones programadas se ejecutan según un horario. type_scheduled_actions_create toma name, instructions y un schedule, más description, channel, slackChannel y runConfig opcionales (anulaciones de modelo y esfuerzo). Las nuevas acciones comienzan deshabilitadas a menos que pases isEnabled: true; habilítalas o deshabilítalas más tarde con type_scheduled_actions_update. Usa type_scheduled_actions_list, type_scheduled_actions_get y type_scheduled_actions_delete para el resto del ciclo de vida.

Eventos sincronizados traen actividad externa a un Space. type_synced_events_create toma un source de new-thread, slack, github, linear, webhook, rss o email con configuraciones específicas de la fuente: webhook (service, secret y signatureHeader opcionales), rss (feedUrl y pollIntervalMinutes de 5 a 1440), email (username) y slack (channel y triggerMode). Las fuentes de Slack, GitHub y Linear necesitan una integración conectada pasada como integrationId, y usan type_slack_channels para descubrir destinos de Slack. Las fuentes de webhook, RSS y nuevos hilos se pueden crear deshabilitadas y cambiar con type_synced_events_set_enabled; las fuentes de Slack, correo electrónico, GitHub y Linear deben crearse habilitadas y se eliminan para detenerlas. type_synced_events_poll verifica una fuente RSS ahora.

type_synced_events_send entrega una muestra JSON en línea a través de un webhook que estás autorizado a usar. Pasa el secret de firma cuando el webhook verifica firmas. Debido a que usa el receptor de webhook real, puede crear mensajes y activar respuestas de IA.

type_automations_test ejecuta una acción programada o evento (kind de scheduled o event) y devuelve un ID de mensaje de respuesta. Consulta type_automations_status con ese ID desde el cliente y revisa ejecuciones pasadas con type_automations_history.

Usar integraciones

Type mantiene los tokens OAuth y las credenciales en el servidor. El cliente MCP recibe solo metadatos de herramientas y resultados, y Type aplica la misma selección de credenciales personales versus de organización y la política de permisos que el resto de Type.

  • type_integrations_available lista los proveedores que puedes conectar, type_integrations_connections lista las conexiones personales y de organización instaladas, y type_integrations_list lista los servicios que puedes llamar, cada uno con su organizationIntegrationId estable y modo de acceso efectivo.
  • type_integrations_tools devuelve las herramientas permitidas y los esquemas de argumentos exactos para un service y organizationIntegrationId. type_integrations_call ejecuta uno de ellos. Las conexiones de solo lectura omiten herramientas de escritura, y las llamadas que envían, publican, editan o eliminan datos en otro producto son consecuentes; tu cliente debe preguntar antes de ejecutarlas, y las escrituras fallidas no deben reintentarse hasta que verifiques el proveedor.
  • type_integrations_connect inicia una conexión para un provider y scope (organization o personal) y devuelve una URL de configuración de Type. Completa la entrada de OAuth o credenciales del proveedor allí, luego consulta type_integrations_connection_status con el attemptId devuelto. type_integrations_create habilita una integración nativa o guarda credenciales nativas directamente. type_integrations_disconnect elimina una cuenta personal (userIntegrationId de la lista de conexiones) o, con deleteForOrganization: true, una conexión de organización (integrationId).
  • Para APIs personalizadas, conéctate con un customApiDraft no secreto, guarda la credencial con type_integrations_save_custom_api, valida con type_integrations_verify y luego llámala con type_integrations_request (path, query, headers y un body opcional). Nunca coloques una credencial en un argumento de herramienta o mensaje de chat.
  • type_integrations_permissions muestra las políticas de integración. type_integrations_set_grant establece un workspace, Space o concesión de usuario a read_only o full; type_integrations_delete_grant elimina una; type_integrations_set_personal_mode limita tu propia credencial personal. Cambiar concesiones compartidas requiere un propietario/admin del workspace o un administrador de esa integración.

Autenticación y acceso a la organización

Type MCP usa OAuth a través del proveedor de identidad de Type. La organización seleccionada durante el inicio de sesión limita el token del conector, y Type no envía una clave API al cliente MCP. Cada herramienta se ejecuta como ese usuario en esa organización; ninguna herramienta acepta una organización o actor proporcionado por el llamador.

Type MCP debe estar habilitado para tu workspace por Type. Si no lo está, el inicio de sesión tiene éxito pero cada solicitud devuelve Acceso denegado a la organización de Type.

OperaciónSpace público con isMember: falseMiembro del Space
Descubrir el SpacePermitidoPermitido
Leer sus hilosPermitidoPermitido
Listar sus CanalesNo permitidoPermitido
Listar, crear o actualizar skills con ámbito de SpaceNo permitidoPermitido
Crear documentos, enviar muestras de webhook o gestionar el SpaceNo permitidoPermitido, sujeto a tu rol

Los Spaces privados no se exponen a no miembros.

type_orgs_list muestra cada organización a la que perteneces y a cuál está vinculado el conector. Para usar una organización diferente, desconecta Type en la configuración del conector del cliente, agrégalo de nuevo y selecciona la nueva organización durante el inicio de sesión.

Para desconectar Type, elimínalo de la configuración del conector del cliente. El cliente posee la conexión OAuth guardada.

¿Type MCP o CLI de Type?

Usa Type MCP cuando quieras que un cliente de IA compatible trabaje con Type a través de una conexión alojada sin instalación local. Cubre las mismas operaciones de workspace, documento, skill, app, automatización e integración que la CLI, con contenido pasado en línea en lugar de rutas locales.

Type MCP también es la opción correcta cuando un agente se ejecuta en un entorno alojado en la nube, incluido Claude Cowork en modo nube. La computación en la nube no puede depender de un binario type-cli instalado en tu máquina.

Usa la CLI de Type cuando el flujo de trabajo dependa de tu máquina local, incluyendo:

  • Sincronizar carpetas de skills locales y archivos Markdown con asignaciones de archivos persistentes y ejecuciones de prueba.
  • Ejecutar el frontend de una Type App localmente con type-cli app dev.
  • Iniciar una nueva tarea de agente de Space con type-cli threads create, o mover una sesión local de Claude o Codex a un nuevo hilo de Type con sessions push. Responder a un hilo existente funciona desde cualquier interfaz (type_thread_reply o type-cli threads reply).
  • Ejecutar operaciones de Type desde scripts de shell.

Solución de problemas

  • Autorización requerida o Token de acceso no válido: El cliente no envió un token de conector válido. Reconecta Type en la configuración del conector del cliente.
  • Acceso denegado a la organización de Type: Tu membresía está inactiva, la organización seleccionada no está disponible, o Type MCP no ha sido habilitado para ese espacio de trabajo. Consulta a un administrador del espacio de trabajo de Type.
  • Servicio de autenticación no disponible o Espacio de trabajo de Type no disponible: Reintenta después de una breve espera. Type no pudo verificar el token del conector o alcanzar el espacio de trabajo.
  • Debes unirte a este Space antes de listar sus Channels: type_spaces_list puede devolver Spaces públicos con isMember: false. Únete al Space antes de listar sus Channels. Las lecturas de hilos públicos no requieren membresía.
  • Space no encontrado: Llama a type_spaces_list y pasa el ID estable devuelto sin modificarlo. Los objetivos de habilidades específicos del Space también devuelven este error cuando no eres miembro del Space.
  • Hilo no encontrado o Hilos solicitados no encontrados: El hilo no es legible para ti, o un ID en una solicitud de type_threads_batch no es válido. Las lecturas por lotes fallan en su totalidad.
  • Documento cambiado; obtén su última revisión antes de actualizar: Otra edición se realizó después de tu extracción. Llama a type_documents_pull nuevamente y usa el nuevo baseRevisionId.
  • Ya existe una habilidad llamada ”…” para este objetivo: Usa type_skills_sync con el skillId existente, o pasa force: true a type_skills_push.
  • Paquete de habilidad rechazado: Usa nombres y manejadores no vacíos, rutas de archivo relativas únicas, y sin rutas absolutas ni segmentos de ruta . / ...
  • Campo desconocido o invalid_input: Los esquemas de entrada son estrictos. Vuelve a leer el esquema de la herramienta desde tu cliente y elimina los campos que no liste.