Documentación

Referencia de API

Consultar ejecuciones de herramientas

GET/v1/tool-runs

Admite flat constante por llamada, input precalculado por entradas y usage según uso final. pricing.quote_required determina si se exige cotización; requires_usage, si se exige límite de coste y uso final confirmado. Ninguno se deduce de schema_version. Con metered_pricing apagado solo se restringen llamadas nuevas que requieren uso final; reglas constantes/por entrada sin ese requisito siguen disponibles. La clave actual necesita autorización de herramientas; identidad y resultados quedan limitados a la clave original. Con el interruptor general apagado el catálogo está vacío; el catálogo anónimo no autoriza la ejecución. Solo lista ejecuciones de la clave original, ordenadas estrictamente por created_at descendente e id descendente; id deshace empates del mismo segundo. next_cursor es un cursor opaco de pareja y se devuelve sin cambios; formato incorrecto: 400 invalid_cursor. La paginación no es instantánea temporal; actualiza la primera página para ver nuevos registros anteriores al cursor.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Parámetros de consulta

  • cursorstringOpcional

    next_cursor de la respuesta original; no lo construyas. Cursores inválidos devuelven 400 invalid_cursor.

  • limitintegerOpcional

    Catálogo: 1–100, valores inválidos usan 20; ejecuciones: 1–100, valores inválidos usan 20.

Respuestas y errores

HTTP 200

Ejecuciones consultadas correctamente

application/json

Tipo
object
Campos obligatorios
items
  • itemsarrayObligatorio

    Matriz de herramientas o ejecuciones de la página actual.

    Campos secundarios de items (1)
    • []objectOpcional
      Campos secundarios de [] (10)
      • idstringObligatorio

        Identificador público del objeto, usado en su ruta de detalles.

      • tool_idstringObligatorio

        ID de herramienta del catálogo ejecutable de la clave actual.

      • versionstringObligatorio

        Versión de contrato/capacidad o herramienta; la ejecución usa la versión del catálogo.

      • statusstringObligatorio

        submitting/running/submission_unknown/succeeded/failed; submission_unknown indica resultado de envío desconocido. No reenvíes con otro Idempotency-Key.

      • outputunknownObligatorio

        JSON definido por output_schema de la herramienta; no supongas que sigue existiendo tras caducar.

      • error_codestringOpcional

        Código público de error para decisiones de flujo.

      • billingobjectObligatorio

        Estado de facturación independiente, no sustituible por estado de generación.

        Campos secundarios de billing (7)
        • review_requiredbooleanOpcional

          Las pruebas de facturación requieren revisión manual.

        • reasonstringOpcional

          Motivo público de acción no disponible o revisión de facturación.

        • usageunknownOpcional

          Valor JSON definido por esquema o protocolo de la herramienta; sin campos fijos supuestos.

        • breakdownunknownOpcional

          Valor JSON definido por esquema o protocolo de la herramienta; sin campos fijos supuestos.

        • statusstringObligatorio

          Estado actual del objeto; evalúalo aparte de facturación y guardado.

        • reserved_usdstringObligatorio

          Reserva máxima en USD como cadena.

        • charged_usdstringObligatorio

          Importe en USD confirmado actualmente, como cadena.

        Rama allOf 1

        Tipo: object

        Obligatorio en esta rama: status, reserved_usd, charged_usd

        • review_requiredbooleanOpcional

          Las pruebas de facturación requieren revisión manual.

        • reasonstringOpcional

          Motivo público de acción no disponible o revisión de facturación.

        • usageunknownOpcional

          Valor JSON definido por esquema o protocolo de la herramienta; sin campos fijos supuestos.

        • breakdownunknownOpcional

          Valor JSON definido por esquema o protocolo de la herramienta; sin campos fijos supuestos.

        • statusstringObligatorio

          Estado actual del objeto; evalúalo aparte de facturación y guardado.

        • reserved_usdstringObligatorio

          Reserva máxima en USD como cadena.

        • charged_usdstringObligatorio

          Importe en USD confirmado actualmente, como cadena.

      • result_expiredbooleanObligatorio

        Si el resultado caducó; facturación e idempotencia se conservan.

      • created_atintegerObligatorio

        Fecha de creación en segundos Unix.

      • updated_atintegerObligatorio

        Última actualización en segundos Unix.

  • next_cursorstringOpcional

    Cursor opaco de pareja created_at/id; devuélvelo sin cambios. Un formato incorrecto devuelve 400 invalid_cursor; ausente o vacío indica última página.

HTTP 400

Campos o parámetros de solicitud inválidos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 401

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 404

Objeto/capacidad no disponible o función desactivada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 409

Conflicto de idempotencia/cotización, objeto no preparado o aún referenciado.

application/json

Tipo
object
Campos obligatorios
error

HTTP 429

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 503

Servicio, precios o almacenamiento no disponibles.

application/json

Tipo
object
Campos obligatorios
error