Skip to docs content
Browse and search
On this page

select_trial_accounts

During a trial, pick which saved X accounts the trial streams. Tier read: the API key alone. The MCP tool of the same name needs the tweetstream:watchlist scope.

POST/api/agent/actions/select_trial_accounts

Authorization

  • AuthorizationstringheaderrequiredBearer authentication with your TweetStream API key: Bearer <key>.

Body

  • twitterUserIdsstring[]requiredThe twitterUserIds (get_accounts, family BASE) the trial streams.

Response fields

  • outcomeenum<string>required
  • twitterUserIdsstring[]required

Responses

  • 200Success
  • 400The input does not match the action's schema (INVALID_REQUEST)
  • 401Missing or invalid API key
  • 403The request carried a foreign Origin
  • 429Rate limit reached (RATE_LIMITED); retry after retryAfterSeconds
  • 503Temporarily unavailable; retry later