Update Event
PATCH
/v2/project/{project_key}/event/{event_id}Update fields on a single event. Only the fields you include are changed — all other fields remain unchanged.
Path parameters
| Parameter | Description |
|---|---|
project_key | Your project's API key |
event_id | The numeric event ID |
Updatable fields
| Field | Type | Description |
|---|---|---|
event_text | string | Rename the event |
event_property | object or string | Replace the event's metadata |
url | string | Update the associated page URL |
event_path | string | Update the associated URL path |
session | string | Update the session identifier |
status | integer | 1 = active, 2 = soft-delete |
Example: rename an event
curl -X PATCH "https://api-{region}.mida.so/v2/project/YOUR_PROJECT_KEY/event/9876" \
-H "Authorization: Bearer YOUR_GENERATED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_text": "Pricing CTA Clicked — Mobile"
}'
Example: update event metadata
curl -X PATCH "https://api-{region}.mida.so/v2/project/YOUR_PROJECT_KEY/event/9876" \
-H "Authorization: Bearer YOUR_GENERATED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_property": {"device": "mobile", "button_id": "hero-cta"}
}'
Success response
{
"success": true,
"event_id": 9876
}
Error responses
| Status | Meaning |
|---|---|
400 | Invalid field values or malformed request body |
401 | Invalid or missing API key |
404 | Event not found or belongs to a different project |