Developers
Acessar miCore Começar
Fluxo de Trabalho

Quadros Kanbans

Quadros, colunas, tarefas e modelos de tarefa para organizar o trabalho.

O que é

Quadros e Tarefas é o módulo de organização do trabalho em quadros (kanban). Pela API, você lê a estrutura dos quadros e gerencia as tarefas usando a mesma base do painel do miCore.

Na prática: você descobre os quadros e suas colunas, cria e atualiza tarefas e define quem é responsável — tudo em nome de um usuário responsável, respeitando as permissões dele.

O que dá para fazer hoje

  • Ver quadros e suas colunas.
  • Criar, editar e arquivar um quadro.
  • Ver os participantes de um quadro (quem pode ser atribuído).
  • Criar e editar colunas de um quadro.
  • Listar e consultar tarefas.
  • Criar uma tarefa num quadro.
  • Atualizar progresso, coluna e datas de uma tarefa.
  • Atribuir responsáveis.
  • Ler, criar, editar e arquivar comentários numa tarefa, mencionando pessoas.
  • Travar o prazo do quadro e pedir, aprovar, recusar ou cancelar um novo prazo.
  • Listar, criar, editar, ativar e desativar modelos de tarefa (tarefa pronta com checklist e prazo).

Importante

  • Toda tarefa pertence a um quadro; descubra o quadro e as colunas antes de criar.
  • Sem responsável, a tarefa nasce em "unassigned".
  • Trocar o progresso é edição; trocar responsáveis é uma ação própria, com sua permissão.
  • No quadro com o prazo travado (lock_due_date), só o gestor do quadro ou um administrador de Quadros muda o prazo final já definido; os demais pedem novo prazo.

Disponibilidade na API

Endpoints de Quadros e Tarefas

Consulte, crie e organize quadros, colunas, tarefas e modelos de tarefa do fluxo de trabalho. Os exemplos abaixo são gerados pelo contrato OpenAPI oficial.

GET /api/v1/boards

Lista quadros com suas colunas

Exige o escopo `boards:read`. Use para descobrir o quadro e as colunas antes de criar uma tarefa.

Parâmetros

NomeTipoObrigatórioDescrição
per_pagequeryintegerNão—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/boards" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": [
        {
            "id": 4,
            "name": "Suporte",
            "description": "Fila do time de suporte",
            "lock_due_date": false,
            "stages": [
                {
                    "id": 10,
                    "name": "A fazer",
                    "order": 0,
                    "color": "#ffc700"
                },
                {
                    "id": 11,
                    "name": "Fazendo",
                    "order": 1,
                    "color": "#029ef4"
                }
            ],
            "created_at": "2026-10-01T09:00:00-03:00",
            "updated_at": "2026-10-10T09:00:00-03:00"
        }
    ],
    "links": [],
    "meta": []
}

Respostas possíveis

200 Página de quadros401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/boards

Cria um quadro

Exige `boards:write` e a permissão de criar em Gestão de Espaço. O quadro nasce com as 6 colunas padrão. Descubra o `owner_team_id` e os membros em `GET /teams`.

Parâmetros

NomeTipoObrigatórioDescrição
Idempotency-KeyheaderstringSimIdentificador único da mutação, com 8 a 100 caracteres. O resultado fica reutilizável por 24 horas e a chave não pode ser reutilizada depois de expirar.

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringSimÚnico entre quadros ativos. Até 255 caracteres.
manager_idintegerSimGestor do quadro; precisa pertencer ao time responsável.
owner_team_idintegerSimTime responsável (ativo). Descubra em GET /teams.
member_user_idsarray<integer>NãoParticipantes; precisam pertencer ao time responsável.
descriptionstring | nullNão—
calendarstring | nullNão—
accept_classboolean | nullNão—
lock_due_datebooleanNãoSó o gestor do quadro (ou um administrador de Quadros) muda o prazo final já definido das tarefas. Definir o primeiro prazo continua livre. Padrão: false.

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/boards" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: board-request-0001" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","manager_id":1,"owner_team_id":1,"member_user_ids":[1],"description":null,"calendar":null,"accept_class":true,"lock_due_date":true}'

Exemplo de resposta JSON

Resposta · 201
{
    "data": {
        "id": 4,
        "name": "Suporte",
        "description": "Fila do time de suporte",
        "lock_due_date": false,
        "stages": [
            {
                "id": 10,
                "name": "A fazer",
                "order": 0,
                "color": "#ffc700"
            },
            {
                "id": 11,
                "name": "Fazendo",
                "order": 1,
                "color": "#029ef4"
            }
        ],
        "created_at": "2026-10-01T09:00:00-03:00",
        "updated_at": "2026-10-10T09:00:00-03:00"
    }
}

Respostas possíveis

201 Quadro criado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente409 Chave em processamento ou reutilizada com outro conteúdo422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/boards/{board}

Exibe um quadro com suas colunas

Exige o escopo `boards:read`.

Parâmetros

