Skip to main content

Monitor endpoints

Use the /monitor endpoint to monitor and modify messages passed between Langflow components, vertex builds, and transactions.

Get Vertex builds​

Retrieve Vertex builds for a specific flow.


_10
curl -X GET \
_10
"$LANGFLOW_URL/api/v1/monitor/builds?flow_id=$FLOW_ID" \
_10
-H "accept: application/json"

Delete Vertex builds​

Delete Vertex builds for a specific flow.


_10
curl -X DELETE \
_10
"$LANGFLOW_URL/api/v1/monitor/builds?flow_id=$FLOW_ID" \
_10
-H "accept: */*"

Get messages​

Retrieve a list of all messages:


_10
curl -X GET \
_10
"$LANGFLOW_URL/api/v1/monitor/messages" \
_10
-H "accept: application/json"

To filter messages, use the flow_id, session_id, sender, and sender_name query parameters.

To sort the results, use the order_by query parameter.

This example retrieves messages sent by Machine and AI in a given chat session (session_id) and orders the messages by timestamp.


_10
curl -X GET \
_10
"$LANGFLOW_URL/api/v1/monitor/messages?flow_id=$FLOW_ID&session_id=01ce083d-748b-4b8d-97b6-33adbb6a528a&sender=Machine&sender_name=AI&order_by=timestamp" \
_10
-H "accept: application/json"

Delete messages​

Delete specific messages by their IDs.

This example deletes the message retrieved in the previous Get messages example.


_10
curl -v -X DELETE \
_10
"$LANGFLOW_URL/api/v1/monitor/messages" \
_10
-H "accept: */*" \
_10
-H "Content-Type: application/json" \
_10
-d '["MESSAGE_ID_1", "MESSAGE_ID_2"]'

Update message​

Update a specific message by its ID.

This example updates the text value of message 3ab66cc6-c048-48f8-ab07-570f5af7b160.


_10
curl -X PUT \
_10
"$LANGFLOW_URL/api/v1/monitor/messages/3ab66cc6-c048-48f8-ab07-570f5af7b160" \
_10
-H "accept: application/json" \
_10
-H "Content-Type: application/json" \
_10
-d '{
_10
"text": "testing 1234"
_10
}'

Update session ID​

Update the session ID for messages.

This example updates the session_ID value 01ce083d-748b-4b8d-97b6-33adbb6a528a to different_session_id.


_10
curl -X PATCH \
_10
"$LANGFLOW_URL/api/v1/monitor/messages/session/01ce083d-748b-4b8d-97b6-33adbb6a528a?new_session_id=different_session_id" \
_10
-H "accept: application/json"

Delete messages by session​

Delete all messages for a specific session.


_10
curl -X DELETE \
_10
"$LANGFLOW_URL/api/v1/monitor/messages/session/different_session_id_2" \
_10
-H "accept: */*"

Get transactions​

Retrieve all transactions, which are interactions between components, for a specific flow.


_10
curl -X GET \
_10
"$LANGFLOW_URL/api/v1/monitor/transactions?flow_id=$FLOW_ID&page=1&size=50" \
_10
-H "accept: application/json"

See also​

Search