KosmoKrator

productivity

Twitter / X Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Twitter / X KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.x.*. Use lua_read_doc("integrations.x") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Twitter / X workflow without starting an interactive agent session.

Inline Lua call
kosmo integrations:lua --eval 'dump(app.integrations.x.get_account_activity_subscription_count({}))' --json
Read Lua docs headlessly
kosmo integrations:lua --eval 'print(docs.read("x"))' --json
kosmo integrations:lua --eval 'print(docs.read("x.get_account_activity_subscription_count"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua
local x = app.integrations.x
local result = x.get_account_activity_subscription_count({})

dump(result)
Run the workflow
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. integrations:lua exposes app.integrations.x, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.x.default.* or app.integrations.x.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Twitter / X, use the narrower mcp:lua command.

MCP Lua command
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Twitter / X — Lua API Reference

This integration is generated from the official X OpenAPI document version 2.162 and exposes 162 X API operations.

Authentication

Configure one or more credential modes:

  • bearer_token for app-only public reads.
  • access_token for OAuth 2.0 user-context operations.
  • api_key, api_secret, access_token, and access_token_secret for OAuth 1.0a user-context operations.

Each tool carries auth_modes, required_scopes, and runtime_mode metadata in the generated catalog.

Runtime Notes

  • Tools marked stream require a host streaming runner.
  • Tools marked webhook_subscription require a public callback endpoint.
  • Enterprise or approved-access endpoints return clear API errors if the configured X account lacks access.

Examples

local me = app.integrations.x.x_get_users_me({})
local user = app.integrations.x.x_get_users_by_username({ username = "XDevelopers" })

For multi-account hosts:

app.integrations.x.default.x_find_my_user({})
app.integrations.x.work.x_find_my_user({})
Raw agent markdown
# Twitter / X — Lua API Reference

This integration is generated from the official X OpenAPI document version `2.162` and exposes 162 X API operations.

## Authentication

Configure one or more credential modes:

- `bearer_token` for app-only public reads.
- `access_token` for OAuth 2.0 user-context operations.
- `api_key`, `api_secret`, `access_token`, and `access_token_secret` for OAuth 1.0a user-context operations.

Each tool carries `auth_modes`, `required_scopes`, and `runtime_mode` metadata in the generated catalog.

## Runtime Notes

- Tools marked `stream` require a host streaming runner.
- Tools marked `webhook_subscription` require a public callback endpoint.
- Enterprise or approved-access endpoints return clear API errors if the configured X account lacks access.

## Examples

```lua
local me = app.integrations.x.x_get_users_me({})
local user = app.integrations.x.x_get_users_by_username({ username = "XDevelopers" })
```

For multi-account hosts:

```lua
app.integrations.x.default.x_find_my_user({})
app.integrations.x.work.x_find_my_user({})
```
Metadata-derived Lua example
local result = app.integrations.x.get_account_activity_subscription_count({})
print(result)

Functions

get_account_activity_subscription_count Read

Get subscription count

Lua path
app.integrations.x.get_account_activity_subscription_count
Full name
x.x_get_account_activity_subscription_count
ParameterTypeRequiredDescription
No parameters.
validate_account_activity_subscription Read

Validate subscription

Lua path
app.integrations.x.validate_account_activity_subscription
Full name
x.x_validate_account_activity_subscription
ParameterTypeRequiredDescription
webhook_id string yes The webhook ID to check subscription against.
create_account_activity_subscription Write

Create subscription

Lua path
app.integrations.x.create_account_activity_subscription
Full name
x.x_create_account_activity_subscription
ParameterTypeRequiredDescription
webhook_id string yes The webhook ID to check subscription against.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_account_activity_subscriptions Read

Get subscriptions

Lua path
app.integrations.x.get_account_activity_subscriptions
Full name
x.x_get_account_activity_subscriptions
ParameterTypeRequiredDescription
webhook_id string yes The webhook ID to pull subscriptions for.
delete_account_activity_subscription Write

Delete subscription

Lua path
app.integrations.x.delete_account_activity_subscription
Full name
x.x_delete_account_activity_subscription
ParameterTypeRequiredDescription
webhook_id string yes The webhook ID to check subscription against.
user_id string yes User ID to unsubscribe from.
activity_stream Read

Activity Stream

Lua path
app.integrations.x.activity_stream
Full name
x.x_activity_stream
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Post labels will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp from which the Post labels will be provided.
delete_activity_subscriptions_by_ids Write

Delete X activity subscriptions by IDs

Lua path
app.integrations.x.delete_activity_subscriptions_by_ids
Full name
x.x_delete_activity_subscriptions_by_ids
ParameterTypeRequiredDescription
ids array yes Comma-separated list of subscription IDs to delete.
get_activity_subscriptions Read

Get X activity subscriptions

Lua path
app.integrations.x.get_activity_subscriptions
Full name
x.x_get_activity_subscriptions
ParameterTypeRequiredDescription
max_results integer no The maximum number of results to return per page.
pagination_token string no This parameter is used to get the next 'page' of results.
create_activity_subscription Write

Create X activity subscription

Lua path
app.integrations.x.create_activity_subscription
Full name
x.x_create_activity_subscription
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
delete_activity_subscription Write

Deletes X activity subscription

Lua path
app.integrations.x.delete_activity_subscription
Full name
x.x_delete_activity_subscription
ParameterTypeRequiredDescription
subscription_id string yes The ID of the subscription to delete.
update_activity_subscription Write

Update X activity subscription

Lua path
app.integrations.x.update_activity_subscription
Full name
x.x_update_activity_subscription
ParameterTypeRequiredDescription
subscription_id string yes The ID of the subscription to update.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_chat_conversations Read

Get Chat Conversations

