POST
/
v1
/
identities.createIdentity
curl --request POST \
  --url https://api.unkey.dev/v1/identities.createIdentity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "externalId": "user_123",
  "meta": {},
  "ratelimits": [
    {
      "name": "tokens",
      "limit": 10,
      "duration": 1000
    }
  ]
}'
{
  "identityId": "id_123"
}

Identities are in public beta. Please report any issues to support@unkey.dev

Create a new identity in the system. This might not be necessary as newly created keys automatically create an identity if required.

Identities map your users, organisations or other entities to keys. They can be used to share metadata and limits.

Read more about identities

​
Changelog

DateChanges
Jul 17 2024Introduced endpoint

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Response

200
application/json

The configuration for an api

The response is of type object.