Tu cuenta
Perfil, preferencias, avisos, dispositivos y tokens.
Privacidad y analítica
Utilizamos cookies técnicas necesarias y, solo si das tu consentimiento, analítica y pixels de marketing para mejorar la web y medir campañas.
Privacidad y analítica
Utilizamos cookies técnicas necesarias y, solo si das tu consentimiento, analítica y pixels de marketing para mejorar la web y medir campañas.
Perfil, preferencias, avisos, dispositivos y tokens.
Tu zona horaria en todos tus dispositivos; vacía vuelve a la del dispositivo.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.time_zone.set |
| Herramienta MCP | profile_time_zone_set |
| Alcance | profile.write |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
timeZone: string | null // IANA zone (`Europe/Madrid`), or null to fall back.
}Salida
{
timeZone: string | null
}Cambia el nombre visible, la imagen, el teléfono o el idioma de tu cuenta. El teléfono se guarda en formato internacional con tu país.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.update |
| Herramienta MCP | profile_update |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
fullName?: string // ≤ 200
avatarUrl?: string // ≤ 2048
phone?: string | null
locale?: "es" | "en" | "fr" | "de" | "it" | "ru" | "ko" | "ja" | "zh" | "pt" | "hi"
}Salida
{
ok: true
}Guarda como imagen de perfil un archivo ya subido a tu carpeta de avatares.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.avatar.set |
| Herramienta MCP | profile_avatar_set |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
avatarUrl: string // uri · ≤ 2048
}Salida
{
ok: true
}Quita la imagen de perfil y borra sus archivos guardados.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.avatar.remove |
| Herramienta MCP | profile_avatar_remove |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | Sí |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{}Salida
{
ok: true
}Guarda nombre legal, nombre visible y @usuario en un paso. La base de datos aplica los límites (cambios de nombre, @usuario libre y no reservado).
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.identity.update |
| Herramienta MCP | profile_identity_update |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
firstName: string // ≤ 80
lastName: string // ≤ 80
displayName: string // ≤ 60
username: string // ≤ 31
}Salida
{
identity: Record<string, unknown>
}Marca que la persona está activa ahora (y, si es del equipo, su presencia en vivo). Crea su ficha de persona si aún no existe.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.presence.touch |
| Herramienta MCP | profile_presence_touch |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | Pantallas, Apps |
| Estado | Disponible |
Entrada
{
path?: string // ≤ 400
}Salida
{
touched: boolean
}Envía un aviso de prueba a tus dispositivos (o a uno). Hay un tiempo mínimo entre pruebas.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.push_devices.test |
| Herramienta MCP | profile_push_devices_test |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
deviceId?: string | null
}Salida
{
ok: true
outcomes: Record<string, unknown>[]
}
| {
ok: false
error: "too_soon" | "no_device" | "transport_not_configured" | "failed"
}Ese navegador o teléfono deja de recibir avisos hasta que se suscriba de nuevo.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.push_devices.remove |
| Herramienta MCP | profile_push_devices_remove |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | Sí |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
deviceId: string // uuid
}Salida
{
removed: boolean
}Marca avisos de tu bandeja como leídos (y vistos) o como no leídos.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notifications.set_read |
| Herramienta MCP | profile_notifications_set_read |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
ids: string[] // ≤ 200 items · Notification ids of the person (up to 200); ids of other people are ignored.
read: boolean
}Salida
{
ok: true
}«Hecho»: saca avisos de la bandeja (siguen en Archivo) o los devuelve. Archivar también los marca leídos.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notifications.set_archived |
| Herramienta MCP | profile_notifications_set_archived |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
ids: string[] // ≤ 200 items · Notification ids of the person (up to 200); ids of other people are ignored.
archived: boolean
}Salida
{
ok: true
}Guarda avisos para luego o los quita de Guardados.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notifications.set_saved |
| Herramienta MCP | profile_notifications_set_saved |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
ids: string[] // ≤ 200 items · Notification ids of the person (up to 200); ids of other people are ignored.
saved: boolean
}Salida
{
ok: true
}Oculta avisos hasta un momento; vuelven sin leer arriba. Sin fecha, los despierta ya.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notifications.snooze |
| Herramienta MCP | profile_notifications_snooze |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
ids: string[] // ≤ 200 items · Notification ids of the person (up to 200); ids of other people are ignored.
until: string | null
}Salida
{
ok: true
}Todo lo no leído de la bandeja pasa a leído: en una marca (más los avisos de la cuenta) o de una categoría.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notifications.read_all |
| Herramienta MCP | profile_notifications_read_all |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
brandId?: string | null
category?: string | null
}Salida
{
ok: true
}Al abrir la campana: el contador de nuevos vuelve a cero; la lista sigue con lo no leído.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notifications.mark_seen |
| Herramienta MCP | profile_notifications_mark_seen |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{}Salida
{
ok: true
}«Silenciar este hilo»: sin push ni correo para sus avisos, que siguen llegando a la bandeja. O vuelve a avisar.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notifications.mute_thread |
| Herramienta MCP | profile_notifications_mute_thread |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
threadKey: string // ≤ 200
muted: boolean
}Salida
{
ok: true
}Activa o desactiva un tipo o categoría de aviso en un canal, en todas partes o en un workspace; null vuelve al valor por defecto. «Novedades de Nömad» es tu consentimiento de marketing y queda registrado.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notification_preferences.set |
| Herramienta MCP | profile_notification_preferences_set |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
workspaceId?: string | null
targetType: "category" | "type"
targetKey: string // ≤ 120
channel: "all" | "in_app" | "push" | "email"
enabled: boolean | null
}Salida
{
ok: true
}Vuelve a los valores por defecto del catálogo, en todas partes o en un workspace.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notification_preferences.reset |
| Herramienta MCP | profile_notification_preferences_reset |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | Sí |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
workspaceId?: string | null
}Salida
{
ok: true
}Zona horaria, horas de silencio, resumen diario o semanal y los interruptores de push, correo y sonido. Solo cambia lo que mandas.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notification_delivery.update |
| Herramienta MCP | profile_notification_delivery_update |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
timeZone?: string // ≤ 80
quietHoursEnabled?: boolean
quietStart?: string // ≤ 5
quietEnd?: string // ≤ 5
quietDays?: integer[] // ≤ 7 items
digestFrequency?: "off" | "daily" | "weekly"
digestHour?: integer // -9007199254740991–9007199254740991
digestWeekday?: integer // -9007199254740991–9007199254740991
pushEnabled?: boolean
emailEnabled?: boolean
soundEnabled?: boolean
}Salida
{
ok: true
}Pushes y correos esperan hasta un momento (como mucho una semana). Sin fecha, se reanuda y sale lo retenido.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.notification_pause.set |
| Herramienta MCP | profile_notification_pause_set |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
until: string | null
}Salida
{
pausedUntil: string | null
}Acepta o rechaza, una vez, lo que un agente conectado pidió hacer en tu nombre. Al aceptar se ejecuta de nuevo con todas las comprobaciones.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.agent_approvals.decide |
| Herramienta MCP | profile_agent_approvals_decide |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | Pantallas, Apps |
| Estado | Disponible |
Entrada
{
id: string // uuid
accept: boolean
}Salida
{
status: "approved" | "rejected"
}Crea un token de API personal con nombre, caducidad, permisos y, si quieres, solo algunas marcas. Pide un inicio de sesión reciente; el token se ve una sola vez.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.tokens.create |
| Herramienta MCP | profile_tokens_create |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | Pantallas |
| Estado | Disponible |
Entrada
{
name: string // ≤ 80
expiresAt?: string | null // ISO date; empty takes the default lifetime.
scopes: string[] // ≤ 200 items
brandIds?: string[] // ≤ 200 items · default []
}Salida
{
token: string
credential: {
id: string // uuid
kind: string
name: string
prefix: string
scopes: string[]
brandIds: string[] | null
createdAt: string
expiresAt: string
lastUsedAt: string | null
revokedAt: string | null
revokedSource: string | null
legacy: boolean
serviceAccountId: string | null
}
}Emite un token nuevo y el anterior sigue valiendo las horas de gracia elegidas. Pide un inicio de sesión reciente.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.tokens.rotate |
| Herramienta MCP | profile_tokens_rotate |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | Pantallas |
| Estado | Disponible |
Entrada
{
id: string // uuid
graceHours: integer // 0–720
}Salida
{
token: string
credential: {
id: string // uuid
kind: string
name: string
prefix: string
scopes: string[]
brandIds: string[] | null
createdAt: string
expiresAt: string
lastUsedAt: string | null
revokedAt: string | null
revokedSource: string | null
legacy: boolean
serviceAccountId: string | null
}
}El token deja de funcionar al momento.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.tokens.revoke |
| Herramienta MCP | profile_tokens_revoke |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | Sí |
| Puertas | Pantallas, Apps |
| Estado | Disponible |
Entrada
{
id: string // uuid
}Salida
{
ok: true
}La respuesta de la persona a «¿Quieres recibir novedades?»: «Sí» la suscribe (consentimiento), «No, gracias» la da de baja. Se guarda la pregunta exacta, el botón y la evidencia de la petición.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/profile.marketing_consent.answer |
| Herramienta MCP | profile_marketing_consent_answer |
| Alcance | profile.write |
| Rol mínimo | self |
| Confirmación humana | No |
| Puertas | Pantallas, Apps |
| Estado | Disponible |
Entrada
{
accepted: boolean
}Salida
{
ok: true
}Actualizado el 1 de enero de 1970