Files
AutoGPT/docs/integrations/block-integrations/todoist/comments.md
Nicholas Tindle 90466908a8 refactor(docs): restructure platform docs for GitBook and remove MkDo… (#11825)
<!-- Clearly explain the need for these changes: -->
we met some reality when merging into the docs site but this fixes it
### Changes 🏗️
updates paths, adds some guides
<!-- Concisely describe all of the changes made in this pull request:
-->
update to match reality
### Checklist 📋

#### For code changes:
- [x] I have clearly listed my changes in the PR description
- [x] I have made a test plan
- [x] I have tested my changes according to the test plan:
  <!-- Put your test plan here: -->
  - [x] deploy it and validate

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Aligns block integrations documentation with GitBook.
> 
> - Changes generator default output to
`docs/integrations/block-integrations` and writes overview `README.md`
and `SUMMARY.md` at `docs/integrations/`
> - Adds GitBook frontmatter and hint syntax to overview; prefixes block
links with `block-integrations/`
> - Introduces `generate_summary_md` to build GitBook navigation
(including optional `guides/`)
> - Preserves per-block manual sections and adds optional `extras` +
file-level `additional_content`
> - Updates sync checker to validate parent `README.md` and `SUMMARY.md`
> - Rewrites `docs/integrations/README.md` with GitBook frontmatter and
updated links; adds `docs/integrations/SUMMARY.md`
> - Adds new guides: `guides/llm-providers.md`,
`guides/voice-providers.md`
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
fdb7ff8111. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: bobby.gaffin <bobby.gaffin@agpt.co>
2026-01-23 06:18:16 +00:00

4.0 KiB

Todoist Comments

Blocks for creating and managing comments on Todoist tasks and projects.

Todoist Create Comment

What it is

Creates a new comment on a Todoist task or project

How it works

Takes comment content and task/project ID, creates comment via Todoist API.

Inputs

Input Description Type Required
content Comment content str Yes
id_type Specify either task_id or project_id to comment on Id Type No
attachment Optional file attachment Dict[str, Any] No

Outputs

Output Description Type
error Error message if the operation failed str
id ID of created comment str
content Comment content str
posted_at Comment timestamp str
task_id Associated task ID str
project_id Associated project ID str

Possible use case

Adding notes and comments to tasks or projects automatically.


Todoist Delete Comment

What it is

Deletes a Todoist comment

How it works

Uses comment ID to delete via Todoist API.

Inputs

Input Description Type Required
comment_id Comment ID to delete str Yes

Outputs

Output Description Type
error Error message if the operation failed str
success Whether the deletion was successful bool

Possible use case

Removing outdated or incorrect comments from tasks/projects.


Todoist Get Comment

What it is

Get a single comment from Todoist

How it works

Uses comment ID to retrieve details via Todoist API.

Inputs

Input Description Type Required
comment_id Comment ID to retrieve str Yes

Outputs

Output Description Type
error Error message if the operation failed str
content Comment content str
id Comment ID str
posted_at Comment timestamp str
project_id Associated project ID str
task_id Associated task ID str
attachment Optional file attachment Dict[str, Any]

Possible use case

Looking up specific comment details for reference.


Todoist Get Comments

What it is

Get all comments for a Todoist task or project

How it works

Uses task/project ID to get comments list via Todoist API.

Inputs

Input Description Type Required
id_type Specify either task_id or project_id to get comments for Id Type No

Outputs

Output Description Type
error Error message if the operation failed str
comments List of comments List[Any]

Possible use case

Reviewing comment history on tasks or projects.


Todoist Update Comment

What it is

Updates a Todoist comment

How it works

Takes comment ID and new content, updates via Todoist API.

Inputs

Input Description Type Required
comment_id Comment ID to update str Yes
content New content for the comment str Yes

Outputs

Output Description Type
error Error message if the operation failed str
success Whether the update was successful bool

Possible use case

Modifying existing comments to fix errors or update information.