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

get

HTTPcURLJavaScriptPython

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

[
  {
    "id": "text",
    "emoteUuid": "123e4567-e89b-12d3-a456-426614174000",
    "userId": 1,
    "createdAt": "2025-04-25T08:48:38.780Z",
    "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-25T08:48:38.780Z"
        }
      ],
      "createdAt": "2025-04-25T08:48:38.780Z"
    }
  }
]

Update an emote

put

Update the emote metadata

Authorizations

Path parameters

userIdanyOptional

Virtual world's user ID.

emoteUuidanyOptional

Kinetix Emote unique identifier

Body

namestringOptionalExample: theNewName

Responses

put

HTTPcURLJavaScriptPython

PUT /v1/users/{userId}/emotes/{emoteUuid} HTTP/1.1
Host: sdk-api.dev.kinetix.tech
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "name": "theNewName"
}

[
  {
    "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:48:38.780Z"
      }
    ],
    "createdAt": "2025-04-25T08:48:38.780Z"
  }
]

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

delete

HTTPcURLJavaScriptPython

DELETE /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:48:38.780Z"
      }
    ],
    "createdAt": "2025-04-25T08:48:38.780Z"
  }
]

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