# Device/Session Management This section contains the API documentation for managing user devices and sessions in the Flashback 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: 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: ``` GET https://docs.flashback.tech/support-reference/platform-api-reference/device-session-management.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.