Lua path
app.integrations.x.get_chat_conversations
Full name
x.x_get_chat_conversations
ParameterTypeRequiredDescription
max_results integer no Maximum number of conversations to return.
pagination_token string no Token for pagination to retrieve the next page of results.
chat_conversation.fields array no A comma separated list of ChatConversation fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
create_chat_conversation Write

Create Chat Group Conversation

Lua path
app.integrations.x.create_chat_conversation
Full name
x.x_create_chat_conversation
ParameterTypeRequiredDescription
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
initialize_chat_group Write

Initialize Chat Group

Lua path
app.integrations.x.initialize_chat_group
Full name
x.x_initialize_chat_group
ParameterTypeRequiredDescription
No parameters.
get_chat_conversation Read

Get Chat Conversation

Lua path
app.integrations.x.get_chat_conversation
Full name
x.x_get_chat_conversation
ParameterTypeRequiredDescription
id string yes The recipient's user ID for a 1:1 conversation, or a group conversation ID (prefixed with 'g').
max_results integer no Maximum number of message events to return.
pagination_token string no Token for pagination to retrieve the next page of results.
chat_message_event.fields array no A comma separated list of ChatMessageEvent fields to display.
initialize_chat_conversation_keys Write

Initialize Conversation Keys

Lua path
app.integrations.x.initialize_chat_conversation_keys
Full name
x.x_initialize_chat_conversation_keys
ParameterTypeRequiredDescription
id string yes The recipient's user ID for a 1:1 conversation, or a group conversation ID (prefixed with 'g').
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
add_chat_group_members Write

Add members to a Chat group conversation

Lua path
app.integrations.x.add_chat_group_members
Full name
x.x_add_chat_group_members
ParameterTypeRequiredDescription
id string yes The Chat group conversation ID.
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
send_chat_message Write

Send Chat Message

Lua path
app.integrations.x.send_chat_message
Full name
x.x_send_chat_message
ParameterTypeRequiredDescription
id string yes The recipient's user ID for a 1:1 conversation, or a group conversation ID (prefixed with 'g').
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
mark_chat_conversation_read Write

Mark Conversation as Read

Lua path
app.integrations.x.mark_chat_conversation_read
Full name
x.x_mark_chat_conversation_read
ParameterTypeRequiredDescription
id string yes The recipient's user ID for a 1:1 conversation, or a group conversation ID (prefixed with 'g').
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
send_chat_typing_indicator Write

Send Typing Indicator

Lua path
app.integrations.x.send_chat_typing_indicator
Full name
x.x_send_chat_typing_indicator
ParameterTypeRequiredDescription
id string yes The recipient's user ID for a 1:1 conversation, or a group conversation ID (prefixed with 'g').
chat_media_upload_initialize Write

Initialize Chat Media Upload

Lua path
app.integrations.x.chat_media_upload_initialize
Full name
x.x_chat_media_upload_initialize
ParameterTypeRequiredDescription
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
chat_media_upload_append Write

Append Chat Media Upload

Lua path
app.integrations.x.chat_media_upload_append
Full name
x.x_chat_media_upload_append
ParameterTypeRequiredDescription
id string yes The session/resume id from initialize.
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
chat_media_upload_finalize Write

Finalize Chat Media Upload

Lua path
app.integrations.x.chat_media_upload_finalize
Full name
x.x_chat_media_upload_finalize
ParameterTypeRequiredDescription
id string yes The session/resume id from initialize.
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
chat_media_download Read

Download Chat Media

Lua path
app.integrations.x.chat_media_download
Full name
x.x_chat_media_download
ParameterTypeRequiredDescription
id string yes The recipient's user ID for a 1:1 conversation, or a group conversation ID (prefixed with 'g').
media_hash_key string yes The media hash key returned from the upload initialize step.
search_communities Read

Search Communities

Lua path
app.integrations.x.search_communities
Full name
x.x_search_communities
ParameterTypeRequiredDescription
query string yes Query to search communities.
max_results integer no The maximum number of search results to be returned by a request.
next_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
pagination_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
community.fields array no A comma separated list of Community fields to display.
get_communities_by_id Read

Get Community by ID

Lua path
app.integrations.x.get_communities_by_id
Full name
x.x_get_communities_by_id
ParameterTypeRequiredDescription
id string yes The ID of the Community.
community.fields array no A comma separated list of Community fields to display.
get_compliance_jobs Read

Get Compliance Jobs

Lua path
app.integrations.x.get_compliance_jobs
Full name
x.x_get_compliance_jobs
ParameterTypeRequiredDescription
type string yes Type of Compliance Job to list.
status string no Status of Compliance Job to list.
compliance_job.fields array no A comma separated list of ComplianceJob fields to display.
create_compliance_jobs Write

Create Compliance Job

Lua path
app.integrations.x.create_compliance_jobs
Full name
x.x_create_compliance_jobs
ParameterTypeRequiredDescription
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
get_compliance_jobs_by_id Read

Get Compliance Job by ID

Lua path
app.integrations.x.get_compliance_jobs_by_id
Full name
x.x_get_compliance_jobs_by_id
ParameterTypeRequiredDescription
id string yes The ID of the Compliance Job to retrieve.
compliance_job.fields array no A comma separated list of ComplianceJob fields to display.
delete_connections_by_uuids Write

Terminate multiple connections

Lua path
app.integrations.x.delete_connections_by_uuids
Full name
x.x_delete_connections_by_uuids
ParameterTypeRequiredDescription
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
get_connection_history Read

Get Connection History

Lua path
app.integrations.x.get_connection_history
Full name
x.x_get_connection_history
ParameterTypeRequiredDescription
status string no Filter by connection status. Use 'active' for current connections, 'inactive' for historical/disconnected connections, or 'all' for both.
endpoints array no Filter by streaming endpoint. Specify one or more endpoint names to filter results.
max_results integer no The maximum number of results to return per page.
pagination_token string no Token for paginating through results. Use the value from 'next_token' in the previous response.
connection.fields array no A comma separated list of Connection fields to display.
delete_all_connections Write

Terminate all connections

Lua path
app.integrations.x.delete_all_connections
Full name
x.x_delete_all_connections
ParameterTypeRequiredDescription
No parameters.
delete_connections_by_endpoint Write

Terminate connections by endpoint

Lua path
app.integrations.x.delete_connections_by_endpoint
Full name
x.x_delete_connections_by_endpoint
ParameterTypeRequiredDescription
endpoint_id string yes The endpoint ID to terminate connections for.
create_direct_messages_conversation Write

Create DM conversation

Lua path
app.integrations.x.create_direct_messages_conversation
Full name
x.x_create_direct_messages_conversation
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
dm_conversations_media_download Read

Download DM Media

Lua path
app.integrations.x.dm_conversations_media_download
Full name
x.x_dm_conversations_media_download
ParameterTypeRequiredDescription
dm_id string yes The unique identifier of the Direct Message event containing the media.
media_id string yes The unique identifier of the media attached to the Direct Message.
resource_id string yes The resource identifier of the media file, including file extension (e.g. 'hVJQTwig.jpg').
get_direct_messages_events_by_participant_id Read

Get DM events for a DM conversation

Lua path
app.integrations.x.get_direct_messages_events_by_participant_id
Full name
x.x_get_direct_messages_events_by_participant_id
ParameterTypeRequiredDescription
participant_id string yes The ID of the participant user for the One to One DM conversation.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
event_types array no The set of event_types to include in the results.
dm_event.fields array no A comma separated list of DmEvent fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
user.fields array no A comma separated list of User fields to display.
tweet.fields array no A comma separated list of Tweet fields to display.
create_direct_messages_by_participant_id Write

Create DM message by participant ID

Lua path
app.integrations.x.create_direct_messages_by_participant_id
Full name
x.x_create_direct_messages_by_participant_id
ParameterTypeRequiredDescription
participant_id string yes The ID of the recipient user that will receive the DM.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
create_direct_messages_by_conversation_id Write

Create DM message by conversation ID

Lua path
app.integrations.x.create_direct_messages_by_conversation_id
Full name
x.x_create_direct_messages_by_conversation_id
ParameterTypeRequiredDescription
dm_conversation_id string yes The DM Conversation ID.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_direct_messages_events_by_conversation_id Read

Get DM events for a DM conversation

Lua path
app.integrations.x.get_direct_messages_events_by_conversation_id
Full name
x.x_get_direct_messages_events_by_conversation_id
ParameterTypeRequiredDescription
id string yes The DM conversation ID.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
event_types array no The set of event_types to include in the results.
dm_event.fields array no A comma separated list of DmEvent fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
user.fields array no A comma separated list of User fields to display.
tweet.fields array no A comma separated list of Tweet fields to display.
get_direct_messages_events Read

Get DM events

Lua path
app.integrations.x.get_direct_messages_events
Full name
x.x_get_direct_messages_events
ParameterTypeRequiredDescription
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
event_types array no The set of event_types to include in the results.
dm_event.fields array no A comma separated list of DmEvent fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
user.fields array no A comma separated list of User fields to display.
tweet.fields array no A comma separated list of Tweet fields to display.
delete_direct_messages_events Write

Delete DM event

Lua path
app.integrations.x.delete_direct_messages_events
Full name
x.x_delete_direct_messages_events
ParameterTypeRequiredDescription
event_id string yes The ID of the direct-message event to delete.
get_direct_messages_events_by_id Read

Get DM event by ID

Lua path
app.integrations.x.get_direct_messages_events_by_id
Full name
x.x_get_direct_messages_events_by_id
ParameterTypeRequiredDescription
event_id string yes dm event id.
dm_event.fields array no A comma separated list of DmEvent fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
user.fields array no A comma separated list of User fields to display.
tweet.fields array no A comma separated list of Tweet fields to display.
evaluate_community_notes Write

Evaluate a Community Note

Lua path
app.integrations.x.evaluate_community_notes
Full name
x.x_evaluate_community_notes
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_insights28_hr Read

Get 28-hour Post insights

Lua path
app.integrations.x.get_insights28_hr
Full name
x.x_get_insights28_hr
ParameterTypeRequiredDescription
tweet_ids array yes List of PostIds for 28hr metrics.
granularity string yes granularity of metrics response.
requested_metrics array yes request metrics for historical request.
engagement.fields array no A comma separated list of Engagement fields to display.
get_insights_historical Read

Get historical Post insights

Lua path
app.integrations.x.get_insights_historical
Full name
x.x_get_insights_historical
ParameterTypeRequiredDescription
tweet_ids array yes List of PostIds for historical metrics.
end_time string yes YYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
start_time string yes YYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
granularity string yes granularity of metrics response.
requested_metrics array yes request metrics for historical request.
engagement.fields array no A comma separated list of Engagement fields to display.
stream_likes_compliance Read

Stream Likes compliance data

Lua path
app.integrations.x.stream_likes_compliance
Full name
x.x_stream_likes_compliance
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Likes Compliance events will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp from which the Likes Compliance events will be provided.
stream_likes_firehose Read

Stream all Likes

Lua path
app.integrations.x.stream_likes_firehose
Full name
x.x_stream_likes_firehose
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp to which the Likes will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
like_with_tweet_author.fields array no A comma separated list of LikeWithTweetAuthor fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
user.fields array no A comma separated list of User fields to display.
tweet.fields array no A comma separated list of Tweet fields to display.
stream_likes_sample10 Read

Stream sampled Likes

Lua path
app.integrations.x.stream_likes_sample10
Full name
x.x_stream_likes_sample10
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp to which the Likes will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
like_with_tweet_author.fields array no A comma separated list of LikeWithTweetAuthor fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
user.fields array no A comma separated list of User fields to display.
tweet.fields array no A comma separated list of Tweet fields to display.
create_lists Write

