Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Ready Player Me Avatars API

Create, retrieve, update, and delete Ready Player Me cross-platform avatars. Includes template-based creation, asset equipping, draft management, color palette discovery, and binary glTF (.glb) plus 2D PNG renders used in Unity, Unreal, web, iOS, and Android. Supports A/T-pose, mesh LODs, texture atlases, ARKit / Oculus morph targets, Draco and Meshopt compression.

Ready Player Me Avatars API is one of 3 APIs that Ready Player Me publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Avatars, 3D, GLB, and Gaming. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 14 operations across 11 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.readyplayer.me.

14 operations 11 paths 5 schemas 2 DELETE7 GET1 PATCH3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.readyplayer.me/
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Ready Player Me Avatars API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-APP-ID (AppId). By default, every request must be authenticated.

Paths & Operations 14

Across 11 paths, the API surfaces 14 operations — 2 DELETE, 7 GET, 1 PATCH, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Avatars 14

Avatar creation, asset equipping, render, and lifecycle operations.

POST
/v2/avatars
Create A Draft Avatar
createAvatar body → 201
GET
/v2/avatars/templates
List Avatar Templates
listAvatarTemplates → 200
POST
/v2/avatars/templates/{templateId}
Create Avatar From Template
createAvatarFromTemplate 1 param body → 201
GET
/v2/avatars/{avatarId}
Get Avatar Metadata
getAvatarMetadata 1 param → 200
PATCH
/v2/avatars/{avatarId}
Update Avatar Equipped Assets
updateAvatar 2 params body → 200
PUT
/v2/avatars/{avatarId}
Save Draft Avatar
saveAvatar 1 param → 200
DELETE
/v2/avatars/{avatarId}
Delete Avatar
deleteAvatar 1 param → 204
DELETE
/v2/avatars/{avatarId}/draft
Delete Avatar Draft
deleteAvatarDraft 1 param → 204
POST
/v2/avatars/{avatarId}/precompile
Precompile Avatar Render
precompileAvatar 1 param → 200
GET
/v2/avatars/{avatarId}/colors
Get Avatar Color Palette
getAvatarColors 2 params → 200
GET
/v1/avatars
List Avatars For A User
listUserAvatars 2 params → 200
GET
/v1/avatars/{avatarId}.glb
Get Avatar GLB Model
getAvatarGlb 10 params → 200
GET
/v1/avatars/{avatarId}.png
Get 2D Avatar Render
getAvatarPng 5 params → 200
GET
/v2/avatars/{avatarId}.glb
Get V2 Avatar GLB Model
getAvatarGlbV2 2 params → 200

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are Avatar (6 properties), AvatarTemplate (3 properties), AvatarCreateRequest (1 property), AvatarUpdateRequest (1 property). Each schema is shown below with its type and property counts.

ColorPalette
object
1 property
AvatarUpdateRequest
object
1 property
Avatar
object
6 properties
AvatarCreateRequest
object
1 property
AvatarTemplate
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ready-player-me-avatars-api-openapi.yml Raw ↑

Other APIs Ready Player Me publishes across the network.

Ready Player Me Assets API
Ready Player Me Auth API