Get your avatar

GET

/spaces/preferences/skin

const url = 'https://spaces.work.optidata.cloud/api/spaces/preferences/skin';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://spaces.work.optidata.cloud/api/spaces/preferences/skin \
  --header 'Authorization: Bearer <token>'

The avatar (skin) you appear with in every space of the company, and the avatars you can choose from. When you never picked one (has_skin_preference: false), skin is the one assigned to you by default.

Authorizations

bearerAuth

Responses

200

Your avatar and the ones you can choose from.

application/json

object

skin

required

Your avatar (premade:NN or custom:…).

string

has_skin_preference

required

false when you never picked one and skin is your default avatar.

boolean

available_skins

required

Array<string>

is_custom_skin_accepted

required

Whether characters made in the character maker (custom:…) are accepted.

boolean

Examples

preference

{
  "skin": "premade:07",
  "has_skin_preference": true,
  "available_skins": [
    "premade:01",
    "premade:02",
    "premade:03",
    "premade:04",
    "premade:05",
    "premade:06",
    "premade:07",
    "premade:08"
  ],
  "is_custom_skin_accepted": true
}

401

No authentication key was sent.

application/json

Authentication failures use an error key rather than message.

object

error

required

string

Examples

missing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

419

The authentication key is expired or not recognised. Get a fresh one and retry.

application/json

Authentication failures use an error key rather than message.

object

error

required

string

Examples

expired

{
  "error": "JWT passport expired: Passport expired"
}