NomeTipoObrigatórioDescrição
boardpathintegerSim—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/boards/{board}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 4,
        "name": "Suporte",
        "description": "Fila do time de suporte",
        "lock_due_date": false,
        "stages": [
            {
                "id": 10,
                "name": "A fazer",
                "order": 0,
                "color": "#ffc700"
            },
            {
                "id": 11,
                "name": "Fazendo",
                "order": 1,
                "color": "#029ef4"
            }
        ],
        "created_at": "2026-10-01T09:00:00-03:00",
        "updated_at": "2026-10-10T09:00:00-03:00"
    }
}

Respostas possíveis

200 Quadro encontrado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
PATCH /api/v1/boards/{board}

Atualiza um quadro

Exige `boards:write` e gerenciar o quadro. `manager_id` e `owner_team_id` são sempre exigidos. Sem `member_user_ids`, os participantes atuais continuam; com a lista, ela substitui os participantes (lista vazia deixa só o gestor). `lock_due_date` omitido mantém a trava do prazo como está.

Parâmetros

NomeTipoObrigatórioDescrição
boardpathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringSimAté 255 caracteres.
manager_idintegerSim—
owner_team_idintegerSim—
member_user_idsarray<integer>Não—
descriptionstring | nullNão—
calendarstring | nullNão—
accept_classboolean | nullNão—
lock_due_datebooleanNãoLiga ou desliga a trava do prazo; omitido fica como está.

Exemplo de requisição

cURL
curl -X PATCH "$MICORE_BASE_URL/boards/{board}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","manager_id":1,"owner_team_id":1,"member_user_ids":[1],"description":null,"calendar":null,"accept_class":true,"lock_due_date":true}'

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 4,
        "name": "Suporte",
        "description": "Fila do time de suporte",
        "lock_due_date": false,
        "stages": [
            {
                "id": 10,
                "name": "A fazer",
                "order": 0,
                "color": "#ffc700"
            },
            {
                "id": 11,
                "name": "Fazendo",
                "order": 1,
                "color": "#029ef4"
            }
        ],
        "created_at": "2026-10-01T09:00:00-03:00",
        "updated_at": "2026-10-10T09:00:00-03:00"
    }
}

Respostas possíveis

200 Quadro atualizado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
DELETE /api/v1/boards/{board}

Arquiva um quadro

Exige `boards:write` e gerenciar o quadro. Desativa (arquiva) o quadro sem apagar; reativar é feito pelo painel.

Parâmetros

NomeTipoObrigatórioDescrição
boardpathintegerSim—

Exemplo de requisição

cURL
curl -X DELETE "$MICORE_BASE_URL/boards/{board}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 4,
        "name": "Suporte",
        "description": "Fila do time de suporte",
        "lock_due_date": false,
        "stages": [
            {
                "id": 10,
                "name": "A fazer",
                "order": 0,
                "color": "#ffc700"
            },
            {
                "id": 11,
                "name": "Fazendo",
                "order": 1,
                "color": "#029ef4"
            }
        ],
        "created_at": "2026-10-01T09:00:00-03:00",
        "updated_at": "2026-10-10T09:00:00-03:00"
    }
}

Respostas possíveis

200 Quadro arquivado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/boards/{board}/members

Lista os participantes de um quadro

Exige o escopo `boards:read`. É o conjunto elegível para atribuir numa tarefa do quadro (participantes mais o gestor).

Parâmetros

NomeTipoObrigatórioDescrição
boardpathintegerSim—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/boards/{board}/members" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": [
        {
            "id": 7,
            "name": "Ana Souza",
            "email": "ana@empresa.com",
            "board_role": "manager"
        }
    ]
}

Respostas possíveis

200 Participantes do quadro401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/boards/{board}/columns

Cria uma coluna no quadro

Exige `boards:write` e gerenciar o quadro (gestor ou admin de Quadros). A coluna entra no fim da fila.

Parâmetros

NomeTipoObrigatórioDescrição
boardpathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringSimAté 255 caracteres.
descriptionstring | nullNãoO que significa estar nesta etapa e quando mover para a próxima. Aparece no tooltip da coluna e no contexto da Mia; vazio ou null tira. Até 300 caracteres.
colorstringSimHexadecimal #RRGGBB.
move_tostring | nullNãoRegra de responsável ao mover a tarefa para esta coluna. Padrão: "Não mudar usuário". Valores: Não mudar usuário, Selecionar novo usuário, Usuário fixo, Usuário atual.
move_to_idinteger | nullNãoUsuário fixo (obrigatório quando move_to = "Usuário fixo"); precisa participar do quadro.
show_in_flowboolean | nullNãoPadrão true.

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/boards/{board}/columns" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","description":null,"color":"#3B82F6","move_to":"Não mudar usuário","move_to_id":1,"show_in_flow":true}'

Exemplo de resposta JSON

Resposta · 201
{
    "data": {
        "id": 1,
        "name": "string",
        "description": null,
        "order": 1,
        "color": null
    }
}

Respostas possíveis

201 Coluna criada401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
PATCH /api/v1/columns/{column}

Atualiza uma coluna

Exige `boards:write` e gerenciar o quadro. Desativar (`status` false) arquiva as tarefas da coluna; o quadro precisa manter ao menos uma etapa ativa.

Parâmetros