Create List

Lua path
app.integrations.x.create_lists
Full name
x.x_create_lists
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
delete_lists Write

Delete List

Lua path
app.integrations.x.delete_lists
Full name
x.x_delete_lists
ParameterTypeRequiredDescription
id string yes The ID of the List to delete.
get_lists_by_id Read

Get List by ID

Lua path
app.integrations.x.get_lists_by_id
Full name
x.x_get_lists_by_id
ParameterTypeRequiredDescription
id string yes The ID of the List.
list.fields array no A comma separated list of List fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
update_lists Write

Update List

Lua path
app.integrations.x.update_lists
Full name
x.x_update_lists
ParameterTypeRequiredDescription
id string yes The ID of the List to modify.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_lists_followers Read

Get List followers

Lua path
app.integrations.x.get_lists_followers
Full name
x.x_get_lists_followers
ParameterTypeRequiredDescription
id string yes The ID of the List.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_lists_members Read

Get List members

Lua path
app.integrations.x.get_lists_members
Full name
x.x_get_lists_members
ParameterTypeRequiredDescription
id string yes The ID of the List.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
add_lists_member Write

Add List member

Lua path
app.integrations.x.add_lists_member
Full name
x.x_add_lists_member
ParameterTypeRequiredDescription
id string yes The ID of the List for which to add a member.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
remove_lists_member_by_user_id Write

Remove List member

Lua path
app.integrations.x.remove_lists_member_by_user_id
Full name
x.x_remove_lists_member_by_user_id
ParameterTypeRequiredDescription
id string yes The ID of the List to remove a member.
user_id string yes The ID of User that will be removed from the List.
get_lists_posts Read

Get List Posts

Lua path
app.integrations.x.get_lists_posts
Full name
x.x_get_lists_posts
ParameterTypeRequiredDescription
id string yes The ID of the List.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
get_media_by_media_keys Read

Get Media by media keys

Lua path
app.integrations.x.get_media_by_media_keys
Full name
x.x_get_media_by_media_keys
ParameterTypeRequiredDescription
media_keys array yes A comma separated list of Media Keys. Up to 100 are allowed in a single request.
media.fields array no A comma separated list of Media fields to display.
get_media_analytics Read

Get Media analytics

Lua path
app.integrations.x.get_media_analytics
Full name
x.x_get_media_analytics
ParameterTypeRequiredDescription
media_keys array yes A comma separated list of Media Keys. Up to 100 are allowed in a single request.
end_time string yes YYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
start_time string yes YYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
granularity string yes The granularity for the search counts results.
media_analytics.fields array no A comma separated list of MediaAnalytics fields to display.
create_media_metadata Write

Create Media metadata

Lua path
app.integrations.x.create_media_metadata
Full name
x.x_create_media_metadata
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
delete_media_subtitles Write

Delete Media subtitles

Lua path
app.integrations.x.delete_media_subtitles
Full name
x.x_delete_media_subtitles
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
create_media_subtitles Write

Create Media subtitles

Lua path
app.integrations.x.create_media_subtitles
Full name
x.x_create_media_subtitles
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_media_upload_status Read

Get Media upload status

Lua path
app.integrations.x.get_media_upload_status
Full name
x.x_get_media_upload_status
ParameterTypeRequiredDescription
media_id string yes Media id for the requested media upload status.
command string no The command for the media upload request.
media_upload Write

Upload media

Lua path
app.integrations.x.media_upload
Full name
x.x_media_upload
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
initialize_media_upload Write

Initialize media upload

Lua path
app.integrations.x.initialize_media_upload
Full name
x.x_initialize_media_upload
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
append_media_upload Write

Append Media upload

Lua path
app.integrations.x.append_media_upload
Full name
x.x_append_media_upload
ParameterTypeRequiredDescription
id string yes The media identifier for the media to perform the append operation.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
finalize_media_upload Write

Finalize Media upload

Lua path
app.integrations.x.finalize_media_upload
Full name
x.x_finalize_media_upload
ParameterTypeRequiredDescription
id string yes The media id of the targeted media to finalize.
get_media_by_media_key Read

Get Media by media key

Lua path
app.integrations.x.get_media_by_media_key
Full name
x.x_get_media_by_media_key
ParameterTypeRequiredDescription
media_key string yes A single Media Key.
media.fields array no A comma separated list of Media fields to display.
search_news Read

Search News

Lua path
app.integrations.x.search_news
Full name
x.x_search_news
ParameterTypeRequiredDescription
query string yes The search query.
max_results integer no The number of results to return.
max_age_hours integer no The maximum age of the News story to search for.
news.fields array no A comma separated list of News fields to display.
get_news Read

Get news stories by ID

Lua path
app.integrations.x.get_news
Full name
x.x_get_news
ParameterTypeRequiredDescription
id string yes The ID of the news story.
news.fields array no A comma separated list of News fields to display.
create_community_notes Write

Create a Community Note

Lua path
app.integrations.x.create_community_notes
Full name
x.x_create_community_notes
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
search_community_notes_written Read

Search for Community Notes Written

Lua path
app.integrations.x.search_community_notes_written
Full name
x.x_search_community_notes_written
ParameterTypeRequiredDescription
test_mode boolean yes If true, return the notes the caller wrote for the test. If false, return the notes the caller wrote on the product.
pagination_token string no Pagination token to get next set of posts eligible for notes.
max_results integer no Max results to return.
note.fields array no A comma separated list of Note fields to display.
search_eligible_posts Read

Search for Posts Eligible for Community Notes

