Skip to content

docs: update auth signed retry examples#477

Draft
DhruvPareek wants to merge 1 commit into
docs-auth-email-account-idsfrom
docs-auth-signed-retry-examples
Draft

docs: update auth signed retry examples#477
DhruvPareek wants to merge 1 commit into
docs-auth-email-account-idsfrom
docs-auth-signed-retry-examples

Conversation

@DhruvPareek
Copy link
Copy Markdown
Contributor

@DhruvPareek DhruvPareek commented May 19, 2026

Summary

  • Update signed-retry examples to show Request:<uuid> request IDs.
  • Replace base64-like payloadToSign examples with canonical compact JSON Turnkey activity payloads.
  • Fix the export curl continuation in the touched wallet export snippet.

Test Plan

  • git diff --check main...HEAD
  • Targeted rg scan for stale base64 payloads, bare UUID Request-Id headers, and old signed-retry payload shapes.

Show Request:<uuid> request IDs and canonical compact JSON payloadToSign examples for credential add/revoke, wallet export, and session revocation. Also fixes the export curl continuation while updating that snippet.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
grid-flow-builder Ready Ready Preview, Comment May 19, 2026 0:03am

Request Review

Copy link
Copy Markdown
Contributor Author

DhruvPareek commented May 19, 2026

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

This stack of pull requests is managed by Graphite. Learn more about stacking.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 19, 2026

Greptile Summary

This PR updates the signed-retry pattern examples across three documentation snippets to align with the real Turnkey payload format and current Request:<uuid> request ID shape.

  • Replaces opaque base64 payloadToSign placeholders with canonical compact JSON Turnkey activity payloads (ACTIVITY_TYPE_UPDATE_USER_EMAIL, ACTIVITY_TYPE_DELETE_AUTHENTICATORS, ACTIVITY_TYPE_DELETE_API_KEYS, ACTIVITY_TYPE_EXPORT_WALLET) and updates all requestId values and Request-Id headers to the Request:<uuid> format.
  • Fixes a broken multi-line curl command in exporting-wallet.mdx where a missing backslash continuation caused -H \"Content-Type: application/json\" to be interpreted as a separate shell command rather than part of the curl invocation.

Confidence Score: 5/5

Safe to merge — all changes are documentation-only updates to example payloads and header values with no runtime code affected.

The changes correctly and consistently update three documentation snippets: the broken curl continuation in the export flow is fixed, the requestId format is aligned to Request:<uuid> in every affected header and JSON block, and the opaque base64 placeholders are replaced with realistic Turnkey activity JSON that matches the described activity types. No logic, schema, or API contract changes are involved.

No files require special attention.

Important Files Changed

Filename Overview
mintlify/snippets/global-accounts/authentication.mdx Updated requestId format and payloadToSign examples for the EMAIL_OTP and PASSKEY signed-retry flows; all curl headers and JSON payloads are internally consistent.
mintlify/snippets/global-accounts/exporting-wallet.mdx Fixed the missing \ continuation after -u on the first export curl call, and updated payloadToSign/requestId to match the new canonical format.
mintlify/snippets/global-accounts/managing-sessions.mdx Updated session-revocation example with ACTIVITY_TYPE_DELETE_API_KEYS payload and Request:<uuid> format; DELETE curl remains correctly without a body continuation.

Sequence Diagram

sequenceDiagram
    participant C as Client
    participant IB as Integrator Backend
    participant G as Grid

    IB->>G: POST/DELETE (initial call)
    G-->>IB: "202 { payloadToSign (Turnkey JSON), requestId: "Request:<uuid>", expiresAt }"
    IB-->>C: "{ payloadToSign, requestId }"
    C->>C: sign(payloadToSign, sessionPrivateKey) → signature
    C->>IB: "{ signature }"
    IB->>G: "Repeat same request + Grid-Wallet-Signature + Request-Id: Request:<uuid>"
    G-->>IB: 2xx (success) or encrypted credentials
Loading

Reviews (1): Last reviewed commit: "docs: update auth signed retry examples" | Re-trigger Greptile

@DhruvPareek DhruvPareek marked this pull request as draft May 19, 2026 00:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant