Update instance account
Updates an existing Minecraft account in the instance. The account is matched by profile_id and replaced.
Updates an existing Minecraft account in the instance. The account is matched by profile_id and replaced.
Preferred API authentication. Use a JWT with the api audience.
In: header
Path Parameters
The unique identifier (UUID) of the instance.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The authentication type used for this account. Determines which account_data field is populated.
The unique profile identifier (UUID) for this account. For online accounts: The official Minecraft profile UUID from Microsoft. For offline accounts: A deterministic UUID derived from the username. Format: Standard UUID string (e.g., "550e8400-e29b-41d4-a716-446655440000").
uuidThe last known username/gamertag for this account. Updated during authentication and refresh operations. For Java: The Minecraft username (up to 16 characters). For Bedrock: The Xbox gamertag.
JSON structure containing the complete authentication chain from minecraftauth library. Includes Microsoft OAuth tokens, Xbox Live tokens, and Minecraft access tokens. This data can be refreshed to obtain new tokens without re-authentication.
JSON structure containing the complete Bedrock authentication chain. Includes Xbox Live tokens and Bedrock-specific session data. Compatible with the ViaBedrock protocol implementation.
The raw Minecraft access token (JWT).
Token expiry time in milliseconds since epoch.
int64Response Body
application/json
application/json
application/json
application/json
curl -X POST "http://127.0.0.1:38765/v1/instances/p0/accounts:update" \ -H "Content-Type: application/json" \ -d '{ "account.type": {}, "account.profile_id": "8dec25d7-d125-46da-8314-b43b3c5640ed", "account.last_known_name": "string", "account.online_chain_java_data.auth_chain": {}, "account.bedrock_data.auth_chain": {}, "account.online_simple_java_data.access_token": "string", "account.online_simple_java_data.expire_time_ms": 0, "account.config.namespace": "string", "account.config.entries.key": "string", "account.config.entries.value": {}, "account.persistent_metadata.namespace": "string", "account.persistent_metadata.entries.key": "string", "account.persistent_metadata.entries.value": {} }'{}{ "code": 0, "grpc-code": "string", "message": "string", "stack-trace": "string", "details": [ {} ]}{ "code": 0, "grpc-code": "string", "message": "string", "stack-trace": "string", "details": [ {} ]}{ "code": 0, "grpc-code": "string", "message": "string", "stack-trace": "string", "details": [ {} ]}How is this page?