NomeTipoObrigatórioDescrição
columnpathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringNãoAté 255 caracteres.
descriptionstring | nullNãoO que significa estar nesta etapa e quando mover para a próxima. Aparece no tooltip da coluna e no contexto da Mia; vazio ou null tira. Até 300 caracteres.
colorstringNãoHexadecimal #RRGGBB.
statusbooleanNãofalse arquiva as tarefas da coluna; o quadro precisa manter ao menos uma etapa ativa.
move_tostringNãoValores: Não mudar usuário, Selecionar novo usuário, Usuário fixo, Usuário atual.
move_to_idinteger | nullNão—
show_in_flowbooleanNão—

Exemplo de requisição

cURL
curl -X PATCH "$MICORE_BASE_URL/columns/{column}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","description":null,"color":"string","status":true,"move_to":"Não mudar usuário","move_to_id":1,"show_in_flow":true}'

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 1,
        "name": "string",
        "description": null,
        "order": 1,
        "color": null
    }
}

Respostas possíveis

200 Coluna atualizada401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/tasks

Lista tarefas de quadro

Exige o escopo `tasks:read`. Para o Minhas Tarefas, use `responsible=me`: traz as tarefas em que o usuário da credencial está entre os responsáveis, de qualquer quadro; com `progress=todo,doing` ficam só as abertas. Para mudar a etapa, use `PATCH /tasks/{task}` com `progress`.

Parâmetros

NomeTipoObrigatórioDescrição
board_idqueryintegerNão—
progressquerystringNãoUma etapa ou várias separadas por vírgula: `unassigned`, `todo`, `doing`, `paused`, `review`, `done`.
responsiblequerystringNão`me` (o usuário da credencial) ou o id de uma pessoa: tarefas em que ela está entre os responsáveis.
tagquerystringNãoTarefas com a tag de nome exato.
per_pagequeryintegerNão—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/tasks" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": [
        {
            "id": 512,
            "title": "Ligar para o cliente",
            "board_id": 4,
            "stage": {
                "id": 11,
                "name": "Fazendo"
            },
            "progress": "todo",
            "urgent": false,
            "reference": null,
            "responsibles": [
                {
                    "id": 7,
                    "name": "Ana Souza"
                }
            ],
            "date_start": "2026-10-20",
            "date_end": "2026-10-20",
            "created_at": "2026-10-17T09:00:00-03:00",
            "updated_at": "2026-10-17T09:00:00-03:00"
        }
    ],
    "links": [],
    "meta": []
}

Respostas possíveis

200 Página de tarefas401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/tasks

Cria uma tarefa de quadro

Exige `tasks:write`. A tarefa exige um quadro; a coluna é opcional. Sem responsável, nasce em "unassigned".

Parâmetros

NomeTipoObrigatórioDescrição
Idempotency-KeyheaderstringSimIdentificador único da mutação, com 8 a 100 caracteres. O resultado fica reutilizável por 24 horas e a chave não pode ser reutilizada depois de expirar.

Corpo da requisição

CampoTipoObrigatórioDescrição
board_idintegerSimQuadro existente onde a tarefa será criada.
titlestring | nullNãoObrigatório sem `task_template_id`; com modelo, vazio leva o nome do modelo. Até 255 caracteres.
task_template_idinteger | nullNãoModelo de tarefa ativo (veja /task-templates). Como no painel, a tarefa fica ligada ao modelo (conta nas metas por modelo), o checklist vira subtarefas e, no que não vier, valem o nome, o prazo (hoje + dias do modelo) e a descrição (instrução, descrição e link) do modelo. Modelo desativado responde 422.
stage_idinteger | nullNãoColuna do quadro; resolvida automaticamente quando ausente.
descriptionstring | nullNãoVira o comentário inicial da tarefa. Aceita HTML: p, br, h2–h4, strong, b, em, i, u, s, span, ul, ol, li, blockquote, pre, code, links (a href http/https/mailto/tel) e imagens (img src por http/https; envie o arquivo antes por POST /media e use o url devolvido). Scripts, eventos (onclick…), imagens em base64 e endereços javascript: são removidos ao gravar; texto sem tags continua texto.
responsible_user_idsarray<integer>NãoSem responsável, a tarefa nasce em "unassigned".
date_startstring | null (date)Não—
date_endstring | null (date)Não—
urgentboolean | nullNão—
tagsarray<string>NãoTags da tarefa, texto livre como no painel (não precisa existir no cadastro de /tags). A lista enviada substitui as atuais; [] tira todas; nome repetido (sem diferenciar maiúsculas) entra uma vez. A troca fica no histórico da tarefa.
referencestring | nullNãoAté 255 caracteres.

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/tasks" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: board-request-0001" \
  -H "Content-Type: application/json" \
  -d '{"board_id":1,"title":null,"task_template_id":1,"stage_id":1,"description":null,"responsible_user_ids":[1],"date_start":"2026-10-20","date_end":"2026-10-20","urgent":true,"tags":["string"],"reference":null}'

Exemplo de resposta JSON

Resposta · 201
{
    "data": {
        "id": 512,
        "title": "Ligar para o cliente",
        "board_id": 4,
        "stage": {
            "id": 11,
            "name": "Fazendo"
        },
        "progress": "todo",
        "urgent": false,
        "reference": null,
        "responsibles": [
            {
                "id": 7,
                "name": "Ana Souza"
            }
        ],
        "date_start": "2026-10-20",
        "date_end": "2026-10-20",
        "created_at": "2026-10-17T09:00:00-03:00",
        "updated_at": "2026-10-17T09:00:00-03:00"
    }
}

