API Reference
The Tracevium REST API lets you integrate monitoring data into your own tools and workflows.
Base URL
https://tracevium.com/api/v1
Authentication
All authenticated endpoints require a Bearer token in the Authorization header. Obtain a token by calling the login endpoint.
Authorization: Bearer <your_token>
Most endpoints also require an X-Organization-ID header:
X-Organization-ID: <org_id>
Auth
POST
/api/v1/auth/signupCreate a new accountPOST
/api/v1/auth/loginObtain a session tokenGET
/api/v1/auth/verify_emailVerify email addressPOST
/api/v1/auth/resend_verificationResend verification emailProfile
GET
/api/v1/profileGet current user profilePATCH
/api/v1/profileUpdate profile (name, password)Organisations
GET
/api/v1/organizationsList organisations you belong toPOST
/api/v1/organizationsCreate an organisationGET
/api/v1/organizations/:idGet organisation detailsPATCH
/api/v1/organizations/:idUpdate organisationDELETE
/api/v1/organizations/:idDelete organisationGET
/api/v1/organizations/:id/membershipsList membersPOST
/api/v1/organizations/:id/membershipsInvite a memberProjects
GET
/api/v1/projectsList projectsPOST
/api/v1/organizations/:id/projectsCreate a projectGET
/api/v1/projects/:idGet projectPATCH
/api/v1/projects/:idUpdate projectDELETE
/api/v1/projects/:idDelete projectGET
/api/v1/projects/:id/signing_secretGet signing secretPOST
/api/v1/projects/:id/rotate_signing_secretRotate signing secretEndpoints
GET
/api/v1/projects/:id/api_endpointsList endpointsPOST
/api/v1/projects/:id/api_endpointsCreate endpointGET
/api/v1/api_endpoints/:idGet endpoint detailsPATCH
/api/v1/api_endpoints/:idUpdate endpointDELETE
/api/v1/api_endpoints/:idDelete endpointGET
/api/v1/api_endpoints/:id/uptimeGet uptime statisticsIncidents
GET
/api/v1/incidentsList all incidentsGET
/api/v1/incidents/open_countCount open incidentsGET
/api/v1/incidents/:idGet incident detailsPOST
/api/v1/incidents/:id/acknowledgeAcknowledge incidentGET
/api/v1/incidents/:id/incident_notesList incident notesPOST
/api/v1/incidents/:id/incident_notesAdd incident noteWebhook events
POST
/ingest/webhook/:org_slug/:project_keyIngest a webhook (public, no auth)GET
/api/v1/projects/:id/webhook_eventsList events for a projectGET
/api/v1/webhook_events/:idGet event with full payloadPOST
/api/v1/webhook_events/:id/replayReplay eventGET
/api/v1/webhook_events/:id/deliveriesList delivery attemptsPublic status
GET
/api/v1/status/:org_slug/:project_keyGet project status (no auth)Response format
All responses are JSON. Errors return an error or errors field:
{ "error": "Unauthorized" }
// Validation errors:
{ "errors": { "url": ["can't be blank"] } }Rate limiting
Authenticated endpoints: 300 requests / minute per IP. Webhook ingestion: 60 requests / minute. Responses include X-RateLimit-Remaining. Exceeding the limit returns 429 Too Many Requests.
Pagination
List endpoints support page and per_page query parameters. Responses include a meta object with total_count, current_page, and total_pages.
GET /api/v1/incidents?page=2&per_page=25