Lua path
app.integrations.x.search_eligible_posts
Full name
x.x_search_eligible_posts
ParameterTypeRequiredDescription
test_mode boolean yes If true, return a list of posts that are for the test. If false, return a list of posts that the bots can write proposed notes on the product.
pagination_token string no Pagination token to get next set of posts eligible for notes.
max_results integer no Max results to return.
post_selection string no The selection of posts to return. Valid values are 'feed_size: [small|large|xl|xxl], feed_lang: [en|es|...|all]'. Default (if not specified) is 'feed_size: small, feed_lang: en'. Only top AI writers have access to large, xl, and xxl size feeds.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
delete_community_notes Write

Delete a Community Note

Lua path
app.integrations.x.delete_community_notes
Full name
x.x_delete_community_notes
ParameterTypeRequiredDescription
id string yes The community note id to delete.
get_open_api_spec Read

Get OpenAPI Spec.

Lua path
app.integrations.x.get_open_api_spec
Full name
x.x_get_open_api_spec
ParameterTypeRequiredDescription
No parameters.
get_spaces_by_ids Read

Get Spaces by IDs

Lua path
app.integrations.x.get_spaces_by_ids
Full name
x.x_get_spaces_by_ids
ParameterTypeRequiredDescription
ids array yes The list of Space IDs to return.
space.fields array no A comma separated list of Space fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
topic.fields array no A comma separated list of Topic fields to display.
get_spaces_by_creator_ids Read

Get Spaces by creator IDs

Lua path
app.integrations.x.get_spaces_by_creator_ids
Full name
x.x_get_spaces_by_creator_ids
ParameterTypeRequiredDescription
user_ids array yes The IDs of Users to search through.
space.fields array no A comma separated list of Space fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
topic.fields array no A comma separated list of Topic fields to display.
search_spaces Read

Search Spaces

Lua path
app.integrations.x.search_spaces
Full name
x.x_search_spaces
ParameterTypeRequiredDescription
query string yes The search query.
state string no The state of Spaces to search for.
max_results integer no The number of results to return.
space.fields array no A comma separated list of Space fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
topic.fields array no A comma separated list of Topic fields to display.
get_spaces_by_id Read

Get space by ID

Lua path
app.integrations.x.get_spaces_by_id
Full name
x.x_get_spaces_by_id
ParameterTypeRequiredDescription
id string yes The ID of the Space to be retrieved.
space.fields array no A comma separated list of Space fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
topic.fields array no A comma separated list of Topic fields to display.
get_spaces_buyers Read

Get Space ticket buyers

Lua path
app.integrations.x.get_spaces_buyers
Full name
x.x_get_spaces_buyers
ParameterTypeRequiredDescription
id string yes The ID of the Space to be retrieved.
pagination_token string no This parameter is used to get a specified 'page' of results.
max_results integer no The maximum number of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_spaces_posts Read

Get Space Posts

Lua path
app.integrations.x.get_spaces_posts
Full name
x.x_get_spaces_posts
ParameterTypeRequiredDescription
id string yes The ID of the Space to be retrieved.
max_results integer no The number of Posts to fetch from the provided space. If not provided, the value will default to the maximum of 100.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
get_posts_by_ids Read

Get Posts by IDs

Lua path
app.integrations.x.get_posts_by_ids
Full name
x.x_get_posts_by_ids
ParameterTypeRequiredDescription
ids array yes A comma separated list of Post IDs. Up to 100 are allowed in a single request.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
create_posts Write

Create or Edit Post

Lua path
app.integrations.x.create_posts
Full name
x.x_create_posts
ParameterTypeRequiredDescription
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
get_posts_analytics Read

Get Post analytics

Lua path
app.integrations.x.get_posts_analytics
Full name
x.x_get_posts_analytics
ParameterTypeRequiredDescription
ids array yes A comma separated list of Post IDs. Up to 100 are allowed in a single request.
end_time string yes YYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
start_time string yes YYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
granularity string yes The granularity for the search counts results.
analytics.fields array no A comma separated list of Analytics fields to display.
stream_posts_compliance Read

Stream Posts compliance data

Lua path
app.integrations.x.stream_posts_compliance
Full name
x.x_stream_posts_compliance
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Post Compliance events will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Post Compliance events will be provided.
get_posts_counts_all Read

Get count of all Posts

Lua path
app.integrations.x.get_posts_counts_all
Full name
x.x_get_posts_counts_all
ParameterTypeRequiredDescription
query string yes One query/rule/filter for matching Posts. Refer to https://t.co/rulelength to identify the max query length.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp from which the Posts will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).
end_time string no YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Posts will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).
since_id string no Returns results with a Post ID greater than (that is, more recent than) the specified ID.
until_id string no Returns results with a Post ID less than (that is, older than) the specified ID.
next_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
pagination_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
granularity string no The granularity for the search counts results.
search_count.fields array no A comma separated list of SearchCount fields to display.
get_posts_counts_recent Read

Get count of recent Posts

Lua path
app.integrations.x.get_posts_counts_recent
Full name
x.x_get_posts_counts_recent
ParameterTypeRequiredDescription
query string yes One query/rule/filter for matching Posts. Refer to https://t.co/rulelength to identify the max query length.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp (from most recent 7 days) from which the Posts will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).
end_time string no YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Posts will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).
since_id string no Returns results with a Post ID greater than (that is, more recent than) the specified ID.
until_id string no Returns results with a Post ID less than (that is, older than) the specified ID.
next_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
pagination_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
granularity string no The granularity for the search counts results.
search_count.fields array no A comma separated list of SearchCount fields to display.
stream_posts_firehose Read

Stream all Posts

Lua path
app.integrations.x.stream_posts_firehose
Full name
x.x_stream_posts_firehose
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp to which the Posts will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
stream_posts_firehose_en Read

Stream English Posts

Lua path
app.integrations.x.stream_posts_firehose_en
Full name
x.x_stream_posts_firehose_en
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp to which the Posts will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
stream_posts_firehose_ja Read

Stream Japanese Posts

