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

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://sdk-api.dev.kinetix.tech/v1/users/{userId}/emotes/{emoteUuid}' \
  --header 'x-api-key: YOUR_API_KEY'

200

401

403

200

[
  {
    "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-03T02:07:22.427Z"
      }
    ],
    "createdAt": "2025-04-03T02:07:22.427Z"
  }
]

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.