Menú

Referencia de la API · SEO Planner

Templates de acción

seo_planner · action_templates · 8 operaciones

GET/v1/seo-planner/action-templates

List SEO action templates

seo_planner.action_templates.list

LecturaIdempotenteDesde 2026-11-01

Lists SEO action templates: a reusable action (name, subtitle, seo_type, description, icon, color and its sub-actions) to create planner actions (seo_planner.action_templates.apply) or build packs. source picks where from: all (default) = the organization's own, then its agency workspace's when the organization is an Account (read only), then the published templates of the MB Suite library; or org, parent, system. Paginated by cursor. Requires view access to the SEO Planner.

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

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

Parámetros

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.

sourceenumqueryopcional

all (default: the organization's, then its workspace's when it is an Account, then the published ones of the MB Suite library), org, parent or system.

Valores: all, org, parent, system · Por defecto: "all"

Respuesta

dataarray<object>

has_moreboolean

next_cursorstring

Errores

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/seo-planner/action-templates" \
  -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/action-templates" \
  -H "Authorization: Bearer $MB_TEST_KEY"

GET/v1/seo-planner/action-templates/{template_id}

Get one SEO action template

seo_planner.action_templates.get

LecturaIdempotenteDesde 2026-11-01

Returns one SEO action template. Without source it looks in the organization's templates, then its workspace's (for an Account) and then the published templates of the MB Suite library; drafts of the library do not exist for an organization. 404 seo_action_template_not_found otherwise. Requires view access to the SEO Planner.

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

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

Parámetros

template_idstringrutarequerido

The action template id (id of an item of seo_planner.action_templates.list).

sourceenumqueryopcional

Where to look: org, parent (the workspace of an Account) or system (the MB Suite library). Without it, in that order.

Valores: org, parent, system

Respuesta

idstring

namestring

The title the created action gets.

seo_typestring

Action type it creates.

sourceenum

