User bag

Once created, an emote can be found in the user's "bag". The following routes are used to manage the bag:

List user emotes

get

List all the user emotes. The user must be associated to requesting virtual world

Authorizations

Path parameters

userIdanyoptional

Virtual world's user ID.

Query parameters

matureanyoptional

Optional filter for mature content. Non flagged emotes are returned as false

limitanyoptional

Optional pagination parameter

offsetanyoptional

Optional pagination parameter

sinceanyoptional

Filter by creation date

Example: 2023-01-01T12:12:30Z

untilanyoptional

Filter by creation date

Example: 2024-01-01T12:12:30Z

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

403

200

[
  {
    "id": "text",
    "emoteUuid": "123e4567-e89b-12d3-a456-426614174000",
    "userId": 1,
    "createdAt": "2025-04-03T01:44:57.807Z",
    "data": {
      "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-03T01:44:57.807Z"
        }
      ],
      "createdAt": "2025-04-03T01:44:57.807Z"
    }
  }
]

Update an emote

put

Update the emote metadata

Authorizations

Path parameters

userIdanyoptional

Virtual world's user ID.

emoteUuidanyoptional

Kinetix Emote unique identifier

Body

namestringoptional

Example: theNewName

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://sdk-api.dev.kinetix.tech/v1/users/{userId}/emotes/{emoteUuid}' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "theNewName"
  }'

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-03T01:44:57.807Z"
      }
    ],
    "createdAt": "2025-04-03T01:44:57.807Z"
  }
]

Remove emote from a user

delete

Remove an emote from 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 DELETE \
  --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-03T01:44:57.807Z"
      }
    ],
    "createdAt": "2025-04-03T01:44:57.807Z"
  }
]

In the developer portal, you also have the ability to moderate users content, and remove emotes that does not comply with your policies.