Attach an auth to a consumer

Associates an auth credential with a consumer (idempotent). An application consumer takes only unowned auths and no link attributes (an empty body or ). A personal consumer takes only owned keys, and the body is required: level and granted_at must be present, and priority defaults to 1. Re-attaching a key to a personal consumer replaces that one link’s attributes.

POST /v1/gateways/{gateway_id}/consumers/{id}/auths/{auth_id}

Error

A valid request URL is required to generate request examples

400

{
  "error": "<string>",
  "message": "<string>"
}

Authorizations

Authorization · string · header · required

Path Parameters

gateway_id · string<uuid> · required

Gateway id

id · string<uuid> · required

Consumer id

auth_id · string<uuid> · required

Auth id

Body

application/json

Link attributes, for an owned key on a personal consumer

granted_at · string<date-time>

Example:

"2026-10-01T09:00:00Z"

level · enum<string>

Available options: user, group, all

Example:

"group"

priority · integer

Required range: 0 <= x <= 2147483647

Example:

1

Response

204

No Content