Checking authentication...

Comments

Manage comments on objects (items, tasks, status, etc.)

6 tools

Add Comment To Object

Write

POST /v1/tools/podio/addCommentToObject

Add a comment to a Podio object (item, task, or status). Requires type and object ID. IMPORTANT: To @mention users, you MUST first call getOrganizationMembers to get the numeric user_id, then use the format @[Full Name](user:user_id) in the value — e.g. @[Andrew Cranston](user:3105162). The user_id is REQUIRED — @mentions without a valid numeric user_id will silently fail. Never leave user_id empty. Use file_ids to attach files (numeric file IDs or https:// URLs — URLs are auto-uploaded and converted). Set silent: true to add without notifying followers.

Parameters

Name	Type	Required	Description
`type`	string	required	Object type (REQUIRED, used in URL path). Use "item" for item comments (most common), "task" for task comments, "status" for status comments. Values: item, task, status
`id`	number	required	Object ID (item_id, task_id, or status_id)
`value`	string	required	Comment text. Supports Podio markdown for @mentions. IMPORTANT: To @mention a user you MUST include a valid numeric user_id — call getOrganizationMembers first to look it up. Format: @[Full Name](user:user_id) e.g. "@[Andrew Cranston](user:3105162) please review this". Never use an empty user_id — the mention will break.
`file_ids`	array	optional	File IDs or URLs to attach. URLs (https://...) are auto-uploaded and converted to file IDs.
`embed_url`	string	optional	URL to embed
`silent`	boolean	optional	Suppress notifications
`alert_invite`	boolean	optional	Invite mentioned users to workspace
`hook`	boolean	optional	Execute hooks (default: true)
`external_id`	string	optional	External identifier

Request

curl -X POST https://api.syncello.io/v1/tools/podio/addCommentToObject \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "type": "item",
  "id": "123",
  "value": "example"
}'

Response

{
  "comment_id": 847291035,
  "created_by": {
    "user_id": 1122334,
    "name": "Jane Doe",
    "type": "user"
  },
  "created_on": "2026-07-01 14:32:58",
  "value": "Reviewed the proposal — moving to negotiation stage.",
  "rich_value": "Reviewed the proposal — moving to negotiation stage.",
  "files": [],
  "ref": {
    "type": "item",
    "id": 3141592653
  },
  "like_count": 0,
  "is_liked": false
}

Try It

Try it

Get Comment

Read Idempotent

POST /v1/tools/podio/getComment

Get a single comment by ID. Returns full comment details including text, created_by, and created_on. Use getCommentsOnObject to list all comments on an object first to find the comment_id.

Parameters

Name	Type	Required	Description
`comment_id`	number	required	Comment ID (use getCommentsOnObject to find it)

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getComment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "comment_id": "123"
}'

Response

{
  "comment_id": 847291035,
  "created_by": {
    "user_id": 1122334,
    "name": "Jane Doe",
    "type": "user"
  },
  "created_on": "2026-07-01 14:32:58",
  "value": "Reviewed the proposal — moving to negotiation stage.",
  "rich_value": "Reviewed the proposal — moving to negotiation stage.",
  "files": [],
  "ref": {
    "type": "item",
    "id": 3141592653
  },
  "like_count": 0,
  "is_liked": false
}

Try It

Try it

Get Comments On Object

Read Idempotent

POST /v1/tools/podio/getCommentsOnObject

List comments on an item, task, or status. Returns comment_id, value, created_by, and created_on. Default sort is "desc" (newest first) — the most common intent. Use sort="asc" for oldest-first pagination through the full history. In desc mode, offset + limit must be <= 100 (Podio only inlines the newest 100 comments on the parent object). For deeper history use sort="asc".

Parameters

Name	Type	Required	Description
`type`	string	required	Object type: "item" (most common), "task", or "status"
`id`	number	required	Object ID (item_id, task_id, or status_id depending on type)
`sort`	string	optional	"desc" (default) = newest first, capped at newest 100 comments. "asc" = oldest first, supports full pagination via limit/offset. Values: desc, asc
`limit`	number	optional	Max comments (default: 100)
`offset`	number	optional	Pagination offset

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getCommentsOnObject \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "type": "example",
  "id": "123"
}'

Response

[
  {
    "comment_id": 847291035,
    "created_by": {
      "user_id": 1122334,
      "name": "Jane Doe",
      "type": "user"
    },
    "created_on": "2026-07-01 14:32:58",
    "value": "Reviewed the proposal — moving to negotiation stage.",
    "rich_value": "Reviewed the proposal — moving to negotiation stage.",
    "files": [],
    "like_count": 0,
    "is_liked": false
  }
]

Try It

Try it

Get Comment Revisions

Read Idempotent

POST /v1/tools/podio/getCommentRevisions

Get edit history for a comment. Returns all previous versions of a comment (oldest first), each including the text and when it was created.

Parameters

Name	Type	Required	Description
`comment_id`	number	required	Comment ID

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getCommentRevisions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "comment_id": "123"
}'

Response

[
  {
    "created_on": "2026-07-01 14:32:58",
    "embed": null,
    "embed_file": null,
    "rich_value": "Reviewed the proposal — moving to negotiation stage.",
    "value": "Reviewed the proposal — moving to negotiation stage."
  }
]

Try It

Try it

Update Comment

Write

POST /v1/tools/podio/updateComment

Update a comment. Replaces the comment text entirely; previous versions are saved in revision history. Use getCommentRevisions to view edit history.

Parameters

Name	Type	Required	Description
`comment_id`	number	required	Comment ID
`value`	string	required	New comment text. Supports Podio markdown for @mentions. IMPORTANT: To @mention a user you MUST include a valid numeric user_id — call getOrganizationMembers first to look it up. Format: @[Full Name](user:user_id) e.g. "@[Andrew Cranston](user:3105162) please review this". Never use an empty user_id — the mention will break.
`file_ids`	array	optional	File IDs or URLs to attach. URLs (https://...) are auto-uploaded and converted to file IDs.
`embed_url`	string	optional	URL to embed
`external_id`	string	optional	External identifier

Request

curl -X POST https://api.syncello.io/v1/tools/podio/updateComment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "comment_id": "123",
  "value": "example"
}'

Response

{
  "updated": true,
  "comment_id": 847291035
}

Try It

Try it

Delete Comment

Destructive

POST /v1/tools/podio/deleteComment

Permanently delete a comment by ID. This cannot be undone. Use getCommentsOnObject to find the comment_id first.

Parameters

Name	Type	Required	Description
`comment_id`	number	required	Comment ID (use getCommentsOnObject to find it)
`hook`	boolean	optional	Execute hooks (default: true)

Request

curl -X POST https://api.syncello.io/v1/tools/podio/deleteComment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "comment_id": "123"
}'

Response

{
  "deleted": true,
  "comment_id": 847291035
}