kms

Create an issuer

Changed on

Create a new KMS issuer for the authenticated team. An issuer owns the asymmetric signing keys that are used to sign tokens and messages.

post/v1/kms/issuers

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v1/kms/issuers
  • Auth: HTTP bearer

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Request body

namestring required

The name of the issuer.

algorithm'RS256' | 'RS384' | 'RS512' | 'PS256' | 'PS384' | 'PS512' | 'ES256' | 'ES384' | 'ES512'

The signing algorithm to use for the issuer.

claimsSchemaobject

A JSON Schema used to validate the resolved token claims when signing tokens for this issuer.

importKeystring

The PEM-encoded private key to use for the issuer.

importKeyIdstring

The key id to use as the imported key's JWT/JWKS kid. Only allowed when importKey is provided. Not required to be unique; the addressable key id is the server-minted keyId returned in the response.

Response

algorithm'ES256' | 'ES384' | 'ES512' | 'PS256' | 'PS384' | 'PS512' | 'RS256' | 'RS384' | 'RS512' required
claimsSchemaobject
createdAtstring required
idstring required
managedBystring
namestring required
origin'external' | 'vercel' required
ownerIdstring required
updatedAtstring required

Changes