Skip to content

docs: adapter README drift — threads text containers, instagram comments/refresh #59

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
deblasis merged 1 commit into from
Aug 17, 2026
+6 −2
Merged

docs: adapter README drift — threads text containers, instagram comments/refresh #59

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions adapters/instagram-style/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@ request is visible when publishing in the next, within the same `stunt up` sessi
| GET | `/oauth/authorize` | `oauth.star#on_authorize` | OAuth2 authorize → 302 redirect with single-use code |
| POST | `/oauth/access_token` | `oauth.star#on_access_token` | Exchange code for access token |
| GET | `/v21.0/me` | `profile.star#on_profile` | Authenticated user profile (Bearer) |
| GET | `/v21.0/refresh_access_token` | `oauth.star#on_refresh_token` | Long-lived token refresh (`grant_type=ig_refresh_token`; fresh 60-day token, old one valid until its own expiry) |
| GET | `/v21.0/{media_id}/comments` | `comments.star#on_comments` | Per-media comments (deterministic; `access_token` query param or Bearer; honors `since`) |
| GET | `/v21.0/{media_id}/insights` | `insights.star#on_insights` | Per-media insights metrics (honors `metric=`) |
| GET | `/v21.0/{container_id}` | `publish.star#on_container_status` | Container processing status: `status_code` = `IN_PROGRESS` → `FINISHED` (Bearer) |
| POST | `/v21.0/{ig_user_id}/media_publish` | `publish.star#on_publish` | Publish a media container (Bearer; gated on `FINISHED`) |
Expand Down
6 changes: 4 additions & 2 deletions adapters/threads-style/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,10 @@ analytics / engagement pipeline:
- **OAuth2 (Meta):** authorize redirect, access-token exchange (single-use code),
and `refresh_token` grant (single-use, rotating refresh tokens).
- **Profile:** `GET /v1.0/me`.
- **Publish (two-step):** create a media container, poll its processing
status until `finished`, then publish it.
- **Publish (two-step):** create a media container, then publish it. Text
containers finish processing immediately (real Threads only needs a
status poll for video/image uploads), so create → publish back-to-back
works with no poll; the `simulate_fail` flag still drives the error path.
- **Insights:** per-media metrics (views, likes, replies, reposts).
- **Engagement:** inbox ingest with synthetic reply children.

Expand Down
Loading