Emite un token de acceso OAuth, busca una acción en el catálogo público y llámala en POST /api/v1/actions/<id>.
Agentes, evidencias, gobernanza, comercio y divulgación están en Trustvice 360. Regístrate gratis y abre todas las suites desde un solo panel.
© 2026 Trustvice. Reservados todos los derechos. Trustvice es un producto de Trustvice. Secured and supercharged by Avonao Labs.
Denunciar abusoQuieres que un llamador automático, un agente o un script, use una capacidad de Trustvice. Cada capacidad es una acción registrada con un id estable, una entrada tipada y el mismo sobre de respuesta, así que una sola forma de petición sirve para todas.
Trustvice 360tvc_… y su secreto)curlEl código lee los secretos de variables de entorno. Guárdalos en tu shell o en tu gestor de secretos, nunca en un archivo que subas. Las llamadas a acciones también envían X-Workspace-Id.
Cambia el id y el secreto de tu cliente OAuth por un token de acceso con client_credentials. El token dura una hora (expires_in: 3600) y lleva el alcance de permisos del cliente. Expórtalo como TRUSTVICE_TOKEN.
Todas las acciones responden con el mismo sobre: ok: true con data, o ok: false con un código y un mensaje en error.
{ "ok": true, "data": { …action output… } }
{ "ok": false, "error": { "code": , : } }401 unauthenticated limpio, nunca una petición a medio autenticar.403 permission_denied con el permiso exacto que se requería.
Trustvice 360: confíe en sus agentes de IA y gobiérnelos con evidencia firmada y verificable.
Digital Trust. On the Record.
La plataforma de innovación
para Software‑as‑a‑Service.
curl -sS -X POST https://api.trustvice.com/api/v1/oauth/token \
-H "Content-Type: application/json" \
-d "{\"grant_type\":\"client_credentials\",\"client_id\":\"tvc_…\",\"client_secret\":\"$TRUSTVICE_CLIENT_SECRET\"}"POST /api/v1/oauth/token
{ "grant_type": "client_credentials",
"client_id": "tvc_…", "client_secret": "…" }El catálogo público de acciones registradas se sirve en GET /api/v1/actions, sin credencial. Los ids de acción son jerárquicos: <domain>.<noun>.<verb>. La referencia de la API lista el esquema de entrada y los permisos de cada acción.
curl -sS https://api.trustvice.com/api/v1/actionsEnvía la entrada de la acción como JSON a POST /api/v1/actions/<action-id>, con el token de acceso y el id de tu workspace. Las claves API de workspace se rechazan aquí a propósito: una clave API da acceso al workspace, no intención de agente.
curl -sS -X POST https://api.trustvice.com/api/v1/actions/<action-id> \
-H "Authorization: Bearer $TRUSTVICE_TOKEN" \
-H "X-Workspace-Id: ws_…" \
-H "Content-Type: application/json" \
-d '{ … }'POST /api/v1/actions/<action-id>
Authorization: Bearer <oauth-access-token>
X-Workspace-Id: ws_…
Content-Type: application/json
{ …input fields… }Lee primero ok. Si todo va bien, la salida está en data; si falla, error trae un code legible por máquina y una frase para personas. Un 404 o 422 de dominio es el producto respondiendo, no un error de transporte.
Copiado de: /docs/actions
Idempotency-Key.412 confirmation_required.Todo lo anterior procede de las docs de Trustvice enlazadas en esta página. Donde una página de las docs dice más, esa es la referencia.
Gestiona 412 confirmation_required: emite un token de confirmación y repite la llamada con X-Trustvice-Confirmation.
Un email breve cuando añadimos recetas. Ningún otro correo, y puedes darte de baja desde cualquier mensaje.
Un endpoint POST por cada acción registrada, con el mismo comportamiento por REST y por MCP. Las docs listan cada acción con su entrada y sus permisos.