MB SuiteMB Suite
Menú

Referencia de la API · Social Planner

Comentarios

social_planner · comments · 4 operaciones

GET/v1/social-planner/posts/{post_id}/commentsPOST/v1/social-planner/posts/{post_id}/commentsPATCH/v1/social-planner/posts/{post_id}/comments/{comment_id}DELETE/v1/social-planner/posts/{post_id}/comments/{comment_id}
GET/v1/social-planner/posts/{post_id}/comments

List the comments of a post

social_planner.comments.list

LecturaIdempotenteDesde 2026-11-01

Lists the internal comments and notes of a planner post, oldest first, paginated by cursor: content (sanitized HTML), author, mentioned member uids, and is_system for notes written by MIA (a content plan's editorial note). The client portal does not show these comments. Requires view access to the Social Planner.

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

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

Parámetros

post_idstringrutarequerido

The post id (from social_planner.posts.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

post_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/social-planner/posts/{post_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/social-planner/posts/{post_id}/comments" \
  -H "Authorization: Bearer $MB_TEST_KEY"
POST/v1/social-planner/posts/{post_id}/comments

Comment on a post

social_planner.comments.create

EscrituraDesde 2026-11-01

Adds an internal comment or note to a planner post (simple HTML or text, sanitized; up to 10,000 characters). mentions are member uids to notify (only members of this organization or of its agency workspace receive the notice); the post's author also gets a reply notice. Returns the comment. Requires full access to the Social Planner.

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

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

Parámetros

post_idstringrutarequerido

The post id (from social_planner.posts.list).

contentstringcuerporequerido

The comment: simple HTML (sanitized) or plain text, up to 10,000 characters. It is internal: it never goes to the networks.

mentionsarray<string>cuerpoopcional

Members to mention (user ids from members.members.list, up to 50): they get a notice.

Por defecto: []

Respuesta

comment_idstring
commentobject

Errores

post_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/social-planner/posts/{post_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/social-planner/posts/{post_id}/comments" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "content": "CONTENT"
}'
PATCH/v1/social-planner/posts/{post_id}/comments/{comment_id}

Edit a comment

social_planner.comments.update

EscrituraIdempotenteDesde 2026-11-01

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

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

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

Parámetros

post_idstringrutarequerido

The post id (from social_planner.posts.list).

comment_idstringrutarequerido

The comment id (from social_planner.comments.list).

contentstringcuerporequerido

The comment: simple HTML (sanitized) or plain text, up to 10,000 characters. It is internal: it never goes to the networks.

mentionsarray<string>cuerpoopcional

Members to mention (user ids from members.members.list, up to 50): they get a notice.

Por defecto: []

Respuesta

commentobject

Errores

post_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/social-planner/posts/{post_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/social-planner/posts/{post_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "CONTENT"
}'
DELETE/v1/social-planner/posts/{post_id}/comments/{comment_id}

Delete a comment

social_planner.comments.delete

IrreversibleDesde 2026-11-01

Deletes a comment of a planner post. 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 post). 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.

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
social_planner:write y «Permitir eliminar» (social_planner:delete en OAuth)
Permiso
Editar en el módulo
Tool del MCP
social_planner_comments_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "social_planner.comments.delete".

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

Parámetros

post_idstringrutarequerido

The post id (from social_planner.posts.list).

comment_idstringrutarequerido

The comment id (from social_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

post_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/social-planner/posts/{post_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/social-planner/posts/{post_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"