Files
AutoGPT/docs/integrations/block-integrations/twitter/blocks.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

2.4 KiB

Twitter Blocks

Blocks for managing blocked users on Twitter/X.

Twitter Get Blocked Users

What it is

This block retrieves a list of users blocked by the authenticating user.

How it works

This block uses the Twitter API v2 via Tweepy to retrieve a paginated list of users that the authenticated account has blocked. It authenticates using OAuth 2.0 with the required scopes (users.read, block.read) and sends a request to Twitter's blocked users endpoint.

The response includes user IDs and usernames by default, with optional expansions to include additional data like pinned tweets. Pagination is supported through tokens, allowing retrieval of large block lists in batches of up to 1,000 users per request.

Inputs

Input Description Type Required
expansions Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. UserExpansionsFilter No
tweet_fields Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. TweetFieldsFilter No
user_fields Select what user information you want to see, like username, bio, profile picture, etc. TweetUserFieldsFilter No
max_results Maximum number of results to return (1-1000, default 100) int No
pagination_token Token for retrieving next/previous page of results str No

Outputs

Output Description Type
error Error message if the operation failed str
user_ids List of blocked user IDs List[str]
usernames_ List of blocked usernames List[str]
included Additional data requested via expansions Dict[str, Any]
meta Metadata including pagination info Dict[str, Any]
next_token Next token for pagination str

Possible use case

Block List Audit: Review your block list periodically to identify accounts you may want to unblock or to analyze blocking patterns.

Safety Monitoring: Track blocked accounts as part of a harassment monitoring workflow, documenting problematic accounts.

Account Migration: Export your block list when setting up a new account or for backup purposes.