Provider Integrations

Sync secrets with Vercel, Netlify, and Railway.

Supported Providers

Provider	Status
Vercel	Available
Netlify	Available
Railway	Available

---

CLI Workflow

Connect

keyway connect vercel   # Opens browser for OAuth

List Connections

keyway connections

Sync Secrets

keyway sync vercel                              # Push production → Vercel
keyway sync vercel -e staging --provider-env preview
keyway sync vercel --pull                       # Import from Vercel
keyway sync vercel --allow-delete -y            # Full sync (deletes too)

Disconnect

keyway disconnect vercel

---

API Endpoints

List Connections

GET /v1/integrations/connections

Connect Provider

GET /v1/integrations/:provider/authorize

Redirects to provider OAuth.

List Projects

GET /v1/integrations/connections/:id/projects

Preview Sync

GET /v1/integrations/vaults/:owner/:repo/sync/preview
  ?connectionId=...&projectId=...&direction=push

Returns toCreate, toUpdate, toDelete, toSkip.

Execute Sync

POST /v1/integrations/vaults/:owner/:repo/sync
{
  "connectionId": "...",
  "projectId": "...",
  "keywayEnvironment": "production",
  "providerEnvironment": "production",
  "direction": "push",
  "allowDelete": false
}

Delete Connection

DELETE /v1/integrations/connections/:id

---

Environment Mapping

Keyway	Vercel	Netlify	Railway
production	production	production	production
staging	preview	deploy-preview	staging
development	development	local	development
dev	development	local	development

Override with --provider-env:

keyway sync vercel -e staging --provider-env preview

---

Common Workflows

Initial Setup

keyway connect vercel
keyway sync vercel --pull    # Import existing Vercel secrets
keyway push                   # Push to Keyway

Deploy Pipeline

# Before deploy: sync Keyway → Vercel
keyway sync vercel -e production -y

Keep in Sync

# After updating secrets in Keyway
keyway sync vercel -e production

---

Best Practices

1. Start with pull - Import existing provider secrets before pushing
2. Use --allow-delete carefully - Preview first
3. Map environments explicitly - Use --provider-env to avoid mistakes
4. Keyway as source of truth - Push from Keyway, don't edit in provider UI