API referenceConsumerConsumer.diagnostics
Submit a diagnostics / feedback report
Accepts a diagnostics bundle (logs excerpt, state snapshot, routed networks, optional feedback) from the authenticated user for the project identified by X-Project-Id.
Authorization
bearer_auth AuthorizationBearer <token>
In: header
Header Parameters
X-Project-Id*string
UUID of the project that scopes consumer accounts, devices, sessions, and VSpaces for the request.
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for submitting a diagnostics report.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/consumer/v1/diagnostics/reports" \ -H "X-Project-Id: 11111111-1111-1111-1111-111111111111" \ -H "Content-Type: application/json" \ -d '{ "app_version": "1.0.0", "device_id": "55555555-5555-5555-5555-555555555555", "device_model": "MacBookPro18,4", "feedback": "VPN drops every few minutes", "intent": "bug-report", "log_excerpt": "...", "os_version": "14.4", "platform": "macos", "routed_cidrs": [ "10.0.0.0/8" ], "state_snapshot": "{}", "status": "connected" }'{ "consumer_account_id": "22222222-2222-2222-2222-222222222222", "id": "0193b8d2-7a3c-7000-8000-000000000000", "project_id": "11111111-1111-1111-1111-111111111111", "submitted_at": "2026-04-12T10:00:00Z"}{ "detail": "Pool slug must be unique.", "instance": "urn:forestvpn:trace:a1b2c3d4", "title": "Validation Error", "type": "https://fvpn.net/errors/validation"}{ "detail": "Pool slug must be unique.", "instance": "urn:forestvpn:trace:a1b2c3d4", "title": "Validation Error", "type": "https://fvpn.net/errors/validation"}{ "detail": "Pool slug must be unique.", "instance": "urn:forestvpn:trace:a1b2c3d4", "title": "Validation Error", "type": "https://fvpn.net/errors/validation"}{ "detail": "Pool slug must be unique.", "instance": "urn:forestvpn:trace:a1b2c3d4", "title": "Validation Error", "type": "https://fvpn.net/errors/validation"}{ "detail": "Pool slug must be unique.", "instance": "urn:forestvpn:trace:a1b2c3d4", "title": "Validation Error", "type": "https://fvpn.net/errors/validation"}