org (editable), parent (the agency workspace's, read only) or system (the MB Suite library: copy it with seo_planner.action_templates.clone_system).

Valores: org, parent, system

subtitlestring | null

descriptionstring | null

icon_keystring | null

colorstring | null

sub_actionsarray<object>

The checklist the created action gets.

ordernumber

source_org_idstring | null

With source parent: the workspace the template belongs to.

created_by_idstring | null

Who created it (null or system for the library).

created_by_namestring | null

Their name, when it is a person.

created_atnumber

updated_atnumber

Errores

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/seo-planner/action-templates/{template_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 "https://api.mb-suite.com/v1/seo-planner/action-templates/{template_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

POST/v1/seo-planner/action-templates

Create an SEO action template

seo_planner.action_templates.create

EscrituraDesde 2026-11-01

Creates an action template at the end of the organization's list, owned by the caller: name, seo_type, optional subtitle, description, icon and color (default: those of the type) and sub_actions (ordered titles). Returns the template. Requires full access to the SEO Planner.

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

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

Parámetros

namestringcuerporequerido

The title the created actions get (1 to 200 characters).

seo_typeenumcuerporequerido

Their type.

Valores: blog_post, on_page_seo, speed_performance, technical_seo, website_audit, ai_geo, backlink, keyword_research, seo_analytics, international_seo, local_seo, setup_tools, competitor_analysis, link_audit, rank_tracking, client_report, custom

subtitlestringcuerpoopcional

Their subtitle.

descriptionstringcuerpoopcional

Their description.

icon_keystringcuerpoopcional

MDI icon name (default: the type's).

colorstringcuerpoopcional

Hex color (default: the type's).

sub_actionsarray<object>cuerpoopcional

The checklist the created actions get, in order.

Respuesta

template_idstring

templateobject

Errores

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo-planner/action-templates" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "seo_type": "blog_post"
}'

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/action-templates" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "seo_type": "blog_post"
}'

PATCH/v1/seo-planner/action-templates/{template_id}

Update an SEO action template

seo_planner.action_templates.update

EscrituraDesde 2026-11-01

Changes the name, subtitle, seo_type, description, icon, color or sub_actions (the whole ordered list) of one of the organization's action templates; templates of the workspace or the library cannot be edited from here. Planner actions already created from it are not touched. Unknown fields are rejected. Returns the template. Requires full access to the SEO Planner.

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

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

Parámetros

template_idstringrutarequerido

The id of one of the organization's own action templates (a workspace or library one cannot be edited: copy it first).

updatesobjectcuerporequerido

The fields to change (at least one).

Respuesta

templateobject

Errores

seo_action_template_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/seo-planner/action-templates/{template_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

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/action-templates/{template_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

DELETE/v1/seo-planner/action-templates/{template_id}

Delete an SEO action template

seo_planner.action_templates.delete

IrreversibleDesde 2026-11-01

Deletes one of the organization's action templates. It goes to the 30-day trash, where an owner or admin can restore it. Planner actions and packs built from it are not touched. 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_action_templates_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.action_templates.delete".

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

Parámetros

template_idstringrutarequerido

The id of one of the organization's own action templates (source org).

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_action_template_not_found delete_not_allowed confirmation_required invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/seo-planner/action-templates/{template_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/action-templates/{template_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

POST/v1/seo-planner/action-templates/{template_id}/duplicate

Duplicate an SEO action template

seo_planner.action_templates.duplicate

EscrituraDesde 2026-11-01

Copies one of the organization's action templates into a new one named '<name> (Copy)' (the suffix in the caller's language: '(Copia)', '(Copy)' or '(Cópia)') at the end of the list, owned by the caller. Returns the new template id. Requires full access to the SEO Planner.

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

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

Parámetros

template_idstringrutarequerido

The id of one of the organization's own action templates (source org).

Respuesta

template_idstring

Errores

seo_action_template_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo-planner/action-templates/{template_id}/duplicate" \
  -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 POST "https://api.mb-suite.com/v1/seo-planner/action-templates/{template_id}/duplicate" \
  -H "Authorization: Bearer $MB_TEST_KEY"

POST/v1/seo-planner/action-templates/system/{system_template_id}/clone

Copy a library action template into the organization

seo_planner.action_templates.clone_system

EscrituraDesde 2026-11-01

Copies a published action template of the MB Suite library (an id from seo_planner.action_templates.list with source system) into the organization so it can be edited. Drafts of the library cannot be copied (404 seo_action_template_not_found). Returns the new template id. Requires full access to the SEO Planner.

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

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

Parámetros

system_template_idstringrutarequerido

The id of a published library template (an item of seo_planner.action_templates.list with source system).

Respuesta

template_idstring

Errores

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo-planner/action-templates/system/{system_template_id}/clone" \
  -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 POST "https://api.mb-suite.com/v1/seo-planner/action-templates/system/{system_template_id}/clone" \
  -H "Authorization: Bearer $MB_TEST_KEY"

POST/v1/seo-planner/action-templates/{template_id}/apply

Create a planner action from an SEO action template

seo_planner.action_templates.apply

EscrituraDesde 2026-11-01

Creates one SEO Planner action from a template in the month month_key (YYYY-MM): pending, with the template's name as title, its subtitle, type, description and sub-actions (unticked), linked to the template (template_id). The template is read on the server (the organization's, its workspace's or a published library template; without source, in that order). Returns the new action. Requires full access to the SEO Planner.

Alcance: seo_planner:write
Permiso: Editar en el módulo
Tool del MCP: seo_planner_action_templates_applyEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.action_templates.apply".
Eventos que puede emitir: seo_planner.item.created

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

Parámetros

template_idstringrutarequerido

The action template id (id of an item of seo_planner.action_templates.list).

month_keystringcuerporequerido

The month of the new action (YYYY-MM).

sourceenumcuerpoopcional

Where to look: org, parent (the workspace of an Account) or system (the MB Suite library). Without it, in that order.

Valores: org, parent, system

Respuesta

item_idstring

itemobject

Errores

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo-planner/action-templates/{template_id}/apply" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "month_key": "MONTH_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 POST "https://api.mb-suite.com/v1/seo-planner/action-templates/{template_id}/apply" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "month_key": "MONTH_KEY"
}'