Replace a member's tags

Sets the member’s complete tag list. Tags group members into teams for transfers: an available_humans destination with tags rings only members carrying at least one of them. Tags belong to the organization, so the change applies in every account of the organization. Owner or admin only.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

memberIdstringRequiredformat: "uuid"

Membership ID

Request

This endpoint expects an object.

tagslist of stringsRequired

The member's complete tag list; it replaces the current one. Tags are normalized: trimmed, lowercased, spaces become -. Allowed: a–z, ı ğ ü ş ö ç, digits, - and _, at most 32 characters each, at most 20 tags. An empty list removes every tag.

Response

Tags replaced

memberIdstringformat: "uuid"

Membership ID of the member in your organization

tagslist of strings

The member's tags, normalized and sorted

userIdstringformat: "uuid"

User ID of the member (the ID available_humans destinations list in userIds)

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error