Change your enabled cape

This endpoint allows an authenticated user to change their enabled cape to another one that they own.

Request

• Method: PUT
• Endpoint: /minecraft/profile/capes/active
• Full URL: https://api.minecraftservices.com/minecraft/profile/capes/active
• Headers:
  • Authorization: Bearer [JWT/auth token here]
  • Content-Type: application/json

The PUT body for this request should be similar to this:

{
   "capeId" : "2d4de64a-da1b-4196-8e37-20740f6941ad" // replace with the cape ID of the cape you want to change to. use the new "View your profile information" endpoint.
}

Response

200: OK

Changed cape successfully. Profile information is sent as a response. Sample response:

{
  "id" : "cdb5aee80f904fdda63ba16d38cd6b3b", // UUID of account
  "name" : "lukethehacker23", // username
  "skins" : [ {
    "id" : "7800ee13-f75d-40e5-a5b2-9197c3e0125a", // skin ID - always will be the same for this skin
    "state" : "ACTIVE", // if skin is enabled or not
    "url" : "http://textures.minecraft.net/texture/3b60a1f6d562f52aaebbf1434f1de147933a3affe0e764fa49ea057536623cd3", // skin texture URL
    "variant" : "SLIM", // model of skin (steve/alex aka CLASSIC/SLIM)
    "alias" : "ALEX" // assuming this is only for STEVE/ALEX skin. doesn't show up for some reason for some accounts.
  } ],
  "capes" : [ {
    "id" : "2d4de64a-da1b-4196-8e37-20740f6941ad", // cape ID - always will be the same for this cape
    "state" : "ACTIVE", // if cape is enabled or not (inactive = disabled)
    "url" : "http://textures.minecraft.net/texture/a2e8d97ec79100e90a75d369d1b3ba81273c4f82bc1b737e934eed4a854be1b6", // cape texture URL
    "alias" : "Minecon2012" // cape name
  } ]
}

400: Bad Request

You are trying to change a cape of an account that does not own this cape.

{
  "path" : "/minecraft/profile/capes/active",
  "errorType" : "BAD_REQUEST",
  "error" : "BAD_REQUEST"
}

401: Unauthorized

You provided an invalid Bearer token or neglected to fill in the Authorization header entirely.

{
  "path" : "/minecraft/profile/capes/active",
  "errorType" : "UnauthorizedOperationException",
  "error" : "UnauthorizedOperationException",
  "errorMessage" : "Unauthorized",
  "developerMessage" : "Unauthorized"
}