Update an existing API key by ID

POST

https://example.com

api

auth

api-key

update

Update an existing API key by ID

curl --request POST \
  --url https://example.com/api/auth/api-key/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expiresIn": "<string>",
  "keyId": "<string>",
  "permissions": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({expiresIn: '<string>', keyId: '<string>', permissions: '<string>'})
};

fetch('https://example.com/api/auth/api-key/update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://example.com/api/auth/api-key/update"

payload = {
    "expiresIn": "<string>",
    "keyId": "<string>",
    "permissions": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://example.com/api/auth/api-key/update"

	payload := strings.NewReader("{\n  \"expiresIn\": \"<string>\",\n  \"keyId\": \"<string>\",\n  \"permissions\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "createdAt": "2023-11-07T05:31:56Z",
  "enabled": true,
  "id": "<string>",
  "rateLimitEnabled": true,
  "requestCount": 123,
  "updatedAt": "2023-11-07T05:31:56Z",
  "userId": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "lastRefillAt": "2023-11-07T05:31:56Z",
  "lastRequest": "2023-11-07T05:31:56Z",
  "metadata": {},
  "name": "<string>",
  "permissions": "<string>",
  "prefix": "<string>",
  "rateLimitMax": 123,
  "rateLimitTimeWindow": 123,
  "refillAmount": 123,
  "refillInterval": 123,
  "remaining": 123,
  "start": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer token authentication

Body

application/json

expiresIn

string

required

keyId

string

required

The id of the Api Key

permissions

string

required

configId

string | null

The configuration ID to use for the API key lookup. If not provided, the default configuration will be used.

enabled

boolean | null

Whether the Api Key is enabled or not

metadata

string | null

name

string | null

The name of the key

rateLimitEnabled

boolean | null

Whether the key has rate limiting enabled.

rateLimitMax

number | null

Maximum amount of requests allowed within a window. Once the maxRequests is reached, the request will be rejected until the timeWindow has passed, at which point the timeWindow will be reset. server-only. Eg: 100

rateLimitTimeWindow

number | null

The duration in milliseconds where each request is counted. server-only. Eg: 1000

refillAmount

number | null

The refill amount

refillInterval

number | null

The refill interval

remaining

number | null

The number of remaining requests

userId

string | null

The id of the user which the api key belongs to. server-only. Eg: "some-user-id"

Response

API key updated successfully

createdAt

string<date-time>

required

created at

enabled

boolean

default:true

required

Sets if key is enabled or disabled

string

required

rateLimitEnabled

boolean

required

Whether the key has rate limiting enabled

requestCount

number

required

The number of requests made within the rate limit time window

updatedAt

string<date-time>

required

updated at

userId

string

required

The owner of the user id

expiresAt

string<date-time> | null

Expiry date of a key

lastRefillAt

string<date-time> | null

The last refill date

lastRequest

string<date-time> | null

When last request occurred

metadata

object | null

Extra metadata about the apiKey

name

string | null

The name of the key

permissions

string | null

Permissions for the api key (stored as JSON string)

prefix

string | null

The API Key prefix. Stored as plain text.

rateLimitMax

number | null

Maximum amount of requests allowed within a window

rateLimitTimeWindow

number | null

The duration in milliseconds

refillAmount

number | null

The amount to refill

refillInterval

number | null

The interval in milliseconds between refills of the remaining count. Example: 3600000 // refill every hour (3600000ms = 1h)

remaining

number | null

Remaining requests (every time api key is used this should updated and should be updated on refill as well)

start

string | null

Shows the first few characters of the API key, including the prefix. This allows you to show those few characters in the UI to make it easier for users to identify the API key.

Delete an existing API keyDelete an existing API key

Update an existing API key by ID

curl --request POST \
  --url https://example.com/api/auth/api-key/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expiresIn": "<string>",
  "keyId": "<string>",
  "permissions": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({expiresIn: '<string>', keyId: '<string>', permissions: '<string>'})
};

fetch('https://example.com/api/auth/api-key/update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://example.com/api/auth/api-key/update"

payload = {
    "expiresIn": "<string>",
    "keyId": "<string>",
    "permissions": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://example.com/api/auth/api-key/update"

	payload := strings.NewReader("{\n  \"expiresIn\": \"<string>\",\n  \"keyId\": \"<string>\",\n  \"permissions\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "createdAt": "2023-11-07T05:31:56Z",
  "enabled": true,
  "id": "<string>",
  "rateLimitEnabled": true,
  "requestCount": 123,
  "updatedAt": "2023-11-07T05:31:56Z",
  "userId": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "lastRefillAt": "2023-11-07T05:31:56Z",
  "lastRequest": "2023-11-07T05:31:56Z",
  "metadata": {},
  "name": "<string>",
  "permissions": "<string>",
  "prefix": "<string>",
  "rateLimitMax": 123,
  "rateLimitTimeWindow": 123,
  "refillAmount": 123,
  "refillInterval": 123,
  "remaining": 123,
  "start": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}