Update Access Key

put

Updates an access key specified by an access key id.

Authorizations

Bearer

AuthorizationstringRequired

Enter the Bearer Authorization string as following: Bearer Generated-JWT-Token

Path parameters

accessKeyIdstring · uuidRequired

Body

application/json

Contains details for updating an existing access key.

pinstring | nullableOptional

(optional) A PIN that should be used with the access key. Only applicable for rfid access key types.

accessesstring · uuid[] | nullableOptional

(optional) A list of accesses, specified by id, that should be authorized to the access key. If omitted, the current access assignments will not be changed.

updateValidityPeriodbooleanOptional

Indicates if the validity period should be updated. If set to false, validFrom and validTo will be ignored.

validFromstring | nullableOptional

(optional) ISO 8601 formatted date from where the access key becomes active. If omitted, the access key will be active immediately after creation. Only applicable if updateValidityPeriod is set to true.

validTostring | nullableOptional

(optional) ISO 8601 formatted date from where the access key expires. If omitted, the access key will never expire. Only applicable if updateValidityPeriod is set to true.

Responses

200

Success

application/json

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

put

/integrator/v1/accesskeys/{accessKeyId}

HTTPcURLJavaScriptPython

PUT /integrator/v1/accesskeys/{accessKeyId} HTTP/1.1
Host: api.kiiaccess.se
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 176

{
  "pin": "text",
  "accesses": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "updateValidityPeriod": true,
  "validFrom": "text",
  "validTo": "text",
  "metaData": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "text",
  "userFirstName": "text",
  "userLastName": "text",
  "keyType": "text",
  "keyFormat": "text",
  "keyIdentification": "text",
  "keyName": "text",
  "accesses": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "validFrom": "2025-12-10T18:15:30.046Z",
  "validTo": "2025-12-10T18:15:30.046Z",
  "metaData": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}