> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visitoai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Request Instagram token refresh

> 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`.



## OpenAPI

````yaml /openapi.json post /channels/{channelId}/refresh-token
openapi: 3.0.3
info:
  title: Visito M2M API
  version: 1.0.0
  description: >-
    Tenant-scoped server-to-server API for channels, conversations, commerce,
    custom AI tools, and WhatsApp templates. Send operations are asynchronous
    and return queued acknowledgements. Expansion adds conversation controls,
    knowledge, sales opportunities, delivery status, reporting, and signed
    webhooks.
servers:
  - url: https://platform-api.visitoai.com/m2m/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Channels
  - name: Conversations
  - name: Commerce
  - name: Custom tools
  - name: WhatsApp templates
  - name: Properties
  - name: Knowledge
  - name: Sales CRM
  - name: Delivery
  - name: Reporting
  - name: Webhooks
paths:
  /channels/{channelId}/refresh-token:
    post:
      tags:
        - Channels
      summary: Request Instagram token refresh
      description: >-
        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`.
      operationId: refresh_instagram_channel_token
      parameters:
        - name: channelId
          in: path
          required: true
          description: >-
            Stored channel.id from list_channels or get_channel. Provider page,
            phone, account and WABA IDs are not this ID.
          schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
      responses:
        '200':
          description: Request Instagram token refresh
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChannelTokenRefresh'
        default:
          $ref: '#/components/responses/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    ChannelTokenRefresh:
      type: object
      properties:
        ok:
          type: boolean
        status:
          type: string
        reason:
          type: string
      additionalProperties: false
      required:
        - ok
        - status
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: M2M_AUTH_INSUFFICIENT_SCOPE
            message:
              type: string
            details:
              type: object
              additionalProperties: true
      example:
        error:
          code: M2M_AUTH_INSUFFICIENT_SCOPE
          message: M2M credential does not have required scope.
          details:
            requiredScopes:
              - conversations:write
            missingScopes:
              - conversations:write
  responses:
    Error:
      description: Structured error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Visito M2M API key
      description: Server-side tenant-scoped credential created from Build > API Keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.