Flow status history

GET

/flow/v1/flows/{flowUuid}/status-histories

Returns the complete state history of a flow with timestamps. Enables auditing and reconstruction of the collection's lifecycle.

Ordered by timestamp descending (newest first). Each entry includes the previous status, the new status and the change timestamp.

Autorizaciones

OAuth2

OAuth2 security scheme

clientCredentials Flow

Token URL"/api/v2/auth/token"

Scopes:

• "zertiban-api"Access to the API

Parámetros

Header Parameters

x-tenant-id*

UUID of the business that owns the flow

Tipo

string

Requerido

Formato

"uuid"

Path Parameters

flowUuid*

UUID of the flow whose history is requested

Tipo

string

Requerido

Formato

"uuid"

Respuestas

Details of flow states

Content-Type

application/json

[

  

{

  

  

"previousStatus": "CREATED",

  

  

"newStatus": "IN_PROGRESS",

  

  

"changedAt": "2025-10-15T09:10:00Z"

  

}

]

GET

/flow/v1/flows/{flowUuid}/status-histories

Playground

Autorización

OAuth2

Headers

x-tenant-id*

Variables

Key

Value

flowUuid*

Ejemplos