Lua path
app.integrations.x.stream_posts_firehose_ja
Full name
x.x_stream_posts_firehose_ja
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp to which the Posts will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
stream_posts_firehose_ko Read

Stream Korean Posts

Lua path
app.integrations.x.stream_posts_firehose_ko
Full name
x.x_stream_posts_firehose_ko
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp to which the Posts will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
stream_posts_firehose_pt Read

Stream Portuguese Posts

Lua path
app.integrations.x.stream_posts_firehose_pt
Full name
x.x_stream_posts_firehose_pt
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp to which the Posts will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
stream_labels_compliance Read

Stream Post labels

Lua path
app.integrations.x.stream_labels_compliance
Full name
x.x_stream_labels_compliance
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Post labels will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp from which the Post labels will be provided.
stream_posts_sample Read

Stream sampled Posts

Lua path
app.integrations.x.stream_posts_sample
Full name
x.x_stream_posts_sample
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
stream_posts_sample10 Read

Stream 10% sampled Posts

Lua path
app.integrations.x.stream_posts_sample10
Full name
x.x_stream_posts_sample10
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp to which the Posts will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
search_posts_all Read

Search all Posts

Lua path
app.integrations.x.search_posts_all
Full name
x.x_search_posts_all
ParameterTypeRequiredDescription
query string yes One query/rule/filter for matching Posts. Refer to https://t.co/rulelength to identify the max query length.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp from which the Posts will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).
end_time string no YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Posts will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).
since_id string no Returns results with a Post ID greater than (that is, more recent than) the specified ID.
until_id string no Returns results with a Post ID less than (that is, older than) the specified ID.
max_results integer no The maximum number of search results to be returned by a request.
next_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
pagination_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
sort_order string no This order in which to return results.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
search_posts_recent Read

Search recent Posts

Lua path
app.integrations.x.search_posts_recent
Full name
x.x_search_posts_recent
ParameterTypeRequiredDescription
query string yes One query/rule/filter for matching Posts. Refer to https://t.co/rulelength to identify the max query length.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp from which the Posts will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).
end_time string no YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Posts will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).
since_id string no Returns results with a Post ID greater than (that is, more recent than) the specified ID.
until_id string no Returns results with a Post ID less than (that is, older than) the specified ID.
max_results integer no The maximum number of search results to be returned by a request.
next_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
pagination_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
sort_order string no This order in which to return results.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
stream_posts Read

Stream filtered Posts

Lua path
app.integrations.x.stream_posts
Full name
x.x_stream_posts
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Posts will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
get_rules Read

Get stream rules

Lua path
app.integrations.x.get_rules
Full name
x.x_get_rules
ParameterTypeRequiredDescription
ids array no A comma-separated list of Rule IDs.
max_results integer no The maximum number of results.
pagination_token string no This value is populated by passing the 'next_token' returned in a request to paginate through results.
update_rules Write

Update stream rules

Lua path
app.integrations.x.update_rules
Full name
x.x_update_rules
ParameterTypeRequiredDescription
dry_run boolean no Dry Run can be used with both the add and delete action, with the expected result given, but without actually taking any action in the system (meaning the end state will always be as it was when the request was submitted). This is particularly useful to validate rule changes.
delete_all boolean no Delete All can be used to delete all of the rules associated this client app, it should be specified with no other parameters. Once deleted, rules cannot be recovered.
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
get_rule_counts Read

Get stream rule counts

Lua path
app.integrations.x.get_rule_counts
Full name
x.x_get_rule_counts
ParameterTypeRequiredDescription
rules_count.fields array no A comma separated list of RulesCount fields to display.
delete_posts Write

Delete Post

Lua path
app.integrations.x.delete_posts
Full name
x.x_delete_posts
ParameterTypeRequiredDescription
id string yes The ID of the Post to be deleted.
get_posts_by_id Read

Get Post by ID

Lua path
app.integrations.x.get_posts_by_id
Full name
x.x_get_posts_by_id
ParameterTypeRequiredDescription
id string yes A single Post ID.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
get_posts_liking_users Read

Get Liking Users

Lua path
app.integrations.x.get_posts_liking_users
Full name
x.x_get_posts_liking_users
ParameterTypeRequiredDescription
id string yes A single Post ID.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_posts_quoted_posts Read

Get Quoted Posts

Lua path
app.integrations.x.get_posts_quoted_posts
Full name
x.x_get_posts_quoted_posts
ParameterTypeRequiredDescription
id string yes A single Post ID.
max_results integer no The maximum number of results to be returned.
pagination_token string no This parameter is used to get a specified 'page' of results.
exclude array no The set of entities to exclude (e.g. 'replies' or 'retweets').
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
get_posts_reposted_by Read

Get Reposted by

Lua path
app.integrations.x.get_posts_reposted_by
Full name
x.x_get_posts_reposted_by
ParameterTypeRequiredDescription
id string yes A single Post ID.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_posts_reposts Read

Get Reposts

Lua path
app.integrations.x.get_posts_reposts
Full name
x.x_get_posts_reposts
ParameterTypeRequiredDescription
id string yes A single Post ID.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
hide_posts_reply Write

Hide reply

Lua path
app.integrations.x.hide_posts_reply
Full name
x.x_hide_posts_reply
ParameterTypeRequiredDescription
tweet_id string yes The ID of the reply that you want to hide or unhide.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_usage Read

Get usage

Lua path
app.integrations.x.get_usage
Full name
x.x_get_usage
ParameterTypeRequiredDescription
days integer no The number of days for which you need usage for.
usage.fields array no A comma separated list of Usage fields to display.
get_users_by_ids Read

Get Users by IDs

Lua path
app.integrations.x.get_users_by_ids
Full name
x.x_get_users_by_ids
ParameterTypeRequiredDescription
ids array yes A list of User IDs, comma-separated. You can specify up to 100 IDs.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_users_by_usernames Read

