naftiko: 1.0.0-alpha2
info:
  label: Ready Player Me Assets API — Catalog
  description: Ready Player Me Assets API catalog operations. Self-contained Naftiko capability covering
    asset discovery, filtering, and retrieval of GLB models and thumbnails.
  tags:
  - Ready Player Me
  - Assets
  - Catalog
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    RPM_APP_ID: RPM_APP_ID
capability:
  consumes:
  - type: http
    namespace: assets-catalog
    baseUri: https://api.readyplayer.me
    description: Ready Player Me Assets API catalog business capability.
    headers:
      X-APP-ID: ${env.RPM_APP_ID}
    resources:
    - name: assets
      path: /v1/assets
      operations:
      - name: listassets
        method: GET
        description: List assets filtered by type, gender, application, and user.
        inputParameters:
        - name: type
          in: query
          type: string
        - name: limit
          in: query
          type: integer
        - name: page
          in: query
          type: integer
        - name: gender
          in: query
          type: string
        - name: filter
          in: query
          type: string
        - name: filterApplicationId
          in: query
          type: string
        - name: filterUserId
          in: query
          type: string
    - name: asset-glb
      path: /v1/assets/{assetId}.glb
      operations:
      - name: getassetglb
        method: GET
        description: Get the GLB model of an asset.
        inputParameters:
        - name: assetId
          in: path
          type: string
          required: true
    - name: asset-thumbnail
      path: /v1/assets/{assetId}/thumbnail.png
      operations:
      - name: getassetthumbnail
        method: GET
        description: Get the thumbnail PNG of an asset.
        inputParameters:
        - name: assetId
          in: path
          type: string
          required: true
    - name: phoenix-assets
      path: /v1/phoenix-assets
      operations:
      - name: listphoenixassets
        method: GET
        description: List phoenix-tier and base-model assets for an application.
        inputParameters:
        - name: applicationId
          in: query
          type: string
          required: true
        - name: type
          in: query
          type: string