Account API

Account endpoints trabajan con el usuario actual, sus metadata, avatar y workspace seleccionado.

Todos los endpoints de Account, excepto POST /api/token, requieren Authorization: Bearer <token>.

POST /api/token

POST /api/token no requiere un header Authorization: Bearer <token> existente. Las credentials específicas del provider autentican la identity mediante el app seleccionado.

Cada solicitud exitosa crea un Bearer token nuevo y persistente; no reutiliza ni devuelve un token anterior. En el primer inicio de sesión exitoso de una identity, el servicio también puede crear un account y un workspace.

Argumentos: no hay argumentos path/query.

Payload:

Campo	Obligatorio	Descripción
app	Sí	Nombre de auth app/provider.
credentials	Sí	Objeto credentials específico del provider.

Respuesta: TokenResponse.

Ejemplo de solicitud (la ausencia del header Authorization es intencional):

POST /api/token
Content-Type: application/json

{
  "app": "google",
  "credentials": {
    "credential": "<provider-issued-credential>"
  }
}

Ejemplo de respuesta:

{
  "token": "<new-bearer-token>"
}

Las credenciales del provider y el token devuelto son secretos. Envíalos solo mediante HTTPS; no los registres, publiques ni incluyas en commits.

GET /api/me

Devuelve el account actual, identity, tier, memberships y workspace seleccionado.

Argumentos: ninguno.

Payload: ninguno.

Respuesta: Me.

DELETE /api/me

Elimina el account actual.

Argumentos: ninguno.

Payload: ninguno.

Respuesta: OperationResult.

PUT /api/me/meta

Actualiza metadata del usuario.

Argumentos: ninguno.

Payload:

Campo	Obligatorio	Descripción
nickname	Sí	Display name del usuario, 2-80 caracteres. El whitespace inicial y final se elimina antes de guardar y devolver el valor.

Respuesta: HTTP 200 OK.

Campo	Obligatorio	Descripción
nickname	Sí	Nickname normalizado que se guardó.

POST /api/me/avatar

Sube el avatar del account actual.

Argumentos: ninguno.

Payload:

Campo	Obligatorio	Descripción
filename	Sí	Nombre original del archivo.
contentType	Sí	MIME type de la imagen.
data	Sí	Datos de imagen en Base64.

Respuesta: AvatarUploadResult.

GET /api/me/workspace

Devuelve el workspace seleccionado del account actual.

Argumentos: ninguno.

Payload: ninguno.

Respuesta: CurrentWorkspaceResponse.

PUT /api/me/workspace

Cambia el workspace seleccionado del account actual.

Argumentos: ninguno.

Payload:

Campo	Obligatorio	Descripción
workspace	Sí	Workspace fullname o null para resetear la selección.

Respuesta: CurrentWorkspaceResponse.

GET /api/account/settings

Devuelve account settings.

Argumentos: ninguno.

Payload: ninguno.

Respuesta: AccountSettings.

PUT /api/account/settings

Guarda account settings.

Argumentos: ninguno.

Payload: objeto settings. El conjunto concreto de fields depende de la versión actual de account settings UI.

Respuesta: AccountSettings.