HTTP API

The HTTP API searches logs and reads stored errors for one organization. The MCP tools use the same data.

Authentication

Send a session token as a bearer token. Create a token with your email and password. It expires after one hour.

curl -H "Authorization: Bearer $POSTDEPLOY_TOKEN" \
  "https://www.postdeploy.dev/api/search?q=checkout"

Pass the search text as q, with at least two characters. Optional parameters are scope (recent or archived), limit (up to 200), from_us and to_us.

An archived search can return stats.nextCursor. Pass it as cursor for the next page.

Errors and limits

Errors are JSON, for example {"detail": "unauthorized"}. Over a limit, the API answers 429 with Retry-After.

Endpoints

This table lists the public endpoints of this service.

MethodPathUse
GET/api/searchSearch logs
GET/api/events/{id}Read one stored error
POST/api/{project}/envelopeSend events. Sentry SDKs use this path with the DSN.
GET / POST / DELETE/api/sessionRead, create or end a session
POST/mcpMCP server

The dashboard calls other routes. These routes can change without notice.