Integración Claromentis

Las integraciones de Claromentis importan contenido de la base de conocimiento. Habilita Claromentis a nivel de instancia primero—consulta la guía del operador: Configuración de Claromentis.

Solicitud básica y respuesta

Crea una integración de Claromentis con POST /api/v1/app/integration/claromentis.

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Body	`username`	Si	Usuario de Claromentis.
Body	`password`	Si	Contraseña de Claromentis.

curl -X POST "https://{BASE_URL}/api/v1/app/integration/claromentis" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "{username}",
    "password": "{password}"
  }'

Ejemplo de respuesta

{
  "id": "clar_3c2d1b4a5f6e7d8c",
  "user_id": "user_4b7c2a1d9e5f3c8b",
  "org_id": "org_2f3a9d1c7b5e4a8f",
  "type": "Claromentis",
  "created_at": "2026-02-08T14:05:00Z",
  "updated_at": "2026-02-08T14:05:00Z"
}

Actualizar credenciales

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Path	`integrationID`	Si	Identificador de la integración.
Body	`username`	Si	Usuario de Claromentis.
Body	`password`	Si	Contraseña de Claromentis.

curl -X POST "https://{BASE_URL}/api/v1/app/integration/claromentis/{integrationID}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "{username}",
    "password": "{password}"
  }'

Ejemplo de respuesta

{
  "id": "clar_3c2d1b4a5f6e7d8c",
  "user_id": "user_4b7c2a1d9e5f3c8b",
  "org_id": "org_2f3a9d1c7b5e4a8f",
  "type": "Claromentis",
  "created_at": "2026-02-08T14:05:00Z",
  "updated_at": "2026-02-08T15:10:00Z"
}

Obtener configuración

curl "https://{BASE_URL}/api/v1/app/integration/claromentis/{integrationID}/config" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

Ejemplo de respuesta

{
  "base_url": "https://claromentis.auroralabs.com",
  "site": "Knowledge Base"
}

Iniciar sincronización

curl -X POST "https://{BASE_URL}/api/v1/app/integration/claromentis/{integrationID}/ingest" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \

Ejemplo de respuesta

{
  "type": "sync_started",
  "current_artifact_count": 6,
  "integration_item_count": 24
}

Errores y casos límite

403: conector no habilitado o sin permisos.
404: integración no encontrada.

Primeros pasos

Construye con Zylon

Coding Agents

Integración Claromentis

Solicitud básica y respuesta

Actualizar credenciales

Obtener configuración

Iniciar sincronización

Errores y casos límite

​Solicitud básica y respuesta

​Actualizar credenciales

​Obtener configuración

​Iniciar sincronización

​Errores y casos límite

Solicitud básica y respuesta

Actualizar credenciales

Obtener configuración

Iniciar sincronización

Errores y casos límite