Saltar al contenido principal

kobana inbox workflow-runs

Comandos de kobana inbox workflow-runs. Toda opción global (Opciones globales) vale aquí.

ComandoHTTPDescripción
workflow-runs listGET /v1/workflow-runsListar ejecuciones de workflow
workflow-runs getGET /v1/workflow-runs/{id}Obtener ejecución de workflow

workflow-runs list​

Listar ejecuciones de workflow

kobana inbox workflow-runs list [OPCIONES]

GET /v1/workflow-runs

Paginación por keyset. Los filtros son query params tipados (campo=valor, campo[op]=valor). Los pasos no vienen incluidos en el listado — GET /v1/workflow-runs/{id} los devuelve.

Parámetros de consulta

NombreTipoObligatorioDescripción
limitintegerno
cursorstringnoCursor opaco devuelto en meta.next_cursor de la página anterior.
sort_bystringnoCampo por el que ordenar. Permitidos: created_at, updated_at, status. Sin él, el orden es created_at descendente. Valores: created_at, updated_at, status.
sort_orderstringnoasc (por defecto) o desc. Requiere sort_by. Valores: asc, desc.
statusstringnoIgualdad. También status[in]=a,b. Valores: pending, running, success, failed.
email_idstringnoIgualdad. También email_id[in]=a,b.
inbox_idstringnoIgualdad. También inbox_id[in]=a,b.
agent_idstringnoIgualdad. También agent_id[in]=a,b.
agent_run_idstringnoEquality. Also agent_run_id[in]=a,b.
created_atstringnoIgualdad. También created_at[in]=a,b y created_at[gt|gte|lt|lte].
created_at[gte]stringno
created_at[lte]stringno
finished_atstringnoIgualdad. También finished_at[in]=a,b y finished_at[gt|gte|lt|lte].
finished_at[gte]stringno
finished_at[lte]stringno

Encabezados

NombreTipoObligatorioDescripción
x-origin-shared-secretstringnoSecreto compartido entre CloudFront y el origin. Obligatorio en producción; se ignora en desarrollo a menos que se configure CF_ORIGIN_SHARED_SECRET.

Respuestas

HTTPDescripción
200Página de resultados.
400El cuerpo no superó la validación de Zod. error.details contiene formErrors/fieldErrors.
404Recurso no encontrado o excluido por soft-delete.

workflow-runs get​

Obtener ejecución de workflow

kobana inbox workflow-runs get [ID] [OPCIONES]

GET /v1/workflow-runs/{id}

La ejecución con todos sus pasos en orden. Peticiones y respuestas se guardan con los valores de secrets reemplazados por [REDACTED]; los cuerpos se truncan a 4000 caracteres.

Argumentos de la ruta: id

Encabezados

NombreTipoObligatorioDescripción
x-origin-shared-secretstringnoSecreto compartido entre CloudFront y el origin. Obligatorio en producción; se ignora en desarrollo a menos que se configure CF_ORIGIN_SHARED_SECRET.

Respuestas

HTTPDescripción
200Éxito.
404Recurso no encontrado o excluido por soft-delete.