TAtalkdesk
Attributes API

Associate Users to an Attribute

Associates one or more users with a specific attribute, optionally setting a proficiency level for each user. Use this endpoint to assign skills or capabilities to agents programmatically, for example as part of a workforce management integration. For team-scoped users, both the attribute and the users must be within their team scope.

post/attributes/{attribute_id}/users

Request

  • Base URL
    https://api.talkdeskapp.com
  • URL
    https://api.talkdeskapp.com/attributes/{attribute_id}/users
  • Auth
    OAuth 2
    Authorization code: https://{account_name}.talkdeskid.com/oauth/authorize
    Token URL: https://{account_name}.talkdeskid.com/oauth/token scopes: attributes:write

Path parameters

attribute_idstring required

The id of the attribute

Request body

Response

The users associated to the attribute.

Example response

{
  "attributes_users": [
    {
      "id": "eba9a399-4960-4499-952f-5867275b597a",
      "proficiency": 60,
      "_links": {
        "attribute": {
          "href": "http://api-docs.talkdesk.org/attributes/123e4567-e89b-12d3-a456-426655440000"
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.