Trabajos
Trabajos, pasos y tareas de la marca.
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.
Trabajos, pasos y tareas de la marca.
Trabajos de la marca con su estado, progreso y tareas que esperan a la marca.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/works.list |
| Herramienta MCP | works_list |
| Alcance | works.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API |
| Estado | Disponible |
| Widget | list |
Entrada
{
status?: "active" | "finished" | "archived" | "all" // default "active"
cursor?: string // ≤ 512 · Opaque cursor from a previous `nextCursor`.
limit?: integer // 1–50 · default 20
}Salida
{
items: Array<{
id: string // uuid
name: string
status: string
dueDate: string | null
progress: {
done: integer // -9007199254740991–9007199254740991
total: integer // -9007199254740991–9007199254740991
}
waitingOnBrand: integer // -9007199254740991–9007199254740991 · Tasks waiting for the brand.
}>
nextCursor: string | null
}Un trabajo con sus pasos y quién tiene cada uno. detailed añade entregables y respuestas.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/works.get |
| Herramienta MCP | works_get |
| Alcance | works.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API |
| Estado | Próximamente |
| Widget | record |
Entrada
{
workId: string // uuid
format?: "concise" | "detailed" // default "concise" · `concise` returns names and states only; `detailed` adds ids and full fields.
}Salida
{
id: string // uuid
name: string
status: string
dueDate: string | null
progress: {
done: integer // -9007199254740991–9007199254740991
total: integer // -9007199254740991–9007199254740991
}
waitingOnBrand: integer // -9007199254740991–9007199254740991 · Tasks waiting for the brand.
steps: Array<{
id: string // uuid
title: string
status: string
kind: "questionnaire" | "files" | "review" | "information"
dueDate: string | null
owner: "brand" | "nomad"
}>
}Tareas que esperan a la marca en todos sus trabajos, las más urgentes primero.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/works.tasks.pending |
| Herramienta MCP | works_tasks_pending |
| Alcance | works.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API |
| Estado | Próximamente |
| Widget | list |
Entrada
{
cursor?: string // ≤ 512 · Opaque cursor from a previous `nextCursor`.
limit?: integer // 1–50 · default 20
}Salida
{
items: Array<{
id: string // uuid
workId: string // uuid
workName: string
title: string
status: string
kind: "questionnaire" | "files" | "review" | "information"
dueDate: string | null
}>
nextCursor: string | null
}Una tarea con su cuestionario (el de la versión contratada), borradores y entregables.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/works.tasks.get |
| Herramienta MCP | works_tasks_get |
| Alcance | works.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API |
| Estado | Próximamente |
| Widget | form |
Entrada
{
taskId: string // uuid
}Salida
{
id: string // uuid
workId: string // uuid
workName: string
title: string
status: string
kind: "questionnaire" | "files" | "review" | "information"
dueDate: string | null
questions: Array<{
id: string
label: string
type: string
required: boolean
options?: string[]
}>
draft: Array<{
questionId: string
value: string | number | boolean | string[]
}>
deliverables: Array<{
assetId: string // uuid
name: string
version: integer // -9007199254740991–9007199254740991
}>
revision: integer // -9007199254740991–9007199254740991
}Guarda respuestas del cuestionario. Con submit la entrega y el trabajo avanza; entregar pide confirmación.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/works.tasks.answer |
| Herramienta MCP | works_tasks_answer |
| Alcance | works.write |
| Rol mínimo | Miembro |
| Confirmación humana | Sí |
| Puertas | Nödo, Voz, MCP, API |
| Estado | Próximamente |
| Widget | form |
Entrada
{
taskId: string // uuid
expectedRevision: integer // -9007199254740991–9007199254740991
answers: Array<{
questionId: string
value: string | number | boolean | string[]
}> // ≤ 100 items
submit?: boolean // default false
}Salida
{
ok: true
id?: string
revision?: integer // -9007199254740991–9007199254740991
}Aprueba un entregable o pide cambios con un comentario. Solo en tareas de revisión que esperan a la marca.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/works.tasks.review |
| Herramienta MCP | works_tasks_review |
| Alcance | works.write |
| Rol mínimo | Miembro |
| Confirmación humana | Sí |
| Puertas | Nödo, Voz, MCP, API |
| Estado | Próximamente |
| Widget | review |
Entrada
{
decision: "approve"
taskId: string // uuid
expectedRevision: integer // -9007199254740991–9007199254740991
}
| {
decision: "request_changes"
taskId: string // uuid
expectedRevision: integer // -9007199254740991–9007199254740991
comment: string // ≤ 4000
}Salida
{
ok: true
id?: string
revision?: integer // -9007199254740991–9007199254740991
}Crea un trabajo a partir de un producto del Store incluido en el plan. Si el producto es de pago y no está incluido, devuelve el enlace a su ficha.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/works.create_from_product |
| Herramienta MCP | works_create_from_product |
| Alcance | works.write |
| Rol mínimo | Miembro |
| Confirmación humana | Sí |
| Puertas | Nödo, Voz, MCP, API |
| Estado | Próximamente |
| Widget | confirm |
Entrada
{
productSlug: string // ≤ 120
notes?: string // ≤ 2000
}Salida
{
ok: true
id?: string
revision?: integer // -9007199254740991–9007199254740991
}
| {
ok: false
reason: "not_in_plan"
storeUrl: string // uri
}Actualizado el 1 de enero de 1970