Runs

Ejecuta un Met (agente) del workspace

El corazón del plano agéntico y la llamada que debita Energía. Con stream: false (por defecto) responde el JSON del run ya terminado. Con stream: true la respuesta deja de ser JSON: pasa a ser un stream SSE de eventos run.*, y el esquema documentado acá describe solo el caso sin streaming. Elige streaming cuando quieras mostrar la respuesta palabra por palabra; si no, la forma simple alcanza.

post/workspaces/{workspaceId}/runs

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/workspaces/{workspaceId}/runs
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Path parameters

workspaceIdnumber required

ID numérico del workspace. Debe ser el mismo workspace de tu API key: pedir otro devuelve 401.

Request body

attachmentsstring[]

Adjuntos de entrada (imágenes/archivos) para que el Met los "vea" — p.ej. una foto para clasificar o cotizar. Cada uno: { url, mime_type?, name?, kind? }.

conversation_idnumber

Conversación existente para dar memoria al run. Sin ella → efímera.

inputstring required
metstring

Met a ejecutar directo: nombre (case-insensitive) o id de un Met del workspace. Bind directo, sin orquestador. Con conversation_id fija el default de la conversación (ver docstring de la clase). Si no matchea ningún Met → 400.

streamboolean

Respuesta SSE con los eventos del run en vivo.

tool_policy'none'

Ejecución aislada sin herramientas ni contexto dinámico del workspace. Requiere un Met válido; nunca usa el orquestador.

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "conversation_id": 1842,
    "created_at": "2026-07-30T04:12:33.120Z",
    "energy": {
      "by_model": [
        {
          "cost_usd": 0.0123,
          "count": 2,
          "model": "Brillante"
        }
      ],
      "cost_usd": 0.0184,
      "executions": 3
    },
    "id": "run_01HXYZ",
    "livemode": true,
    "met": "ventas",
    "object": "run",
    "status": "completed"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.