For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
BlogLog InRequest Demo
HomeProductDevelopersSelf-HostingChangelog
HomeProductDevelopersSelf-HostingChangelog
  • Getting Started
    • Overview
  • Workflows SDK
    • Introduction
    • Installation
    • Core Concepts
    • Defining Control Flow
    • Configuration
    • Custom Docker Images
  • Client SDK
    • Introduction
    • Authentication
    • API Versioning
      • POSTExecute Workflow
      • POSTExecute Workflow Async
      • STREAMExecute Workflow as Stream
      • GETCheck Workflow Execution Status
      • POSTSubmit Workflow Execution Actuals
        • GETRetrieve Workflow Execution Detail
        • POSTCreate Monitoring Event
LogoLogo
BlogLog InRequest Demo
Client SDKWorkflowsWorkflow Executions

Create Monitoring Event

Beta
POST
https://api.vellum.ai/monitoring/v1/events
POST
/monitoring/v1/events
1import requests
2
3url = "https://api.vellum.ai/monitoring/v1/events"
4
5payload = [
6 {
7 "name": "node.execution.initiated",
8 "body": {
9 "node_definition": {
10 "name": "string",
11 "module": ["string"],
12 "id": "string"
13 },
14 "inputs": {}
15 },
16 "id": "string",
17 "timestamp": "2024-01-15T09:30:00Z",
18 "trace_id": "string",
19 "span_id": "string"
20 }
21]
22headers = {
23 "X-API-KEY": "<apiKey>",
24 "Content-Type": "application/json"
25}
26
27response = requests.post(url, json=payload, headers=headers)
28
29print(response.json())
1{
2 "count": 1,
3 "success": true
4}
Accept an event or list of events and publish them to ClickHouse for analytics processing.
Was this page helpful?
Previous

Search

Next
Built with

Authentication

X-API-KEYstring
API Key authentication via header

Headers

X-API-VersionstringOptional

Request

This endpoint expects a list of objects or an object.
CreateWorkflowEventRequest0list of objectsRequired
OR
WorkflowEventobjectRequired

Response

countinteger
Number of events processed
successbooleanDefaults to true
Indicates whether the event was published successfully.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error