Alterar uma tarefa do Asana é um PATCH em /asana/v1/connections/{connection_id}/projects/{project_id}/tasks/{task_id}, na MakeHybrid Asana API: as contas do Asana que a sua organização conectou, e os projetos que elas alcançam. Toda requisição leva a sua própria chave em um cabeçalho X-API-KEY — a mesma chave da API do LinkedIn — e chega só a essas conexões.
As chamadas são feitas com o token que um membro colou, então o Asana registra tudo como essa pessoa — e é a mesma conexão com a qual uma sala de projeto mantém as suas tarefas em sincronia.
A requisição
curl -X PATCH "https://makehybrid.com/asana/v1/connections/$CONNECTION_ID/projects/$PROJECT_ID/tasks/$TASK_ID" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
O que vai no caminho
- connection_id — um id devolvido por uma chamada anterior desta família.
- project_id — um id devolvido por uma chamada anterior desta família.
- task_id — um id devolvido por uma chamada anterior desta família.
O que volta quando não funciona
- 401 — a chave está faltando, está errada ou foi revogada.
- 402 — o plano não está pago. A MakeHybrid API responde isso quando o teste acaba.
- 404 — ou a coisa não está lá, ou não é da sua organização. As duas respostas são a mesma de propósito, para que ids não possam ser sondados.
- 429 — requisições demais, ou a plataforma pedindo que a gente diminua o ritmo. Espere um instante antes de tentar de novo.
- 502 ou 503 — a plataforma não respondeu agora há pouco. Tente de novo daqui a pouco.
Todo erro é JSON no mesmo formato: {"type":"errors/<code>","status":<n>,"detail":"..."} — então um único tratador cobre todos, e o detail foi escrito para ser mostrado a uma pessoa.
Pedir a um assistente
Esta operação também é uma ferramenta MCP. Cole https://makehybrid.com/asana/mcp/<your API key> no Claude, no ChatGPT ou em qualquer assistente que fale MCP e peça o que quiser em português — o assistente escolhe a chamada, preenche os ids e lê a resposta para você. O agente tudo em um que está em https://makehybrid.com/mcp/<your API key> também a tem, ao lado da API do LinkedIn e de todos os outros canais.
Em uma sala de projeto
Em uma sala de projeto, marque o agente desta API em Pode usar para um agente de IA seu, e ele chama “Alterar uma tarefa do Asana” como ferramenta sempre que a conversa precisar. Todo mundo na sala vê o que ele pediu e o que voltou. Peça em palavras simples; aqui o agente se chama @scout:
- @scout liste o que ainda está em aberto no nosso projeto de lançamento do Asana e adicione uma tarefa para a página de preços.
Perguntas frequentes
Um agente de IA pode chamar “Alterar uma tarefa do Asana” por mim?
Pode. Qualquer assistente que fale MCP pode, pelo endereço acima, e também um agente de IA seu em uma sala de projeto com o agente desta API marcado. Os agentes integrados de uma sala não podem: eles aconselham, e não têm a sua chave.
Funciona fora de uma sala, a partir do meu próprio código?
Funciona. A requisição acima é a mesma operação que as ferramentas de um agente de IA chamam, com a mesma resposta e os mesmos erros, e a sua chave alcança os mesmos canais, por qualquer caminho que você entre.
Funciona em uma sala com a minha própria marca?
Funciona. Em um endereço de marca branca, a API, a sua referência e o seu agente de IA levam o nome do seu produto e alcançam os mesmos canais, com as mesmas regras.
Uma pessoa pode aprovar antes de um agente de IA fazer isso?
Escreva isso nas instruções do agente de IA: ele diz o que está prestes a enviar e espera uma pessoa na sala dizer que pode ir. Uma sala mostra cada resposta a todos que estão nela, então as palavras são vistas antes de chegarem a qualquer pessoa de fora.
Em qual plano está
Faz parte do plano MakeHybrid API, com a mesma chave da API do LinkedIn: $9 por assento por mês, $7 a partir de dez assentos e $5 a partir de mil. Você precisa de tantos assentos quantos tiver do tipo mais numeroso — contas do LinkedIn, números de WhatsApp, contas do X ou contas de caixa de entrada — e os 30 dias de teste cobrem um.