Respostas possíveis

201 Tarefa criada401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente409 Chave em processamento ou reutilizada com outro conteúdo422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/tasks/{task}

Exibe uma tarefa

Exige o escopo `tasks:read`.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/tasks/{task}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 512,
        "title": "Ligar para o cliente",
        "board_id": 4,
        "stage": {
            "id": 11,
            "name": "Fazendo"
        },
        "progress": "todo",
        "urgent": false,
        "reference": null,
        "responsibles": [
            {
                "id": 7,
                "name": "Ana Souza"
            }
        ],
        "date_start": "2026-10-20",
        "date_end": "2026-10-20",
        "created_at": "2026-10-17T09:00:00-03:00",
        "updated_at": "2026-10-17T09:00:00-03:00"
    }
}

Respostas possíveis

200 Tarefa encontrada401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
PATCH /api/v1/tasks/{task}

Atualiza progresso, coluna e datas de uma tarefa

Exige `tasks:write`. Responsáveis têm endpoint próprio. Para trocar de quadro, envie `board_id` (e, se quiser, `stage_id`); a troca fica no histórico da tarefa como no painel. Prazo travado: no quadro com `lock_due_date`, mudar um `date_end` já definido responde 403 `permission_denied` se o usuário da credencial não for o gestor do quadro nem administrador de Quadros; nesse caso peça o novo prazo em `POST /tasks/{task}/deadline-requests`. Envie `deadline_reason` para registrar o motivo da mudança no histórico.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
board_idintegerNãoMove a tarefa para outro quadro, como no painel, com o histórico de quadro e de coluna. Sem `stage_id`, a tarefa entra na primeira coluna ativa do quadro novo. As subtarefas vão junto.
progressstringNãoValores: unassigned, todo, doing, paused, review, done.
stage_idintegerNãoColuna ativa do quadro da tarefa (ou do `board_id` enviado); coluna de outro quadro responde 422 em `stage_id`.
date_startstring | null (date)Não—
date_endstring | null (date)NãoPrazo final. No quadro com `lock_due_date`, mudar o prazo já definido exige que o usuário da credencial seja o gestor do quadro ou administrador de Quadros (senão 403 `permission_denied`); definir o primeiro prazo é livre.
deadline_reasonstring | nullNãoMotivo da mudança do prazo final, gravado no histórico da tarefa (evento task.date_changed). Só tem efeito junto com `date_end`. Até 500 caracteres.
urgentbooleanNão—
tagsarray<string>NãoTags da tarefa, texto livre como no painel (não precisa existir no cadastro de /tags). A lista enviada substitui as atuais; [] tira todas; nome repetido (sem diferenciar maiúsculas) entra uma vez. A troca fica no histórico da tarefa.
referencestring | nullNãoAté 255 caracteres.

Exemplo de requisição

cURL
curl -X PATCH "$MICORE_BASE_URL/tasks/{task}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"board_id":1,"progress":"unassigned","stage_id":1,"date_start":"2026-10-20","date_end":"2026-10-20","deadline_reason":null,"urgent":true,"tags":["string"],"reference":null}'

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 512,
        "title": "Ligar para o cliente",
        "board_id": 4,
        "stage": {
            "id": 11,
            "name": "Fazendo"
        },
        "progress": "todo",
        "urgent": false,
        "reference": null,
        "responsibles": [
            {
                "id": 7,
                "name": "Ana Souza"
            }
        ],
        "date_start": "2026-10-20",
        "date_end": "2026-10-20",
        "created_at": "2026-10-17T09:00:00-03:00",
        "updated_at": "2026-10-17T09:00:00-03:00"
    }
}

Respostas possíveis

200 Tarefa atualizada401 Token ausente, inválido, expirado ou revogado403 Escopo ou permissão insuficiente, ou prazo travado no quadro para quem não é gestor nem administrador de Quadros404 Recurso não encontrado422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/tasks/{task}/deadline-requests

Lista os pedidos de novo prazo de uma tarefa

Exige `tasks:read`. Todos os pedidos da tarefa (pendentes e decididos), do mais recente ao mais antigo.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—
per_pagequeryintegerNão—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/tasks/{task}/deadline-requests" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": [
        {
            "id": 31,
            "task_id": 512,
            "board_id": 4,
            "requested_by": 12,
            "current_date_end": "2026-11-20",
            "proposed_date_end": "2026-11-27",
            "reason": "Aguardando o material do cliente.",
            "status": "pending",
            "decided_by": null,
            "decided_at": null,
            "decision_note": null,
            "created_at": "2026-11-12T10:00:00-03:00"
        }
    ],
    "links": [],
    "meta": []
}

Respostas possíveis

200 Página de pedidos de novo prazo401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/tasks/{task}/deadline-requests

Pede um novo prazo para a tarefa

