API Reference
- Customers
- Products
- Plans
- Contracts
- Invoices
- Measurements
- Auth
- Events
- Reports
- Integrations
- Credits
- Webhooks
Delete an event by refId
Use this endpoint to remove a specific event using its reference ID.
curl --request DELETE \
--url https://connect.withvayu.com/events/{refId} \
--header 'Authorization: Bearer <token>'
{
"event": {
"name": "api_call",
"timestamp": "2023-09-13T18:25:43.511Z",
"customerAlias": "customer_12345",
"ref": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
"data": {
"key1": "processing_duration",
"key2": "api_url"
},
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "<string>"
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Response
The event matching the provided refId
The distinctive label assigned to an event, serving as a critical identifier for categorizing and pricing events within the system's backend infrastructure.
"api_call"
The temporal marker denoting the exact moment of event occurrence. The timestamp is formatted as an ISO 8601 string and is expressed in Coordinated Universal Time (UTC). i.e. YYYY-MM-DDTHH:MM:SS.SSSZ
"2023-09-13T18:25:43.511Z"
A pseudonymous or otherwise obfuscated identifier uniquely assigned to each customer.
1
"customer_12345"
A universally unique identifier (UUID) or other form of high-entropy string serving as an immutable reference for each event entry.
"4f6cf35x-2c4y-483z-a0a9-158621f77a21"
curl --request DELETE \
--url https://connect.withvayu.com/events/{refId} \
--header 'Authorization: Bearer <token>'
{
"event": {
"name": "api_call",
"timestamp": "2023-09-13T18:25:43.511Z",
"customerAlias": "customer_12345",
"ref": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
"data": {
"key1": "processing_duration",
"key2": "api_url"
},
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "<string>"
}
}