---
title: "Request Instagram token refresh"
method: POST
path: "/channels/{channelId}/refresh-token"
tags: ["Channels"]
---

# Request Instagram token refresh

`POST /channels/{channelId}/refresh-token`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/channels/{channelId}/refresh-token`
- Auth: HTTP bearer

Use only for a requested refresh on a discovered Instagram channel. Reuses the existing guarded queue request and returns queued or skipped with reason; it does not prove refresh completion. Read get_channel later for tokenLastRefreshedAt/status or error code. Expired/rejected credentials may require human reconnection through a temporary link. Do not repeatedly queue refresh work or collect provider tokens in chat. Requires `channels:manage:write`.

## Path parameters

- `channelId` string, required

## Response `200`

Request Instagram token refresh

- ChannelTokenRefresh
  - `ok` boolean, required
  - `status` string, required
  - `reason` string

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)