List Revivn Asset Retrievals
Look up the status or tracking number of Revivn device returns
Fetches asset retrievals from Revivn so the agent can answer status questions about in-flight device returns — "where's my return box?", "has my old laptop shipped back yet?" — without anyone logging into Revivn.
How It Works
The tool queries Revivn's retrievals and returns their current details, including order status and tracking number. Results can be filtered by:
- Order number — look up one specific retrieval
- Serial number — find the retrieval for a specific device
- Created / updated date — narrow to recent retrievals
Large result sets are paginated.
Configuration
In the Risotto dashboard, select Tools in the sidebar. Select Revivn in the Tool groups list. Find Revivn List Asset Retrievals V1 and click Set up. Fill in these settings, then click Save:
| Setting | Required | Description |
|---|---|---|
| Host | Yes | Revivn API base URL: https://api.revivn.com (production) or https://api.revivn.dev (sandbox). |
| Client Id | Yes | OAuth2 client ID issued by Revivn. |
| Client Secret | Yes | OAuth2 client secret issued by Revivn. Stored encrypted. |
Example Runbook Uses
- An offboarded employee asks where their return kit is — the agent looks up the retrieval by serial number and shares the tracking number
- IT audits last month's device returns by filtering on created date
Troubleshooting
A retrieval created in Risotto doesn't show up
Confirm both Revivn tools point at the same Host — a retrieval created in sandbox won't appear when listing against production, and vice versa.
Authentication fails
Confirm the Client ID and Secret match the environment of the configured Host.
Related
- Create Revivn Asset Retrieval — file a new device-return request
Something wrong or missing? Report an issue · View as Markdown