Docs

Integrations / Other tools / Revivn

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:

SettingRequiredDescription
HostYesRevivn API base URL: https://api.revivn.com (production) or https://api.revivn.dev (sandbox).
Client IdYesOAuth2 client ID issued by Revivn.
Client SecretYesOAuth2 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.

Something wrong or missing? Report an issue · View as Markdown