Create surface API key | Runtype Documentation

Create a new API key for a surface. The plaintext key is only returned on creation.

AuthorizationBearer

API key or Clerk session token

idstringRequired

surfaceIdstringRequired

This endpoint expects an object.

environmentenumOptionalDefaults to test

Allowed values:

expiresAtdatetimeOptional

namestringOptional<=255 characters

rateLimitPerDayintegerOptional>=1

rateLimitPerMinuteintegerOptional>=1

scopeslist of stringsOptional

Surface key created

createdAtstring

environmentstring

expiresAtstring or null

idstring

isActiveboolean

keystring

keyHintstring or null

keyPrefixstring

namestring or null

rateLimitPerDayinteger or null

rateLimitPerMinuteinteger or null

scopeslist of strings

surfaceIdstring

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/products/id/surfaces/surfaceId/keys \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Production Key",
>	"rateLimitPerDay": 5000,
>	"rateLimitPerMinute": 60,
>	"scopes": [
>	"answer-questions",
>	"create-ticket"
>	]
>	}'