Skip to content

docs(integrations): Vercel Marketplace page with OIDC resource tokens - #252

Merged
duharry0915 merged 1 commit into
mainfrom
harry/vercel-integration-docs
Sep 23, 2026
Merged

duharry0915 merged 1 commit into
mainfrom
harry/vercel-integration-docs

Conversation

@duharry0915

Copy link
Copy Markdown
Collaborator

Adds integrations/vercel: the Vercel Marketplace integration had no docs page, and the new OIDC resource-token flow (live in production as of agentmail-api #1310) had no customer-facing instructions anywhere.

Page contents

  • Install: Marketplace / vercel integration add agentmail, one resource = one organization, vercel env pull.
  • OIDC resource tokens (recommended): what the token is (five minutes, scoped to the resource's organization, no API-key management, audited with project + environment), the three steps (OIDC federation on the project, AGENTMAIL_RESOURCE_ID = the Vercel ir_ id, mint + pass as the API key), and a troubleshooting table.
  • Provisioned AGENTMAIL_API_KEY: unchanged path, with the Production-only recommendation.

Snippets

Both SDKs accept a function as the API key (Node apiKey?: Supplier<string> resolved per request in BearerAuthProvider; Python api_key: str | Callable[[], str]), so the examples pass a minting function that caches the token until a minute before expiry. The TypeScript flow is the same one verified end to end against production from a Vercel function on our own team (mint → GET /v0/inboxes → 200).

The Python inbox-create example uses create(request=CreateInboxRequest(...)), which is the signature of the released SDK (0.4.15). Several existing pages (integrate-livekit-agents, custom-domains) use keyword arguments that this signature does not accept; left for a separate fix.

fern check: 0 errors.

…e tokens

Installing from the Marketplace, the two credentials a Vercel project can
use (short-lived OIDC resource tokens minted from the deployment's
VERCEL_OIDC_TOKEN, and the provisioned AGENTMAIL_API_KEY), the mint
snippet for both SDKs using their token-supplier option, and
troubleshooting for the token flow.
@github-actions

Copy link
Copy Markdown

@duharry0915
duharry0915 merged commit 2e08771 into main Sep 23, 2026
3 checks passed
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.

2 participants