Exige `tasks:write`. Mesma regra do painel: só vale no quadro com `lock_due_date` e tarefa com prazo final definido, para quem não é gestor do quadro nem administrador de Quadros (os dois mudam o prazo direto pelo PATCH). A tarefa segue com o prazo atual até a decisão e o gestor é avisado no sino. A tarefa tem no máximo um pedido pendente: repetir o seu troca a data e o motivo; pendente de outra pessoa responde 409 `invalid_transition`, assim como quadro sem trava. Data igual à atual ou motivo vazio respondem 422.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—
Idempotency-KeyheaderstringSimIdentificador único da mutação, com 8 a 100 caracteres. O resultado fica reutilizável por 24 horas e a chave não pode ser reutilizada depois de expirar.

Corpo da requisição

CampoTipoObrigatórioDescrição
datestring (date)SimNovo prazo final proposto (ano-mês-dia), diferente do atual.
reasonstringSimMotivo do pedido, que o gestor lê para decidir. Até 1000 caracteres.

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/tasks/{task}/deadline-requests" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: board-request-0001" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-11-27","reason":"Aguardando o material do cliente."}'

Exemplo de resposta JSON

Resposta · 201
{
    "data": {
        "id": 31,
        "task_id": 512,
        "board_id": 4,
        "requested_by": 12,
        "current_date_end": "2026-11-20",
        "proposed_date_end": "2026-11-27",
        "reason": "Aguardando o material do cliente.",
        "status": "pending",
        "decided_by": null,
        "decided_at": null,
        "decision_note": null,
        "created_at": "2026-11-12T10:00:00-03:00"
    }
}

Respostas possíveis

201 Pedido aberto, pendente401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado409 Chave em processamento ou reutilizada com outro conteúdo, ou ação não permitida no estado atual do recurso (`invalid_transition`)422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/deadline-requests/{deadlineRequest}/approve

Aprova um pedido de novo prazo

Exige `tasks:write` e que o usuário da credencial seja o gestor do quadro ou administrador de Quadros (senão 403 `permission_denied`). O prazo final da tarefa passa a ser a data pedida, com o motivo do pedido no histórico; o início só muda se passar da nova data. Quem pediu é avisado. Pedido já decidido ou cancelado responde 409 `invalid_transition`.

Parâmetros

NomeTipoObrigatórioDescrição
deadlineRequestpathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
notestring | nullNãoObservação de quem decide, enviada a quem pediu. Até 1000 caracteres.

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/deadline-requests/{deadlineRequest}/approve" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"note":null}'

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 31,
        "task_id": 512,
        "board_id": 4,
        "requested_by": 12,
        "current_date_end": "2026-11-20",
        "proposed_date_end": "2026-11-27",
        "reason": "Aguardando o material do cliente.",
        "status": "pending",
        "decided_by": null,
        "decided_at": null,
        "decision_note": null,
        "created_at": "2026-11-12T10:00:00-03:00"
    }
}

Respostas possíveis

200 Pedido aprovado401 Token ausente, inválido, expirado ou revogado403 Escopo ou permissão insuficiente, ou usuário que não decide pelo quadro404 Recurso não encontrado409 Chave em processamento ou reutilizada com outro conteúdo, ou ação não permitida no estado atual do recurso (`invalid_transition`)422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/deadline-requests/{deadlineRequest}/refuse

Recusa um pedido de novo prazo

Exige `tasks:write` e que o usuário da credencial seja o gestor do quadro ou administrador de Quadros (senão 403 `permission_denied`). A tarefa segue com o prazo atual e quem pediu é avisado, com a `note` se houver. Pedido já decidido ou cancelado responde 409 `invalid_transition`.

Parâmetros

NomeTipoObrigatórioDescrição
deadlineRequestpathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
notestring | nullNãoObservação de quem decide, enviada a quem pediu. Até 1000 caracteres.

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/deadline-requests/{deadlineRequest}/refuse" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"note":null}'

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 31,
        "task_id": 512,
        "board_id": 4,
        "requested_by": 12,
        "current_date_end": "2026-11-20",
        "proposed_date_end": "2026-11-27",
        "reason": "Aguardando o material do cliente.",
        "status": "pending",
        "decided_by": null,
        "decided_at": null,
        "decision_note": null,
        "created_at": "2026-11-12T10:00:00-03:00"
    }
}

Respostas possíveis

200 Pedido recusado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado409 Chave em processamento ou reutilizada com outro conteúdo, ou ação não permitida no estado atual do recurso (`invalid_transition`)422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/deadline-requests/{deadlineRequest}/cancel

Cancela o próprio pedido de novo prazo

Exige `tasks:write`. Só quem pediu cancela (outro usuário recebe 403 `permission_denied`), e só o pedido pendente (senão 409 `invalid_transition`). A tarefa segue com o prazo atual.

Parâmetros

NomeTipoObrigatórioDescrição
deadlineRequestpathintegerSim—

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/deadline-requests/{deadlineRequest}/cancel" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 31,
        "task_id": 512,
        "board_id": 4,
        "requested_by": 12,
        "current_date_end": "2026-11-20",
        "proposed_date_end": "2026-11-27",
        "reason": "Aguardando o material do cliente.",
        "status": "pending",
        "decided_by": null,
        "decided_at": null,
        "decision_note": null,
        "created_at": "2026-11-12T10:00:00-03:00"
    }
}

