Set channel data

Updates or creates channel data for a specific user and channel ID. If no user exists in the current environment for the given user_id, Knock will create the user entry as part of this request.

put/v1/users/{user_id}/channel_data/{channel_id}

Path parameters

user_idstring required

The unique identifier of the user.

channel_idstring uuid required

The unique identifier for the channel.

Request body

Example request

{
  "data": {
    "tokens": [
      "push_token_1"
    ]
  }
}

Response

__typenamestring required

The typename of the schema.

channel_idstring uuid required

The unique identifier for the channel.

The type of provider.

Example response

{
  "__typename": "ChannelData",
  "channel_id": "123e4567-e89b-12d3-a456-426614174000",
  "data": {
    "devices": [
      {
        "locale": null,
        "timezone": null,
        "token": "device_1"
      }
    ],
    "tokens": [
      "push_token_1"
    ]
  }
}

Changes

Changed in 3 of the 30 revisions of this API.314

Nov 7, 20251584eaacf7791See the full diff
- ○
  added to the request property oneOf list
  request-property-one-of-added
Oct 27, 202540ca41599f5722See the full diff
- ▲
  removed from the request property oneOf list
  request-property-one-of-removed
- ▲
  added to the response property oneOf list for the response status
  response-property-one-of-added
- ○
  added to the request property oneOf list
  request-property-one-of-added
- ○
  removed from the response property oneOf list for the response status
  response-property-one-of-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 8, 20252d3aac5f3ddf111See the full diff
- ▲
  added to the response property oneOf list for the response status
  response-property-one-of-added
- ●
  added the new push_aws_sns enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added to the request property oneOf list
  request-property-one-of-added

Full history