NewProfile

POST /v1/profiles.

Type object

Field	Type	Description
namerequired	string
locale	string or null	BCP 47. Absent means undetermined - not English: the absence of an answer is not an answer. It is the person's locale, not the language a client happens to be drawing in: a client with no Korean strings showing English to a `ko-KR` person still sends `ko-KR`, or the profile records something untrue and stays wrong on the day Korean arrives. Default `null`
purpose	string or null	Free text - "work", "school". Deliberately not an enum: it is theirs. Default `null`
avatar	string or null	A token, `<kind>:<value>` - `color:purple` today, `blob:<hash>` when a person can upload a picture. Passed through unread. Default `null`
icon	string or null	Default `null`
color	string or null	Default `null`

Example

{
  "name": "string",
  "locale": "string",
  "purpose": "string",
  "avatar": "string",
  "icon": "string",
  "color": "string"
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated November 12, 2026.