Respostas possíveis

200 Pedido cancelado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado409 Chave em processamento ou reutilizada com outro conteúdo, ou ação não permitida no estado atual do recurso (`invalid_transition`)429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/tasks/{task}/assign

Define os responsáveis de uma tarefa

Exige `tasks:assign` e a permissão de atribuir tarefas. Lista vazia deixa a tarefa para distribuição.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
responsible_user_idsarray<integer>SimLista completa de responsáveis; vazia deixa a tarefa para distribuição.

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/tasks/{task}/assign" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"responsible_user_ids":[1]}'

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 512,
        "title": "Ligar para o cliente",
        "board_id": 4,
        "stage": {
            "id": 11,
            "name": "Fazendo"
        },
        "progress": "todo",
        "urgent": false,
        "reference": null,
        "responsibles": [
            {
                "id": 7,
                "name": "Ana Souza"
            }
        ],
        "date_start": "2026-10-20",
        "date_end": "2026-10-20",
        "created_at": "2026-10-17T09:00:00-03:00",
        "updated_at": "2026-10-17T09:00:00-03:00"
    }
}

Respostas possíveis

200 Responsáveis atualizados401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/tasks/{task}/comments

Lista os comentários de uma tarefa

Exige o escopo `tasks:read`.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—
per_pagequeryintegerNão—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/tasks/{task}/comments" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": [
        {
            "id": 9001,
            "task_id": 512,
            "text": "Cliente retornou a ligação, aguardando proposta.",
            "task_progress": "doing",
            "author": {
                "id": 7,
                "name": "Ana Souza"
            },
            "archived": false,
            "mentions": [
                {
                    "user": {
                        "id": 12,
                        "name": "Bruno Lima"
                    },
                    "type": "direct",
                    "status": "pending"
                }
            ],
            "created_at": "2026-10-17T10:00:00-03:00",
            "updated_at": "2026-10-17T10:00:00-03:00"
        }
    ],
    "links": [],
    "meta": []
}

Respostas possíveis

200 Página de comentários401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/tasks/{task}/comments

Comenta numa tarefa

Exige `tasks:write`. Registra o comentário e o evento da tarefa, como no painel. O texto aceita HTML com imagens (veja `CreateTaskComment`). `mention_user_ids` e `mention_everyone` mencionam pessoas e as avisam, como o @ do painel (lista em `GET /tasks/{task}/mentionable-users`).

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—
Idempotency-KeyheaderstringSimIdentificador único da mutação, com 8 a 100 caracteres. O resultado fica reutilizável por 24 horas e a chave não pode ser reutilizada depois de expirar.

Corpo da requisição

CampoTipoObrigatórioDescrição
textstringSimAceita HTML: p, br, h2–h4, strong, b, em, i, u, s, span, ul, ol, li, blockquote, pre, code, links (a href http/https/mailto/tel) e imagens (img src por http/https; envie o arquivo antes por POST /media e use o url devolvido). Scripts, eventos (onclick…), imagens em base64 e endereços javascript: são removidos ao gravar; texto sem tags continua texto. Até 5000 caracteres.
mention_user_idsarray<integer>NãoPessoas mencionadas, avisadas no sino e no app. Só valem as de GET /tasks/{task}/mentionable-users; as outras são ignoradas. Para o nome aparecer destacado no texto, use <span class="mention" data-user-id="12">@Bruno</span>.
mention_everyonebooleanNãoMenciona e avisa todos os mencionáveis da tarefa. Padrão: false.

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/tasks/{task}/comments" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: board-request-0001" \
  -H "Content-Type: application/json" \
  -d '{"text":"<p>Arte aprovada:</p><img src=\"https://empresa.exemplo.com/storage/media/arte.png\" alt=\"Arte\">","mention_user_ids":[12]}'

Exemplo de resposta JSON

Resposta · 201
{
    "data": {
        "id": 9001,
        "task_id": 512,
        "text": "Cliente retornou a ligação, aguardando proposta.",
        "task_progress": "doing",
        "author": {
            "id": 7,
            "name": "Ana Souza"
        },
        "archived": false,
        "mentions": [
            {
                "user": {
                    "id": 12,
                    "name": "Bruno Lima"
                },
                "type": "direct",
                "status": "pending"
            }
        ],
        "created_at": "2026-10-17T10:00:00-03:00",
        "updated_at": "2026-10-17T10:00:00-03:00"
    }
}

Respostas possíveis

201 Comentário criado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado409 Chave em processamento ou reutilizada com outro conteúdo422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
PATCH /api/v1/tasks/{task}/comments/{comment}

Edita um comentário da tarefa

Exige `tasks:write`. Mesma regra do painel: quem pode ver a tarefa edita o comentário, registra a edição no histórico e avisa quem foi mencionado agora (quem já estava mencionado não recebe de novo). Campo omitido fica como está; menções só se acrescentam. Comentário de outra tarefa responde 404; arquivado responde 409.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—
commentpathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
textstringNãoMesmas regras de HTML de CreateTaskComment. Omitido, o texto fica como está. Até 5000 caracteres.
mention_user_idsarray<integer>NãoAcrescenta menções; quem já estava mencionado continua e não é avisado de novo.
mention_everyonebooleanNãoPadrão: false.

