Modify Organization API key

Description

Modify an already existing API key. The isAdmin field can only be set by admins.

Request

POST /v1/organizations/:organizationId/apikeys/:keyId
{
  key?: string,
  name?: string,
  enforceIpWhitelist?: boolean,
  isAdmin?: boolean,
  actions?: string[],
  ipWhiteList?: {
    ip: string,
    name?: string
  }[]
}

Response

Successful response contains the following JSON formated body:

{
  organizationId: string,
  apikeyId: string,
  name: string,
  enforceIpWhitelist: boolean,
  isAdmin: boolean,
  actions: string[],
  ipWhiteList: {
    ip: string,
    name?: string
  }[],
  created: string
}

Response Status codes:

  • 200 on success

Request headers

This request must have the following headers:

  • Authorization: bearer <ApiKey>
  • Content-Type: application/json

Example

Request

curl -XPOST "https://api.cloud.nabto.com/v1/organizations/:organizationId/apikeys/:keyId" \
  -H "Authorization: Bearer <ApiKey>" \
  -H "Content-Type: application/json" \
  -d '{ key: "<key>", name: "friendly name", enforceIpWhitelist: true, isAdmin: true, actions:[ "nabto5:write",...], ipWhiteList: [{ ip: "10.0.0.42", name: "friendly name" }, ...]}'

Response

{
   organizationId: "or-lmnopqrs",
  apikeyId: "ak-1234pqrs",
  name: "friendly name",
  enforceIpWhitelist: true,
  isAdmin: true,
  actions:[ "nabto5:write",
  ...],
  ipWhiteList: [{
     ip: "10.0.0.42",
    name: "friendly name" 
  },
  ,
  ...] created: "2022-10-18T10:17:24.299Z"
}