Tarefas · Auditoria Web · Referência da API

POST/v1/seo/site-auditor/runs/{run_id}/issues/{issue_id}/tasks

Create a task from an audit issue

seo_site_auditor.tasks.create_from_issue

EscritaDesde 2026-11-01

Creates a task in Tasks from one active issue of an audit (issue_id: id of an item of seo_site_auditor.issues.list with state=active): the title is the issue's title; the description says what is wrong, why it matters, how to fix it, up to 10 affected pages and the audited site; the priority follows the severity (critical → high, high → medium, the rest → low); it gets the organization's «SEO» task label if there is one; assignee defaults to the caller (null leaves it unassigned) and due_date to today (null leaves it without a date). Where it lands follows the app: an agency member working an account files it in the workspace's Tasks under that account (account_id; task_org_id says where it is); a member of the account, in the account itself (an account's own API key always files it there). The new task fires task_management.task.created to the webhooks of the organization that holds it. Errors: audit_run_not_found (404), audit_issue_not_found (404), audit_issue_ignored (409: the issue was marked as intentional), task_access_denied (403: no edit access to Tasks where the task goes), scope_insufficient (403: an API key also needs task_management:write). Not idempotent: each call creates a task. Requires edit access to Site Audit and to Tasks.

Escopo: seo_site_auditor:write
Permissão: Editar no módulo
Tool do MCP: seo_site_auditor_tasks_create_from_issueNa superfície completa; na compacta, mb_execute_operation com id: "seo_site_auditor.tasks.create_from_issue".

Custo declarado: até 60 leituras e 1 escritas por chamada (contam na cota diária).

Parâmetros

run_idstringrotaobrigatório

Audit id (id from seo_site_auditor.runs.list, or run_id from seo_site_auditor.runs.trigger).

issue_idstringrotaobrigatório

Issue id: the id of the check, e.g. meta_description_missing (id of an item of seo_site_auditor.issues.list).

assignee_idstring | nullcorpoopcional

Who the task is assigned to (a person who can be in the task). Without it, the caller, as in the app; null leaves it unassigned.

due_dateinteger | nullcorpoopcional

Due date in ms. Without it, today (as in the app); null leaves it without a date.

Resposta

task_idstring

task_org_idstring

account_idstring | null

taskobject

Erros

audit_run_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Exemplo

curl -X POST "https://api.mb-suite.com/v1/seo/site-auditor/runs/{run_id}/issues/{issue_id}/tasks" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl -X POST "https://api.mb-suite.com/v1/seo/site-auditor/runs/{run_id}/issues/{issue_id}/tasks" \
  -H "Authorization: Bearer $MB_TEST_KEY"