Get Users by usernames

Lua path
app.integrations.x.get_users_by_usernames
Full name
x.x_get_users_by_usernames
ParameterTypeRequiredDescription
usernames array yes A list of usernames, comma-separated.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_users_by_username Read

Get User by username

Lua path
app.integrations.x.get_users_by_username
Full name
x.x_get_users_by_username
ParameterTypeRequiredDescription
username string yes A username.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
stream_users_compliance Read

Stream Users compliance data

Lua path
app.integrations.x.stream_users_compliance
Full name
x.x_stream_users_compliance
ParameterTypeRequiredDescription
backfill_minutes integer no The number of minutes of backfill requested.
partition integer yes The partition number.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the User Compliance events will be provided.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp from which the User Compliance events will be provided.
get_users_me Read

Get my User

Lua path
app.integrations.x.get_users_me
Full name
x.x_get_users_me
ParameterTypeRequiredDescription
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_users_public_keys Read

Get public keys for multiple users

Lua path
app.integrations.x.get_users_public_keys
Full name
x.x_get_users_public_keys
ParameterTypeRequiredDescription
ids array yes A list of User IDs, comma-separated. You can specify up to 100 IDs.
public_key.fields array no A comma separated list of PublicKey fields to display.
get_users_reposts_me Read

Get Reposts of me

Lua path
app.integrations.x.get_users_reposts_me
Full name
x.x_get_users_reposts_of_me
ParameterTypeRequiredDescription
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
search_users Read

Search Users

Lua path
app.integrations.x.search_users
Full name
x.x_search_users
ParameterTypeRequiredDescription
query string yes TThe the query string by which to query for users.
max_results integer no The maximum number of results.
next_token string no This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_users_by_id Read

Get User by ID

Lua path
app.integrations.x.get_users_by_id
Full name
x.x_get_users_by_id
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_users_affiliates Read

Get affiliates

Lua path
app.integrations.x.get_users_affiliates
Full name
x.x_get_users_affiliates
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_users_blocking Read

Get blocking

Lua path
app.integrations.x.get_users_blocking
Full name
x.x_get_users_blocking
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User for whom to return results.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_users_bookmarks Read

Get Bookmarks

Lua path
app.integrations.x.get_users_bookmarks
Full name
x.x_get_users_bookmarks
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User for whom to return results.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
create_users_bookmark Write

Create Bookmark

Lua path
app.integrations.x.create_users_bookmark
Full name
x.x_create_users_bookmark
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User for whom to add bookmarks.
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
get_users_bookmark_folders Read

Get Bookmark folders

Lua path
app.integrations.x.get_users_bookmark_folders
Full name
x.x_get_users_bookmark_folders
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User for whom to return results.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
get_users_bookmarks_by_folder_id Read

Get Bookmarks by folder ID

Lua path
app.integrations.x.get_users_bookmarks_by_folder_id
Full name
x.x_get_users_bookmarks_by_folder_id
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User for whom to return results.
folder_id string yes The ID of the Bookmark Folder that the authenticated User is trying to fetch Posts for.
delete_users_bookmark Write

Delete Bookmark

Lua path
app.integrations.x.delete_users_bookmark
Full name
x.x_delete_users_bookmark
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User whose bookmark is to be removed.
tweet_id string yes The ID of the Post that the source User is removing from bookmarks.
block_users_dms Write

Block DMs

Lua path
app.integrations.x.block_users_dms
Full name
x.x_block_users_dms
ParameterTypeRequiredDescription
id string yes The ID of the target User that the authenticated user requesting to block dms for.
unblock_users_dms Write

Unblock DMs

Lua path
app.integrations.x.unblock_users_dms
Full name
x.x_unblock_users_dms
ParameterTypeRequiredDescription
id string yes The ID of the target User that the authenticated user requesting to unblock dms for.
get_users_followed_lists Read

Get followed Lists

Lua path
app.integrations.x.get_users_followed_lists
Full name
x.x_get_users_followed_lists
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
list.fields array no A comma separated list of List fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
follow_list Write

Follow List

Lua path
app.integrations.x.follow_list
Full name
x.x_follow_list
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that will follow the List.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
unfollow_list Write

Unfollow List

Lua path
app.integrations.x.unfollow_list
Full name
x.x_unfollow_list
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that will unfollow the List.
list_id string yes The ID of the List to unfollow.
get_users_followers Read

Get followers

Lua path
app.integrations.x.get_users_followers
Full name
x.x_get_users_followers
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
get_users_following Read

Get following

Lua path
app.integrations.x.get_users_following
Full name
x.x_get_users_following
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
follow_user Write

Follow User

Lua path
app.integrations.x.follow_user
Full name
x.x_follow_user
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that is requesting to follow the target User.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_users_liked_posts Read

Get liked Posts

Lua path
app.integrations.x.get_users_liked_posts
Full name
x.x_get_users_liked_posts
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
like_post Write

Like Post

Lua path
app.integrations.x.like_post
Full name
x.x_like_post
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that is requesting to like the Post.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
unlike_post Write

Unlike Post

Lua path
app.integrations.x.unlike_post
Full name
x.x_unlike_post
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that is requesting to unlike the Post.
tweet_id string yes The ID of the Post that the User is requesting to unlike.
get_users_list_memberships Read

Get List memberships

Lua path
app.integrations.x.get_users_list_memberships
Full name
x.x_get_users_list_memberships
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
list.fields array no A comma separated list of List fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
get_users_mentions Read

Get mentions

Lua path
app.integrations.x.get_users_mentions
Full name
x.x_get_users_mentions
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
since_id string no The minimum Post ID to be included in the result set. This parameter takes precedence over start_time if both are specified.
until_id string no The maximum Post ID to be included in the result set. This parameter takes precedence over end_time if both are specified.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Posts will be provided. The since_id parameter takes precedence if it is also specified.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided. The until_id parameter takes precedence if it is also specified.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
get_users_muting Read

