MB SuiteMB Suite
Menú

Referencia de la API · SEO Planner

Comentarios

seo_planner · comments · 4 operaciones

GET/v1/seo-planner/items/{item_id}/commentsPOST/v1/seo-planner/items/{item_id}/commentsPATCH/v1/seo-planner/items/{item_id}/comments/{comment_id}DELETE/v1/seo-planner/items/{item_id}/comments/{comment_id}
GET/v1/seo-planner/items/{item_id}/comments

List the comments of an SEO planner action

seo_planner.comments.list

LecturaIdempotenteDesde 2026-11-01

Lists the internal comments of an SEO Planner action, oldest first, paginated by cursor: content (sanitized HTML), author and mentioned member uids. 404 seo_item_not_found if the action does not exist in this organization. Requires view access to the SEO Planner.

Alcance
seo_planner:read
Permiso
Ver el módulo
Tool del MCP
seo_planner_comments_listEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.comments.list".

Costo declarado: hasta 203 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

item_idstringrutarequerido

The action id (id of an item of seo_planner.items.list).

limitintegerqueryopcional

How many items this page brings at most (see the maximum and the default in the schema).

Por defecto: 50

cursorstringqueryopcional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

Respuesta

dataarray<object>
has_moreboolean
next_cursorstring

Errores

seo_item_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/seo-planner/items/{item_id}/comments" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/seo-planner/items/{item_id}/comments" \
  -H "Authorization: Bearer $MB_TEST_KEY"
POST/v1/seo-planner/items/{item_id}/comments

Comment on an SEO planner action

seo_planner.comments.create

EscrituraDesde 2026-11-01

Adds an internal comment to an SEO Planner action (simple HTML or text, sanitized; up to 10,000 characters) and bumps its comment_count. mentions are member uids to notify in the bell (only members of this organization or of its agency workspace receive the notice). The client portal does not show these comments. Returns the comment. Requires full access to the SEO Planner.

Alcance
seo_planner:write
Permiso
Editar en el módulo
Tool del MCP
seo_planner_comments_createEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.comments.create".

Costo declarado: hasta 3 lecturas y 2 escrituras por llamada (cuentan en el cupo diario).

Parámetros

item_idstringrutarequerido

The action id (id of an item of seo_planner.items.list).

contentstringcuerporequerido

The comment: plain text or simple HTML (it is sanitized), up to 10,000 characters.

mentionsarray<string>cuerpoopcional

Uids of members to mention (members of the organization or of its workspace: members.members.list); they get a notification in the bell.

Respuesta

comment_idstring
commentobject

Errores

seo_item_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo-planner/items/{item_id}/comments" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "content": "CONTENT"
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X POST "https://api.mb-suite.com/v1/seo-planner/items/{item_id}/comments" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "content": "CONTENT"
}'
PATCH/v1/seo-planner/items/{item_id}/comments/{comment_id}

Edit a comment of an SEO planner action

seo_planner.comments.update

EscrituraIdempotenteDesde 2026-11-01

Replaces the content (and mentions) of a comment on an SEO Planner action. Only its author can edit it (403 comment_author_only); only newly added mentions are notified. Returns the updated comment. Requires full access to the SEO Planner.

Alcance
seo_planner:write
Permiso
Editar en el módulo
Tool del MCP
seo_planner_comments_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.comments.update".

Costo declarado: hasta 4 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

item_idstringrutarequerido

The action id (id of an item of seo_planner.items.list).

comment_idstringrutarequerido

The comment id (id of an item of seo_planner.comments.list).

contentstringcuerporequerido

The comment: plain text or simple HTML (it is sanitized), up to 10,000 characters.

mentionsarray<string>cuerpoopcional

Uids of members to mention (members of the organization or of its workspace: members.members.list); they get a notification in the bell.

Respuesta

commentobject

Errores

seo_item_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/seo-planner/items/{item_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "CONTENT"
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X PATCH "https://api.mb-suite.com/v1/seo-planner/items/{item_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "CONTENT"
}'
DELETE/v1/seo-planner/items/{item_id}/comments/{comment_id}

Delete a comment of an SEO planner action

seo_planner.comments.delete

IrreversibleDesde 2026-11-01

Deletes a comment of an SEO Planner action and lowers its comment_count. Its author or an owner/admin of the organization can delete it (403 comment_delete_denied otherwise). It stays 30 days in the trash (platform.trash.restore brings it back to its action). Outside the app it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete. Requires full access to the SEO Planner.

Con una API key, este DELETE se ejecuta directo: el registro queda 30 días en la papelera y la respuesta trae su trash_item_id. Con un token OAuth, y por el MCP, pide dry_run → confirm_token.

Alcance
seo_planner:write y «Permitir eliminar» (seo_planner:delete en OAuth)
Permiso
Editar en el módulo
Tool del MCP
seo_planner_comments_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.comments.delete".

Costo declarado: hasta 2 lecturas y 2 escrituras por llamada (cuentan en el cupo diario).

Parámetros

item_idstringrutarequerido

The action id (id of an item of seo_planner.items.list).

comment_idstringrutarequerido

The comment id (id of an item of seo_planner.comments.list).

Respuesta

oktrue
trash_item_idstring

The trash item this deletion left: the item_id of platform.trash.restore (POST /trash/{item_id}/restore). Missing if nothing went to the trash.

trash_item_idsarray<string>

Only when the deletion left more than one copy: all of them, the first being trash_item_id.

trash_expires_atnumber

When the copy leaves the trash for good (epoch ms): 30 days after the deletion.

Errores

seo_item_not_founddelete_not_allowedconfirmation_requiredinvalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/seo-planner/items/{item_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X DELETE "https://api.mb-suite.com/v1/seo-planner/items/{item_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"