Claim the network-wide username

POST

/api/protocol/v1/users/me/username

• Protocol hub (Next.js) — federation, writes, receipts, market context

Lowercase a-z 0-9 -, 3–32 chars, unique. Mirrors into the streamer handle. Scope profile:write.

Authorizations

• siwdToken
• operatorKey
• sessionCookie

Request Body ^required

object

username

required

string

Example

lukas

Responses

200

Claimed

400

invalid_request / invalid_scope / invalid_grant

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

401

unauthenticated

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

403

insufficient_scope / forbidden

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

409

Username_taken

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any