La búsqueda solo se carga cuando la usas. Explora todas las categorías a continuación.
SosoAPI · Documentación para desarrolladores
Referencia de API
107 operaciones que puedes llamar desde tu aplicación, más 4 endpoints de acceso para agentes. Abre una operación para ver sus campos de solicitud, respuesta, permisos y ejemplos de llamadas.
Cuentas y espacios de trabajo
- Obtener contexto de la organización
POST /identity-api/agent/organization-contextConsulta la autoridad vigente de organizaciones, espacios de trabajo y canales. - Crear clave API
POST /identity-api/api-keys/createCrea una clave API con las capacidades elegidas y límites opcionales de espacios de trabajo; el secreto se devuelve una sola vez. Un agente solo puede conceder lo que permite su propia autorización, durante un máximo de 30 días, y cada autorización admite como máximo 25 claves activas (API_KEY_GRANT_KEY_LIMIT). - Ampliar vigencia de clave API
POST /identity-api/api-keys/extendAmplía el vencimiento de una clave API hasta un máximo de 365 días a partir de ahora (30 para una clave creada por un agente); una fecha posterior se rechaza con API_KEY_LIFETIME_EXCEEDS_CAP. La respuesta incluye el vencimiento aplicado. - Listar claves API
POST /identity-api/api-keys/listLista los metadatos de claves API sin secretos; establece include_authority para obtener capacidades y límites de espacios de trabajo. - Renovar clave API
POST /identity-api/api-keys/renewCrea una clave API sucesora sin destruir la anterior, con las mismas capacidades y límites de espacios de trabajo. - Revocar clave API
POST /identity-api/api-keys/revokeRevoca una clave API. Un agente solo puede revocar claves que haya creado. - Obtener estado de facturación
POST /identity-api/billing/statusConsulta los datos del plan de facturación, los derechos y las cuotas. - Obtener acceso comercial
POST /identity-api/commercial-access/statusConsulta los datos de acceso comercial del espacio de trabajo. - Enviar comentarios sobre el producto
POST /identity-api/feedback/submitEnvía comentarios sobre el producto con atribución. - Listar miembros del espacio de trabajo
POST /identity-api/member/listConsulta los miembros y las invitaciones pendientes. - Listar canales de la organización
POST /identity-api/organization/channels/listLista los canales y el estado de vinculación a espacios de trabajo. - Previsualizar traslado de canal
POST /identity-api/organization/channels/move/previewPrevisualiza los impedimentos antes de trasladar un canal. - Listar conexiones de la organización
POST /identity-api/organization/connections/listConsulta las conexiones de proveedores de la organización. - Revisar conexión de organización
POST /identity-api/organization/connections/reviewConsulta los recursos exactos del proveedor detectados para revisión. - Listar organizaciones
POST /identity-api/organization/listLista las organizaciones visibles para el usuario autenticado. - Listar notificaciones de la bandeja de entrada
POST /identity-api/user/inbox/listConsulta la bandeja de entrada del usuario autenticado. - Obtener preferencias de notificación
POST /identity-api/user/notifications/getConsulta las preferencias de entrega de notificaciones. - Actualizar preferencias de notificación
POST /identity-api/user/notifications/updateActualiza las preferencias de entrega de notificaciones. - Obtener perfil de usuario
POST /identity-api/user/profile/getConsulta el perfil del usuario autenticado. - Firmar carga de avatar
POST /identity-api/user/profile/sign-avatar-urlObtiene una URL firmada para cargar un avatar. - Actualizar perfil de usuario
POST /identity-api/user/profile/updateActualiza el perfil del usuario autenticado. - Quitar bloqueo de cuenta social
POST /identity-api/user/social-accounts/clear-blockQuita el período de espera de una cuenta sin reintentar una publicación. Se rechazan las credenciales de agente mientras siga activo o cuando la cuenta haya alcanzado su tercer período de espera; cualquier solicitante puede quitarlo como máximo una vez cada 10 minutos. - Desconectar cuenta social
POST /identity-api/user/social-accounts/disconnectDesconecta una cuenta social de un espacio de trabajo. - Listar cuentas conectadas
POST /identity-api/user/social-accounts/listLista las cuentas sociales conectadas de un espacio de trabajo. - Configurar sincronización automática de cuenta social
POST /identity-api/user/social-accounts/set-auto-syncActiva o desactiva la sincronización automática de la cuenta. - Crear espacio de trabajo
POST /identity-api/workspace/createCrea un espacio de trabajo en una organización de la que eres propietario o administrador. Proporciona organization_id si perteneces a varias organizaciones. - Obtener contexto del espacio de trabajo
POST /identity-api/workspace/listLista los espacios de trabajo y el espacio de trabajo activo. - Actualizar espacio de trabajo
POST /identity-api/workspace/updateActualiza el nombre o slug del espacio de trabajo.
Archivos multimedia y recursos
- Crear recurso
POST /assets-api/createRegistra los metadatos de un recurso. - Eliminar recurso
POST /assets-api/deleteElimina un recurso. - Crear exportación de recursos
POST /assets-api/exports/createCrea una tarea de evidencias de exportación de recursos. - Obtener estado de exportación de recursos
POST /assets-api/exports/statusConsulta el estado persistente de exportación de recursos. - Verificar exportación de recursos
POST /assets-api/exports/verifyVerifica una exportación de recursos antes de cualquier borrado definitivo. - Obtener recurso
POST /assets-api/getConsulta un recurso por ID. - Obtener estado de importación de recursos
POST /assets-api/imports/statusConsulta el estado persistente de importación multimedia. - Importar URL de recurso
POST /assets-api/imports/urlPone en cola la incorporación explícita de archivos multimedia externos. - Buscar recursos
POST /assets-api/listBusca recursos con filtros compatibles con versiones anteriores. - Listar recursos
POST /assets-api/list-workspaceLista los recursos del espacio de trabajo. - Eliminar recursos huérfanos
POST /assets-api/orphans/deleteElimina los objetos R2 seleccionados que no están registrados. - Listar recursos huérfanos
POST /assets-api/orphans/listLista los objetos R2 no registrados. - Solicitar borrado definitivo de recursos
POST /assets-api/purges/requestSolicita un borrado definitivo de recursos protegido por control de propietario. - Reintentar borrado definitivo de recursos
POST /assets-api/purges/retryReintenta un borrado definitivo elegible protegido por control de versión. - Obtener inventario de almacenamiento de recursos
POST /assets-api/storage/inventoryConsulta un inventario acotado de recursos registrados y objetos almacenados. - Actualizar recurso
POST /assets-api/updateActualiza los metadatos del recurso. - Completar la carga de un recurso
POST /assets-api/upload/completeCompleta el registro del objeto multimedia cargado en el espacio de trabajo usando su identidad de objeto firmada y su clave de idempotencia. - Firmar carga de recurso
POST /assets-api/upload/signSolicita una URL de carga firmada para el objeto multimedia previsto del espacio de trabajo. Carga los bytes antes de completar el registro.
Proyectos y contenido
- Obtener cuentas predeterminadas del proyecto
POST /studio-api/projects/account-defaults/getConsulta las cuentas predeterminadas del proyecto. - Reemplazar cuentas predeterminadas del proyecto
POST /studio-api/projects/account-defaults/replaceReemplaza las cuentas predeterminadas del proyecto. - Vincular cuenta al proyecto
POST /studio-api/projects/accounts/linkVincula una cuenta social a un proyecto. - Listar cuentas del proyecto
POST /studio-api/projects/accounts/listLista las cuentas vinculadas a un proyecto. - Desvincular cuenta del proyecto
POST /studio-api/projects/accounts/unlinkDesvincula una cuenta social de un proyecto. - Archivar proyecto
POST /studio-api/projects/archiveArchiva un proyecto sin cambiar sus publicaciones programadas. Para detener una publicación, cancélala por separado. Solo el propietario del espacio de trabajo; proporciona expected_lifecycle_version y un idempotency_key. - Vincular recurso al proyecto
POST /studio-api/projects/assets/linkVincula un recurso a un proyecto. - Listar recursos del proyecto
POST /studio-api/projects/assets/listLista los recursos vinculados a un proyecto. - Desvincular recurso del proyecto
POST /studio-api/projects/assets/unlinkDesvincula un recurso de un proyecto. - Crear proyecto
POST /studio-api/projects/createCrea un proyecto. - Crear exportación de proyecto
POST /studio-api/projects/export/createCrea una exportación de proyecto. - Obtener estado de exportación del proyecto
POST /studio-api/projects/export/statusConsulta el estado de exportación del proyecto. - Obtener proyecto
POST /studio-api/projects/getConsulta un proyecto. - Obtener historial del ciclo de vida del proyecto
POST /studio-api/projects/lifecycle/historyConsulta el historial del ciclo de vida del proyecto. - Listar proyectos
POST /studio-api/projects/listLista los proyectos del espacio de trabajo. - Obtener perfil del proyecto
POST /studio-api/projects/profile/getConsulta un perfil de proyecto. - Actualizar perfil del proyecto
POST /studio-api/projects/profile/updateActualiza un perfil de proyecto. - Establecer proyecto activo
POST /studio-api/projects/set-activeEstablece el proyecto activo. - Desarchivar proyecto
POST /studio-api/projects/unarchiveReactiva un proyecto archivado. No reanuda ni vuelve a programar publicaciones; gestiónalas mediante las publicaciones programadas. Solo el propietario del espacio de trabajo; proporciona expected_lifecycle_version y un idempotency_key. - Actualizar proyecto
POST /studio-api/projects/updateActualiza un proyecto. - Listar publicaciones que requieren atención
POST /studio-api/publication-attentions/listConsulta los resultados de publicación que requieren atención.
Programación y publicación
- Crear publicaciones programadas en lote
POST /studio-api/scheduled-posts/bulk-createCrea publicaciones programadas para varios destinos. - Cancelar publicación programada
POST /studio-api/scheduled-posts/cancelCancela una publicación programada. - Crear publicación programada
POST /studio-api/scheduled-posts/createCrea una publicación programada y consulta el resultado definitivo de publicación. - Enviar publicación completa con imagen
POST /studio-api/scheduled-posts/create-image-urlAcepta de forma persistente una publicación completa con imagen por URL y devuelve su resultado definitivo cuando está disponible. - Eliminar publicación programada
POST /studio-api/scheduled-posts/deleteElimina una publicación programada. - Obtener elegibilidad de publicación programada
POST /studio-api/scheduled-posts/eligibilityConsulta la elegibilidad del destino antes de programar. - Obtener publicación programada
POST /studio-api/scheduled-posts/getConsulta una publicación programada. - Listar publicaciones programadas
POST /studio-api/scheduled-posts/listLista las publicaciones programadas. - Publicar ahora una publicación programada
POST /studio-api/scheduled-posts/publish-nowSolicita la publicación inmediata. - Reintentar publicación programada
POST /studio-api/scheduled-posts/retryReintenta una publicación programada fallida. - Actualizar publicación programada
POST /studio-api/scheduled-posts/updateActualiza una publicación programada. - Retirar solicitud de eliminación
POST /studio-api/scheduled-posts/withdraw-deleteRetira una solicitud de eliminación de Instagram Login detenida y conserva la publicación publicada. - Obtener créditos de publicación en X
POST /studio-api/x/usageConsulta los créditos de X compartidos por la organización y el costo en créditos del texto final opcional de la publicación.
Analítica y estadísticas
- Obtener recuentos del panel
POST /analytics-api/dashboard/ops-countsConsulta los recuentos operativos del panel. - Solicitar estadísticas del proveedor
POST /analytics-api/provider-insights/requestSolicita estadísticas cuya fuente de autoridad es el proveedor. - Obtener estado de estadísticas del proveedor
POST /analytics-api/provider-insights/statusConsulta el estado de solicitud de estadísticas del proveedor. - Listar comentarios de publicaciones
POST /analytics-api/social/comments/queryConsulta los comentarios sociales detectados. - Listar publicaciones supervisadas
POST /analytics-api/social/posts/queryConsulta las publicaciones sociales detectadas.
Conexiones sociales
- Iniciar OAuth de Instagram
POST /oauth-api/instagram/initInicia el consentimiento del proveedor y devuelve la URL de autorización nativa. - Renovar OAuth de Instagram
POST /oauth-api/instagram/refreshRenueva una conexión de Instagram. - Iniciar OAuth de Meta
POST /oauth-api/meta/initInicia el consentimiento del proveedor y devuelve la URL de autorización nativa. - Renovar OAuth de Meta
POST /oauth-api/meta/refreshRenueva una conexión de Meta. - Comprobar OAuth de Threads
POST /oauth-api/threads/checkLee los diagnósticos de conexión de Threads. - Iniciar OAuth de Threads
POST /oauth-api/threads/initInicia el consentimiento del proveedor y devuelve la URL de autorización nativa. - Renovar OAuth de Threads
POST /oauth-api/threads/refreshRenueva una conexión de Threads. - Iniciar OAuth de YouTube
POST /oauth-api/youtube/initInicia el consentimiento del proveedor y devuelve la URL de autorización nativa. - Renovar OAuth de YouTube
POST /oauth-api/youtube/refreshRenueva una conexión de YouTube.
Operaciones en segundo plano
Comentarios y comunidad
- Aplicar acción de comunidad
POST /community-engagement-api/actions/applyAplica una acción preparada; consulta su estado para conocer el resultado definitivo. - Preparar acción de comunidad
POST /community-engagement-api/actions/preparePrepara una acción definitiva de comunidad. - Obtener estado de acción de comunidad
POST /community-engagement-api/actions/statusConsulta el comprobante definitivo de la acción; ponerla en cola no significa éxito. - Obtener capacidades de comunidad
POST /community-engagement-api/capabilitiesConsulta los datos de capacidades de interacción con la comunidad. - Crear comentario de comunidad
POST /community-engagement-api/comments/createPone en cola un comentario exacto dirigido a una publicación o un comentario canónicos; el estado no implica éxito en el proveedor. - Obtener resultado de entrega del comentario
POST /community-engagement-api/comments/outcomeConsulta la entrega confirmada, el historial de recuperación, la verificación pendiente y el seguimiento sin resolver. - Conciliar resultado de entrega del comentario
POST /community-engagement-api/comments/reconcileVerifica una entrega ambigua de Facebook sin reenviar, o vincula un reemplazo exacto confirmado. Consulta el resultado para obtener evidencia definitiva. - Obtener estado de comentario de comunidad
POST /community-engagement-api/comments/statusConsulta el comprobante definitivo depurado de una acción directa de comentario. - Obtener resumen de comunidad
POST /community-engagement-api/operations/summaryConsulta el resumen operativo de interacción con la comunidad. - Consultar cola de revisión de comunidad
POST /community-engagement-api/review-queue/queryConsulta los comentarios disponibles para revisión; una página vacía no significa éxito. - Enviar revisión de comunidad
POST /community-engagement-api/reviews/submitEnvía una nueva versión inmutable de revisión.
Inicio de autenticación
- Autenticación del agente: config
POST /identity-api/agent-auth/configProtocolo config de autenticación del agente. Usa el flujo de inicio de sesión compatible en el navegador; nunca muestres credenciales. - Autenticación del agente: request
POST /identity-api/agent-auth/requestProtocolo request de autenticación del agente. Usa el flujo de inicio de sesión compatible en el navegador; nunca muestres credenciales. - Autenticación del agente: revoke-current
POST /identity-api/agent-auth/revoke-currentProtocolo revoke-current de autenticación del agente. Usa el flujo de inicio de sesión compatible en el navegador; nunca muestres credenciales. - Autenticación del agente: session
POST /identity-api/agent-auth/sessionProtocolo session de autenticación del agente. Usa el flujo de inicio de sesión compatible en el navegador; nunca muestres credenciales.