Skip to content
EntitlerDocs

POST/v1/customers/{external_id}/devices:liftLockout

Lift a device lockout

Lifts the customer's signed-in or in-use device lockout and clears its breaches. Needs customers:write.

curl -X POST 'https://api.entitler.co/v1/customers/ada/devices:liftLockout' \
  -H "Authorization: Bearer $ENTITLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"DEVICE_LIMIT_KIND_UNSPECIFIED","target":{"environmentId":"environmentId","projectId":"projectId","teamId":"teamId"}}'

Credentials

Send any one of these:

  • Bearer token

Path parameters

NameTypeDescription
external_idrequiredstringThe customer's external ID, or me for the customer a customer token or identity token names.

Request body

object

  • kindcommon.DeviceLimitKind

    One of DEVICE_LIMIT_KIND_UNSPECIFIED, DEVICE_LIMIT_KIND_SIGNED_IN, DEVICE_LIMIT_KIND_IN_USE.

  • targetProductTarget
    • environmentIdstring
    • projectIdstring
    • teamIdstring

Responses

200The LiftDeviceLockoutResponse message.

LiftDeviceLockoutResponse

ErrorA refusal, with the HTTP status of its gRPC code.

Error

  • errorobjectrequired
    • codestringrequired
    • parametersobjectrequired

      Each value: string

    • reasonstringor nullrequired