> For the complete documentation index, see [llms.txt](https://docs.flashback.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flashback.tech/support-reference/platform-api-reference/device-session-management.md). # Device/Session Management This section contains the API documentation for managing user devices and sessions in the Flashgate platform. ## Overview The Device and Session Management APIs allow users to: * View and manage their registered devices * Monitor active sessions across devices * Control device trust levels * Revoke sessions for security purposes ## Device/Session Management API Calls ### Device Management API Calls

Method	API Reference	Description
`GET/devices`	get__devices	Retrieve all user devices
`GET/devices/{id}`	get__devices-id	Get detailed information about a specific device
`POST/devices/trust`	post__devices_trust	Mark a device as trusted
`POST/devices/{id}/untrust`	post__devices_-id_untrust	Remove trust from a device
`DELETE/devices/{id}`	delete__devices_-{id}	Permanently remove a device

### Session Management API Calls

Method	API Reference	Description
`GET/sessions`	get__sessions	Retrieve all active user sessions
`POST/sessions/{id}/revoke`	post__sessions_-id_revoke	Revoke a specific session
`POST/sessions/revoke-all`	post__sessions_revoke-all	Revoke all user sessions
`POST/devices/{id}/heartbeat`	post__sessions_-id_heartbeat	Update session activity and extend expiry

## Authentication All endpoints require authentication using a Bearer token in the Authorization header. ## Common Response Format All API responses follow a consistent format: ```json { "success": boolean, "data": object | array, "message": string, "error": string } ``` ## Error Handling The APIs return appropriate HTTP status codes: * `200` - Success * `404` - Resource not found * `500` - Internal server error ## Rate Limiting These APIs are subject to rate limiting to prevent abuse. Please implement appropriate retry logic with exponential backoff in your applications. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.flashback.tech/support-reference/platform-api-reference/device-session-management.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.