Sign in
API-keys

Upsert an API-key associated with a Consumer

Create or Update an API-key associated with a Consumer using ID.

put/{workspace}/consumers/{ConsumerIdForNestedEntities}/key-auth/{KeyAuthId}

Path parameters

ConsumerIdForNestedEntitiesstring required

Consumer ID for nested entities

KeyAuthIdstring required

ID of the API-key to lookup

workspacestring required
Example:747d1e5-8246-4f65-a939-b392f1ee17f8

The name or UUID of the workspace

Request body

created_atinteger nullable

Unix epoch when the resource was created.

idstring nullable

A string representing a UUID (universally unique identifier).

keystring nullable
tagsstring[] nullable

A set of strings representing tags.

ttlinteger nullable

key-auth ttl in seconds

Example request

{
  "id": "b2f34145-0343-41a4-9602-4c69dec2f269",
  "key": "IL1deIyHyQA40WpeLeA1bIUXuvTwlGjo"
}

Response

Successfully upserted API-key

created_atinteger nullable

Unix epoch when the resource was created.

idstring nullable

A string representing a UUID (universally unique identifier).

keystring nullable
tagsstring[] nullable

A set of strings representing tags.

ttlinteger nullable

key-auth ttl in seconds

Example response

{
  "consumer": {
    "id": "84a73fb8-50fc-44a7-a4d5-aa17728ee83f"
  },
  "id": "b2f34145-0343-41a4-9602-4c69dec2f269",
  "key": "IL1deIyHyQA40WpeLeA1bIUXuvTwlGjo"
}

Changes