Assigning a badge adds a badge to a particular user's profile in the help center.

Badges are available on the Gather Professional plan.

JSON format

Badges assignments are JSON objects with the following properties:

NameTypeRead-onlyMandatoryComment
idstringyesnoAutomatically assigned when the badge assignment is created
badge_idstringnoyesThe id of the badge
user_idstringnoyesThe id of the user
created_attimestampyesnoWhen the badge assignment was created

Example

{  "id": "01E86XPXH5BK09KRWTDVEKVVY8",  "badge_id": "01E86XPPRDCNHYTSVWSRMD76R0",  "user_id": "57919551",  "created_at": "2020-05-13T11:46:26.000Z"}

List Badge Assignments

  • GET /api/v2/gather/badge_assignments

You can filter the results with any combination of the following query parameters:

  • user_id
  • badge_id
  • badge_category_id
  • brand_id

Examples:

  • GET /api/v2/gather/badge_assignments?user_id={user_id}
  • GET /api/v2/gather/badge_assignments?user_id={user_id}&brand_id={brand_id}
  • GET /api/v2/gather/badge_assignments?badge_id={badge_id}
  • GET /api/v2/gather/badge_assignments?badge_category_id={badge_category_id}

Allowed for

  • Help Center managers

Parameters

NameTypeInRequiredDescription
user_idintegerQueryfalseReturns assignments for the specified user
badge_idintegerQueryfalseReturns assignments for the specified badge
badge_category_idintegerQueryfalseReturns assignments for badges under the specified category
brand_idintegerQueryfalseReturns assignments for the specified brand

Using curl

curl 'https://{subdomain}.zendesk.com/api/v2/gather/badge_assignments?badge_id=01E89DZ2NA6ZPMBMRPFRXC2BRY' \  -v -u {email_address}:{password}

Example Response

Status: 200 OK
{    "badge_assignments": [        {            "id": "01E86XPXH5BK09KRWTDVEKVVY8",            "badge_id": "01E89DZ2NA6ZPMBMRPFRXC2BRY",            "user_id": "57919551",            "created_at": "2020-05-13T11:46:26.000Z"        }    ]}

Create Badge Assignment

  • POST /api/v2/gather/badge_assignments

Allowed for

  • Help Center managers

Using curl

curl https://{subdomain}.zendesk.com/api/v2/gather/badges \  -v -u {email_address}:{password} -d '{"badge_assignment": {"badge_id": "{{badge_id}}", "user_id": "{{user_id}}"}}' \  -X POST -H "Content-Type: application/json"

Delete Badge Assignment

  • DELETE /api/v2/gather/badge_assignments/{id}

Allowed for

  • Help Center managers

Using curl

curl https://{subdomain}.zendesk.com/api/v2/gather/badge_assignments/{id} \  -v -u {email_address}:{password} -X DELETE

Example Response

Status: 204 No Content