Clients and tokens

Create or replace a named connected-client credential

Create or replace a named connected-client credential.

post/api/connected-clients

Request

  • Base URL: https://keep.md
  • URL: https://keep.md/api/connected-clients
  • Auth: one of:
    • HTTP bearer
    • API key in cookie keep.session_token

Headers

Keep-API-Versionstring
Example:2026-08-24

Optional date-based Keep API version. Omit it to use the current version.

Request body

namestring required

Response

New connected-client credential. The token value is returned once.

idstring required
type'personal' required
tokenType'personal'
tokenstring

Returned only when a credential is created or rolled.

namestring nullable
permissionsstring[]
scopeVersioninteger
tokenPrefixstring
tokenSuffixstring
createdAtinteger required
updatedAtinteger
lastUsedAtinteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.