Exemplo de requisição

cURL
curl -X PATCH "$MICORE_BASE_URL/tasks/{task}/comments/{comment}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"text":"<p>Versão final aprovada. <span class=\"mention\" data-user-id=\"12\">@Bruno</span> pode publicar.</p>","mention_user_ids":[12]}'

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 9001,
        "task_id": 512,
        "text": "Cliente retornou a ligação, aguardando proposta.",
        "task_progress": "doing",
        "author": {
            "id": 7,
            "name": "Ana Souza"
        },
        "archived": false,
        "mentions": [
            {
                "user": {
                    "id": 12,
                    "name": "Bruno Lima"
                },
                "type": "direct",
                "status": "pending"
            }
        ],
        "created_at": "2026-10-17T10:00:00-03:00",
        "updated_at": "2026-10-17T10:00:00-03:00"
    }
}

Respostas possíveis

200 Comentário editado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado409 Chave em processamento ou reutilizada com outro conteúdo, ou ação não permitida no estado atual do recurso (`invalid_transition`)422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/tasks/{task}/comments/{comment}/archive

Arquiva um comentário da tarefa

Exige `tasks:write`. Mesma regra do painel: o comentário sai da tarefa e da listagem e o arquivamento fica no histórico. Arquivar de novo devolve o mesmo comentário, sem outro registro. Comentário de outra tarefa responde 404.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—
commentpathintegerSim—

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/tasks/{task}/comments/{comment}/archive" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 9001,
        "task_id": 512,
        "text": "Cliente retornou a ligação, aguardando proposta.",
        "task_progress": "doing",
        "author": {
            "id": 7,
            "name": "Ana Souza"
        },
        "archived": false,
        "mentions": [
            {
                "user": {
                    "id": 12,
                    "name": "Bruno Lima"
                },
                "type": "direct",
                "status": "pending"
            }
        ],
        "created_at": "2026-10-17T10:00:00-03:00",
        "updated_at": "2026-10-17T10:00:00-03:00"
    }
}

Respostas possíveis

200 Comentário arquivado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/tasks/{task}/mentionable-users

Lista quem pode ser mencionado nos comentários

Exige `tasks:read`. Mesma lista do painel: quem criou, os responsáveis, quem já comentou ou agiu na tarefa, as pessoas da solicitação de origem e a equipe e o gestor do quadro. Ids fora dessa lista enviados em `mention_user_ids` são ignorados.

Parâmetros

NomeTipoObrigatórioDescrição
taskpathintegerSim—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/tasks/{task}/mentionable-users" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": [
        {
            "id": 1,
            "name": "string"
        }
    ]
}

Respostas possíveis

200 Pessoas mencionáveis, por nome401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/task-templates

Lista os modelos de tarefa

Exige `task-templates:read` e ver Gestão de Espaço. Ordem alfabética, com quantas tarefas cada modelo já criou.

Parâmetros

NomeTipoObrigatórioDescrição
statusquerybooleanNãotrue para ativos, false para desativados.
searchquerystringNãoParte do nome.
per_pagequeryintegerNão—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/task-templates" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": [
        {
            "id": 2,
            "name": "Roteiro de Reels",
            "instruction": "Escrever o roteiro a partir da pauta.",
            "description": null,
            "help_link": null,
            "checklist": [
                "Gancho nos 3 primeiros segundos",
                "Dor do cliente",
                "Chamada para ação"
            ],
            "due_days": 2,
            "status": true,
            "tasks_created": 4,
            "created_at": "2026-11-05T09:00:00-03:00",
            "updated_at": "2026-11-05T09:00:00-03:00"
        }
    ],
    "links": [],
    "meta": []
}

Respostas possíveis

200 Página de modelos401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/task-templates

Cria um modelo de tarefa

Exige `task-templates:write` e criar em Gestão de Espaço. Mesma regra do painel: nasce ativo, itens vazios do checklist são descartados e cada item vira uma subtarefa quando o modelo é usado (Nova tarefa ou Tarefa de um processo).

Parâmetros

NomeTipoObrigatórioDescrição
Idempotency-KeyheaderstringSimIdentificador único da mutação, com 8 a 100 caracteres. O resultado fica reutilizável por 24 horas e a chave não pode ser reutilizada depois de expirar.

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringSimAté 255 caracteres.
instructionstring | nullNãoAté 5000 caracteres.
descriptionstring | nullNãoAté 20000 caracteres.
help_linkstring | null (uri)NãoAté 255 caracteres.
checklistarray<string | null>Não—
due_daysinteger | nullNão—

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/task-templates" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: board-request-0001" \
  -H "Content-Type: application/json" \
  -d '{"name":"Roteiro de Reels","instruction":"Escrever o roteiro a partir da pauta.","checklist":["Gancho nos 3 primeiros segundos","Dor do cliente","Chamada para ação"],"due_days":2}'

Exemplo de resposta JSON

