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 account

POST/api/v1/auth/loginObtain a session token

GET/api/v1/auth/verify_emailVerify email address

POST/api/v1/auth/resend_verificationResend verification email

Profile

GET/api/v1/profileGet current user profile

PATCH/api/v1/profileUpdate profile (name, password)

Organisations

GET/api/v1/organizationsList organisations you belong to

POST/api/v1/organizationsCreate an organisation

GET/api/v1/organizations/:idGet organisation details

PATCH/api/v1/organizations/:idUpdate organisation

DELETE/api/v1/organizations/:idDelete organisation

GET/api/v1/organizations/:id/membershipsList members

POST/api/v1/organizations/:id/membershipsInvite a member

Projects

GET/api/v1/projectsList projects

POST/api/v1/organizations/:id/projectsCreate a project

GET/api/v1/projects/:idGet project

PATCH/api/v1/projects/:idUpdate project

DELETE/api/v1/projects/:idDelete project

GET/api/v1/projects/:id/signing_secretGet signing secret

POST/api/v1/projects/:id/rotate_signing_secretRotate signing secret

Endpoints

GET/api/v1/projects/:id/api_endpointsList endpoints

POST/api/v1/projects/:id/api_endpointsCreate endpoint

GET/api/v1/api_endpoints/:idGet endpoint details

PATCH/api/v1/api_endpoints/:idUpdate endpoint

DELETE/api/v1/api_endpoints/:idDelete endpoint

GET/api/v1/api_endpoints/:id/uptimeGet uptime statistics

Incidents

GET/api/v1/incidentsList all incidents

GET/api/v1/incidents/open_countCount open incidents

GET/api/v1/incidents/:idGet incident details

POST/api/v1/incidents/:id/acknowledgeAcknowledge incident

GET/api/v1/incidents/:id/incident_notesList incident notes

POST/api/v1/incidents/:id/incident_notesAdd incident note

Webhook events

POST/ingest/webhook/:org_slug/:project_keyIngest a webhook (public, no auth)

GET/api/v1/projects/:id/webhook_eventsList events for a project

GET/api/v1/webhook_events/:idGet event with full payload

POST/api/v1/webhook_events/:id/replayReplay event

GET/api/v1/webhook_events/:id/deliveriesList delivery attempts

Public 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