TweetSmash API

Use this skill to work directly with the TweetSmash REST API after verifying the current docs. Read references/api-reference.md before choosing an endpoint. Read references/bookmarks-filters.md only when bookmark filtering is required.

Procedures

Step 1: Validate Credentials and Scope

1. Confirm that a TweetSmash API key is available before making requests. Prefer TWEETSMASH_API_KEY in the shell environment.
2. Read references/api-reference.md to confirm the current endpoint, required headers, rate limits, and status codes.
3. If the task requires bookmark filtering or pagination, read references/bookmarks-filters.md.

Step 2: Build the Request

1. Use Authorization: Bearer $TWEETSMASH_API_KEY on every request.
2. Use Content-Type: application/json for all examples in this skill. Keep the base URL as https://api.tweetsmash.com/v1.
3. If the task fetches bookmarks with filters, execute python3 scripts/build-bookmarks-url.py with the needed flags to generate a correctly encoded URL.
4. If the task adds labels, start from assets/add-labels-body.json and fill in tweet_ids plus either label_id or label_name.
5. If the task removes labels, start from assets/remove-labels-body.json and fill in tweet_ids plus label_name.

Step 3: Execute the Correct Endpoint