Resposta · 201
{
    "data": {
        "id": 2,
        "name": "Roteiro de Reels",
        "instruction": "Escrever o roteiro a partir da pauta.",
        "description": null,
        "help_link": null,
        "checklist": [
            "Gancho nos 3 primeiros segundos",
            "Dor do cliente",
            "Chamada para ação"
        ],
        "due_days": 2,
        "status": true,
        "tasks_created": 4,
        "created_at": "2026-11-05T09:00:00-03:00",
        "updated_at": "2026-11-05T09:00:00-03:00"
    }
}

Respostas possíveis

201 Modelo criado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente409 Chave em processamento ou reutilizada com outro conteúdo422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
GET /api/v1/task-templates/{taskTemplate}

Exibe um modelo de tarefa

Exige `task-templates:read`.

Parâmetros

NomeTipoObrigatórioDescrição
taskTemplatepathintegerSim—

Exemplo de requisição

cURL
curl "$MICORE_BASE_URL/task-templates/{taskTemplate}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 2,
        "name": "Roteiro de Reels",
        "instruction": "Escrever o roteiro a partir da pauta.",
        "description": null,
        "help_link": null,
        "checklist": [
            "Gancho nos 3 primeiros segundos",
            "Dor do cliente",
            "Chamada para ação"
        ],
        "due_days": 2,
        "status": true,
        "tasks_created": 4,
        "created_at": "2026-11-05T09:00:00-03:00",
        "updated_at": "2026-11-05T09:00:00-03:00"
    }
}

Respostas possíveis

200 Modelo encontrado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
PATCH /api/v1/task-templates/{taskTemplate}

Atualiza um modelo de tarefa

Exige `task-templates:write` e editar em Gestão de Espaço. Parcial: campo omitido fica como está; o `checklist` enviado substitui o anterior. Vale para as próximas tarefas e execuções; as que já nasceram não mudam.

Parâmetros

NomeTipoObrigatórioDescrição
taskTemplatepathintegerSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringNãoAté 255 caracteres.
instructionstring | nullNãoAté 5000 caracteres.
descriptionstring | nullNãoAté 20000 caracteres.
help_linkstring | null (uri)NãoAté 255 caracteres.
checklistarray<string | null>Não—
due_daysinteger | nullNão—

Exemplo de requisição

cURL
curl -X PATCH "$MICORE_BASE_URL/task-templates/{taskTemplate}" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","instruction":null,"description":null,"help_link":null,"checklist":[null],"due_days":1}'

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 2,
        "name": "Roteiro de Reels",
        "instruction": "Escrever o roteiro a partir da pauta.",
        "description": null,
        "help_link": null,
        "checklist": [
            "Gancho nos 3 primeiros segundos",
            "Dor do cliente",
            "Chamada para ação"
        ],
        "due_days": 2,
        "status": true,
        "tasks_created": 4,
        "created_at": "2026-11-05T09:00:00-03:00",
        "updated_at": "2026-11-05T09:00:00-03:00"
    }
}

Respostas possíveis

200 Modelo atualizado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado422 Dados inválidos429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/task-templates/{taskTemplate}/activate

Ativa um modelo de tarefa

Exige `task-templates:write` e desabilitar em Gestão de Espaço. Idempotente: modelo já ativo continua ativo.

Parâmetros

NomeTipoObrigatórioDescrição
taskTemplatepathintegerSim—

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/task-templates/{taskTemplate}/activate" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 2,
        "name": "Roteiro de Reels",
        "instruction": "Escrever o roteiro a partir da pauta.",
        "description": null,
        "help_link": null,
        "checklist": [
            "Gancho nos 3 primeiros segundos",
            "Dor do cliente",
            "Chamada para ação"
        ],
        "due_days": 2,
        "status": true,
        "tasks_created": 4,
        "created_at": "2026-11-05T09:00:00-03:00",
        "updated_at": "2026-11-05T09:00:00-03:00"
    }
}

Respostas possíveis

200 Modelo ativo401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant
POST /api/v1/task-templates/{taskTemplate}/deactivate

Desativa um modelo de tarefa

Exige `task-templates:write` e desabilitar em Gestão de Espaço. Sai das listas de escolha; processos que usam o modelo deixam de poder iniciar até trocar o modelo. Idempotente.

Parâmetros

NomeTipoObrigatórioDescrição
taskTemplatepathintegerSim—

Exemplo de requisição

cURL
curl -X POST "$MICORE_BASE_URL/task-templates/{taskTemplate}/deactivate" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Exemplo de resposta JSON

Resposta · 200
{
    "data": {
        "id": 2,
        "name": "Roteiro de Reels",
        "instruction": "Escrever o roteiro a partir da pauta.",
        "description": null,
        "help_link": null,
        "checklist": [
            "Gancho nos 3 primeiros segundos",
            "Dor do cliente",
            "Chamada para ação"
        ],
        "due_days": 2,
        "status": true,
        "tasks_created": 4,
        "created_at": "2026-11-05T09:00:00-03:00",
        "updated_at": "2026-11-05T09:00:00-03:00"
    }
}

Respostas possíveis

200 Modelo desativado401 Token ausente, inválido, expirado ou revogado403 Escopo, assinatura, módulo ou permissão insuficiente404 Recurso não encontrado429 Cota por minuto da credencial excedida503 O domínio não pôde ser associado com segurança a um tenant