# Twitter Pinned Lists Blocks for managing pinned lists on Twitter/X. ## Twitter Get Pinned Lists ### What it is This block returns the Lists pinned by the authenticated user. ### How it works This block queries the Twitter API v2 to retrieve all Lists that the authenticated user has pinned for quick access. Pinned lists appear prominently in the user's Lists tab on Twitter. The block uses Tweepy with OAuth 2.0 authentication and supports expansions to include owner profile data and detailed list metadata. Returns list IDs, names, and complete list data objects. ### Inputs | Input | Description | Type | Required | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | -------- | | expansions | Choose what extra information you want to get with your Twitter Lists: - Select 'List\_Owner\_ID' to get details about who owns the list This will let you see more details about the list owner when you also select user fields below. | ListExpansionsFilter | No | | user\_fields | Choose what information you want to see about list owners. This only works when you select 'List\_Owner\_ID' in expansions above. You can see things like: - Their username - Profile picture - Account details - And more | TweetUserFieldsFilter | No | | list\_fields | Choose what information you want to see about the Twitter Lists themselves, such as: - List name - Description - Number of followers - Number of members - Whether it's private - Creation date - And more | ListFieldsFilter | No | ### Outputs | Output | Description | Type | | ----------- | ---------------------------------------- | ---------------------- | | error | Error message if the operation failed | str | | list\_ids | List IDs of the pinned lists | List\[str] | | list\_names | List names of the pinned lists | List\[str] | | data | Response data containing pinned lists | List\[Dict\[str, Any]] | | included | Additional data requested via expansions | Dict\[str, Any] | | meta | Metadata about the response | Dict\[str, Any] | ### Possible use case **Workflow Configuration**: Retrieve pinned lists to understand which lists are prioritized in user workflows. **Settings Backup**: Export pinned list configurations for backup or account migration purposes. **Dashboard Setup**: Identify pinned lists to build monitoring dashboards around priority content sources. *** ## Twitter Pin List ### What it is This block allows the authenticated user to pin a specified List. ### How it works This block uses the Twitter API v2 via Tweepy to pin a Twitter List for quick access. Pinned lists appear at the top of your Lists tab on Twitter for easy navigation. The block authenticates using OAuth 2.0 with list write permissions and sends a POST request to create the pin relationship. You can pin both your own lists and lists created by others. ### Inputs | Input | Description | Type | Required | | -------- | ------------------------- | ---- | -------- | | list\_id | The ID of the List to pin | str | Yes | ### Outputs | Output | Description | Type | | ------- | ------------------------------------- | ---- | | error | Error message if the operation failed | str | | success | Whether the pin was successful | bool | ### Possible use case **Priority Organization**: Pin important lists to ensure they're easily accessible for daily monitoring. **Workflow Setup**: Automatically pin newly created lists as part of project initialization workflows. **Quick Access Configuration**: Pin frequently used lists to streamline content discovery. *** ## Twitter Unpin List ### What it is This block allows the authenticated user to unpin a specified List. ### How it works This block uses the Twitter API v2 via Tweepy to unpin a Twitter List from your quick access area. The list remains followed but no longer appears in your pinned section. The block authenticates using OAuth 2.0 with list write permissions and sends a DELETE request to remove the pin relationship. Returns a success indicator confirming the list was unpinned. ### Inputs | Input | Description | Type | Required | | -------- | --------------------------- | ---- | -------- | | list\_id | The ID of the List to unpin | str | Yes | ### Outputs | Output | Description | Type | | ------- | ------------------------------------- | ---- | | error | Error message if the operation failed | str | | success | Whether the unpin was successful | bool | ### Possible use case **Pin Management**: Unpin lists that are no longer priorities to make room for more relevant ones. **Workflow Cleanup**: Remove pins from project-specific lists after campaigns or initiatives conclude. **Organization Maintenance**: Periodically unpin outdated lists to keep your pinned section focused. *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://agpt.co/docs/integrations/block-integrations/pinned_lists.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.