Add GET /v1/credentials/totp to list recent 2FA codes per org (#3770)

fern/credentials/totp.mdx

@@ -211,3 +211,20 @@ One time login links are supported by breaking your workflow / task into two par
 You will need to set up something (e.g. Zapier) that monitors the email inbox for incoming magic links. Once you get the link, you can use it to trigger the rest of your task / workflow.
 
 When triggering the rest of your task / workflow, you can pass the one time login link as the starting point (e.g. url parameter), and Skyvern will start the new session already logged in.
+
+## Listing Recent TOTP Codes
+
+Once your integration is forwarding codes, you can retrieve recent entries for your organization.
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/credentials/totp?totp_identifier=user@example.com&limit=10" \
+  -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+**Query parameters**
+- `totp_identifier` *(optional)* – filter by the identifier you provided when the code was sent (email, phone, etc.).
+- `workflow_run_id` *(optional)* – restrict results to a particular workflow run.
+- `otp_type` *(optional)* – filter on `totp` or `magic_link`.
+- `limit` *(optional)* – number of records to return (default `50`, maximum `200`).
+
+The response is a list of TOTP objects, ordered newest first. Skyvern only returns codes created within the last `TOTP_LIFESPAN_MINUTES` (10 minutes by default).

fern/docs.yml

@@ -192,6 +192,7 @@ navigation:
               - POST /v1/credentials/{credential_id}/delete
               - GET /v1/credentials
               - POST /v1/credentials/totp
+              - GET /v1/credentials/totp
           - section: Artifacts
             contents:
               - GET /v1/artifacts/{artifact_id}