Skip to content
v3.0.1 — MCP OAuth, organizations, passkeys, SSR adaptersChangelog
Convex Auth
Esc
↑↓navigate↵open⌘Jpreview
On this page

API keys

Drop-in forms and lists for issuing and managing API keys.

Forms and lists for the API keys feature — issue, rotate, and revoke keys without building the UI yourself.

ConvexApiKeyCreateForm

Generics: <Scope>

Props

Name Type Optional
apiEnabled boolean No
classNames ConvexApiKeyClassNames Yes
copy ConvexApiKeyCreateFormCopy Yes
creating boolean No
expirationOptions readonly ConvexApiKeyExpirationOption[] Yes
onExpiresInDaysChange (value: string) => void No
onIpAllowlistChange (value: string) => void No
onNameChange (value: string) => void No
onScopesChange (value: Scope[]) => void No
onSubmit () => void No
scopeOptions readonly Scope[] No
state ConvexApiKeyCreateFormState<Scope> No

classNames keys

Key Type
actions string
createCard string
createContent string
input string
keyDetails string
keyName string
keyPrefix string
keyStatus string
label string
labelText string
list string
listCard string
listContent string
listHeader string
metadata string
primaryButton string
primaryButtonDisabled string
scopeButton string
scopeButtonDisabled string
scopeButtonSelected string
scopeList string
secondaryButton string
select string
stateText string
tag string
tags string
textarea string

copy keys

Key Type
createLabel string
creatingLabel string
expirationLabel string
ipAllowlistLabel string
ipAllowlistPlaceholder string
nameLabel string
namePlaceholder string

ConvexApiKeyList

Generics: <Scope, ApiKeyId>

Props

Name Type Optional Description
apiKeys readonly ConvexApiKeyListItem<Scope, ApiKeyId>[] | undefined No
classNames ConvexApiKeyClassNames Yes
copy ConvexApiKeyListCopy No
formatTimestamp (timestamp: number) => string Yes
onRevoke (apiKeyId: ApiKeyId) => void No
onRotate (apiKeyId: ApiKeyId) => void No
renderTag (label: string) => ReactNode Yes

classNames keys

Key Type
actions string
createCard string
createContent string
input string
keyDetails string
keyName string
keyPrefix string
keyStatus string
label string
labelText string
list string
listCard string
listContent string
listHeader string
metadata string
primaryButton string
primaryButtonDisabled string
scopeButton string
scopeButtonDisabled string
scopeButtonSelected string
scopeList string
secondaryButton string
select string
stateText string
tag string
tags string
textarea string

copy keys

Key Type
createdByLabel string
emptyMessage string
expiresLabel string
lastUsedLabel string
loadingMessage string
neverLabel string
revokeLabel string
rotateLabel string
unknownCreatorLabel string

Was this page helpful?