Validate a MSA token

This endpoint allows an authenticated user to validate a MSA token.

NOTE: These docs are unfinished.

These docs were submitted by Dusks via DM to me on Discord, and I've formatted them and posted here + added a bit more data to them. Thank you, Dusks! Some endpoints have also been documented by fweak.

Request

  • Method: POST
  • Endpoint: /migration/validate
  • Full URL: https://api.minecraftservices.com/migration/validate
  • Headers:
    • Authorization: Bearer [JWT/auth token here]

The POST body should be similar to this:

{ "identityToken": "XBL3.0 x=XUID_HERE;JWT_HERE" }

Response

400: Bad Request

You are given this response if you neglect to insert a POST body or if the identityToken is blank.

// no POST body { "path": "/migration/validate", "errorType": "BAD_REQUEST", "error": "BAD_REQUEST", "errorMessage": "Bad Request", "developerMessage": "Bad Request" } // identityToken is blank { "path": "/migration/validate", "errorType": "CONSTRAINT_VIOLATION", "error": "CONSTRAINT_VIOLATION", "errorMessage": "validate.request.identityToken: must not be blank", "developerMessage": "validate.request.identityToken: must not be blank" }

401: Unauthorized

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

{ "path": "/migration/validate", "errorType": "UNAUTHORIZED", "error": "UNAUTHORIZED" }

405: Method Not Allowed

You used the wrong HTTP method for this request. Sample response:

{ "path": "/migration/validate", "errorType": "METHOD_NOT_ALLOWED", "error": "METHOD_NOT_ALLOWED", "errorMessage": "Method Not Allowed", "developerMessage": "Method Not Allowed" }

409: Conflict

This is the current response for this endpoint when given a valid identityToken. Sample response:

{ "path": "/migration/validate", "errorType": "NOT_ELIGIBLE", "error": "NOT_ELIGIBLE" }