Sharing emote

The Kinetix API provide a route to share an existing emote to other players. In order to achieve that you need to call the route :

Associate emote to user

post

Associate an emote to a user.

Authorizations

Path parameters

userIdanyOptional

Virtual world's user ID.

emoteUuidanyOptional

Kinetix Emote unique identifier

Responses

post

HTTPcURLJavaScriptPython

POST /v1/users/{userId}/emotes/{emoteUuid} HTTP/1.1
Host: sdk-api.dev.kinetix.tech
x-api-key: YOUR_API_KEY
Accept: */*

[
  {
    "id": 1,
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "type": "text",
    "files": [
      {
        "id": 1,
        "name": "123e4567-e89b-12d3-a456-426614174000",
        "extension": "text",
        "assetId": 1,
        "url": "text",
        "createdAt": "2025-04-25T08:41:14.941Z"
      }
    ],
    "createdAt": "2025-04-25T08:41:14.941Z"
  }
]

It could be used for example to share content for people in an organization or a business. The resource provides 2 functions that interact with this route.

function ShareEmoteWithUsers(userIds, emoteUuid)
    for userId in userIds do
        ShareEmoteWithUser(userId, emoteUuid)
    end
end

function ShareEmoteWithUser(userId, emoteUuid, cb)
    local addEmoteRoute = string.format('/v1/users/%s/emotes/%s', tostring(userId), emoteUuid)

    PerformHttpRequest(url .. addEmoteRoute, function(statusCode, response)
        cb(response)
    end, "POST", "", headers)
end

The emote will then be displayed in the user bag and can be manipulated normally.