Skip to main content

updateKeyDetails

Update Details

Updates a key's settings and returns its private details. Only the fields you send change. A key on an unlimited plan ignores changes to datasets, daily_limit and monthly_limit.

Endpoint​

PUT /keys/{key}/details

See the API reference for this endpoint.

This operation needs a Management Key. Set it as userToken on the client, which sends it in the Authorization header. See setup.

Import​

import { updateKeyDetails } from "@ideal-postcodes/sdk";

Path Parameters​

NameTypeRequiredDescription
keystringyesAPI Key The API Key to retrieve. Begins ak_.

Query Parameters​

None.

Request Body​

ApiKeyDetailsEditable

Response Type​

import type { UpdateKeyDetailsResponse } from "@ideal-postcodes/sdk";

Errors​

HTTP errors throw an ApiError with the HTTP status and the API error code and message. Network failures and aborts reject with the runtime's native error. Pass throwOnError: false to get { data, error } instead. See error handling.

Example​

update-key-details.tsts
import { createIdpcClient, updateKeyDetails } from "@ideal-postcodes/sdk";

export const example = async () => {
  const client = createIdpcClient({
    apiKey: "ak_test",
    userToken: "uk_example",
  });
  const { data } = await updateKeyDetails({
    client,
    path: { key: "ak_test" },
    body: { daily_limit: { limit: 1000 } },
  });
  return data;
};