Get muting

Lua path
app.integrations.x.get_users_muting
Full name
x.x_get_users_muting
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User for whom to return results.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
user.fields array no A comma separated list of User fields to display.
expansions array no A comma separated list of fields to expand.
tweet.fields array no A comma separated list of Tweet fields to display.
mute_user Write

Mute User

Lua path
app.integrations.x.mute_user
Full name
x.x_mute_user
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that is requesting to mute the target User.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
get_users_owned_lists Read

Get owned Lists

Lua path
app.integrations.x.get_users_owned_lists
Full name
x.x_get_users_owned_lists
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get a specified 'page' of results.
list.fields array no A comma separated list of List fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
get_users_pinned_lists Read

Get pinned Lists

Lua path
app.integrations.x.get_users_pinned_lists
Full name
x.x_get_users_pinned_lists
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User for whom to return results.
list.fields array no A comma separated list of List fields to display.
expansions array no A comma separated list of fields to expand.
user.fields array no A comma separated list of User fields to display.
pin_list Write

Pin List

Lua path
app.integrations.x.pin_list
Full name
x.x_pin_list
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that will pin the List.
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
unpin_list Write

Unpin List

Lua path
app.integrations.x.unpin_list
Full name
x.x_unpin_list
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User for whom to return results.
list_id string yes The ID of the List to unpin.
get_users_public_key Read

Get user public keys

Lua path
app.integrations.x.get_users_public_key
Full name
x.x_get_users_public_key
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
public_key.fields array no A comma separated list of PublicKey fields to display.
add_user_public_key Write

Add public key

Lua path
app.integrations.x.add_user_public_key
Full name
x.x_add_user_public_key
ParameterTypeRequiredDescription
id string yes The ID of the requesting user.
body object yes Request body for this X API operation. Use the shape documented by the official operation schema.
repost_post Write

Repost Post

Lua path
app.integrations.x.repost_post
Full name
x.x_repost_post
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that is requesting to repost the Post.
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
unrepost_post Write

Unrepost Post

Lua path
app.integrations.x.unrepost_post
Full name
x.x_unrepost_post
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User that is requesting to repost the Post.
source_tweet_id string yes The ID of the Post that the User is requesting to unretweet.
get_users_timeline Read

Get Timeline

Lua path
app.integrations.x.get_users_timeline
Full name
x.x_get_users_timeline
ParameterTypeRequiredDescription
id string yes The ID of the authenticated source User to list Reverse Chronological Timeline Posts of.
since_id string no The minimum Post ID to be included in the result set. This parameter takes precedence over start_time if both are specified.
until_id string no The maximum Post ID to be included in the result set. This parameter takes precedence over end_time if both are specified.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
exclude array no The set of entities to exclude (e.g. 'replies' or 'retweets').
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Posts will be provided. The since_id parameter takes precedence if it is also specified.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided. The until_id parameter takes precedence if it is also specified.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
get_users_posts Read

Get Posts

Lua path
app.integrations.x.get_users_posts
Full name
x.x_get_users_posts
ParameterTypeRequiredDescription
id string yes The ID of the User to lookup.
since_id string no The minimum Post ID to be included in the result set. This parameter takes precedence over start_time if both are specified.
until_id string no The maximum Post ID to be included in the result set. This parameter takes precedence over end_time if both are specified.
max_results integer no The maximum number of results.
pagination_token string no This parameter is used to get the next 'page' of results.
exclude array no The set of entities to exclude (e.g. 'replies' or 'retweets').
start_time string no YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Posts will be provided. The since_id parameter takes precedence if it is also specified.
end_time string no YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Posts will be provided. The until_id parameter takes precedence if it is also specified.
tweet.fields array no A comma separated list of Tweet fields to display.
expansions array no A comma separated list of fields to expand.
media.fields array no A comma separated list of Media fields to display.
poll.fields array no A comma separated list of Poll fields to display.
user.fields array no A comma separated list of User fields to display.
place.fields array no A comma separated list of Place fields to display.
unfollow_user Write

Unfollow User

Lua path
app.integrations.x.unfollow_user
Full name
x.x_unfollow_user
ParameterTypeRequiredDescription
source_user_id string yes The ID of the authenticated source User that is requesting to unfollow the target User.
target_user_id string yes The ID of the User that the source User is requesting to unfollow.
unmute_user Write

Unmute User

Lua path
app.integrations.x.unmute_user
Full name
x.x_unmute_user
ParameterTypeRequiredDescription
source_user_id string yes The ID of the authenticated source User that is requesting to unmute the target User.
target_user_id string yes The ID of the User that the source User is requesting to unmute.
get_webhooks Read

Get webhook

Lua path
app.integrations.x.get_webhooks
Full name
x.x_get_webhooks
ParameterTypeRequiredDescription
webhook_config.fields array no A comma separated list of WebhookConfig fields to display.
create_webhooks Write

Create webhook

Lua path
app.integrations.x.create_webhooks
Full name
x.x_create_webhooks
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
create_webhook_replay_job Write

Create replay job for webhook

Lua path
app.integrations.x.create_webhook_replay_job
Full name
x.x_create_webhook_replay_job
ParameterTypeRequiredDescription
body object no Request body for this X API operation. Use the shape documented by the official operation schema.
delete_webhooks Write

Delete webhook

Lua path
app.integrations.x.delete_webhooks
Full name
x.x_delete_webhooks
ParameterTypeRequiredDescription
webhook_id string yes The ID of the webhook to delete.
validate_webhooks Write

Validate webhook

Lua path
app.integrations.x.validate_webhooks
Full name
x.x_validate_webhooks
ParameterTypeRequiredDescription
webhook_id string yes The ID of the webhook to check.