From e640a0eedb55d7c565b2263509084224c978b7c4 Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Mon, 17 Aug 2026 04:41:01 +0300 Subject: [PATCH] docs: threads instant text containers + instagram comments/refresh in adapter READMEs --- adapters/instagram-style/README.md | 2 ++ adapters/threads-style/README.md | 6 ++++-- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/adapters/instagram-style/README.md b/adapters/instagram-style/README.md index 2f798120..b8cc7067 100644 --- a/adapters/instagram-style/README.md +++ b/adapters/instagram-style/README.md @@ -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`) | diff --git a/adapters/threads-style/README.md b/adapters/threads-style/README.md index 679edfae..c8605988 100644 --- a/adapters/threads-style/README.md +++ b/adapters/threads-style/README.md @@ -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.