Logs API

Fetch runtime logs from your deployed application. Useful for debugging crashes, errors, or unexpected behavior after a deployment.

GET/organizations/:orgId/projects/:projectId/logs?stage=production

Fetch application logs for a specific stage (stage is production or development). Only your application logs are returned — platform system logs (lifecycle events, runtime hooks, access logs) are filtered server-side.

start: ISO 8601 or unix ms. Defaults to 1 hour ago.
end: ISO 8601 or unix ms. Defaults to now.
filter: CloudWatch filter pattern (e.g. "error", -"health").
limit: 1–1000, defaults to 100.

External API constraints

start must be within the last 7 days
Query window (end - start) must be 1 hour or less
Pagination is not supported (single call per request)

Response

{
  "events": [
    {
      "timestamp": 1742000000000,
      "message": "Server started on port 8080",
      "instance": "f8a2d91c7e3b"
    },
    {
      "timestamp": 1742000005000,
      "message": "GET /api/users 200 12ms",
      "instance": "f8a2d91c7e3b"
    }
  ]
}

The instance field identifies the Lambda container that produced each log line. Group logs by the same instance value to trace a single container’s lifecycle — useful for debugging cold starts or per-instance state.