Read the Instagram posts again now

Reads the connected account's newest posts now instead of waiting for the hourly read: new pictures are stored, posts that dropped off are removed. 409 when Instagram isn't connected or isn't available on this service.

POST/api/v1/sites/{site_id}/instagram/refresh

Authentication

An API key as Authorization: Bearer or x-api-key. It needs the sites:write scope — edit draft pages and sections.

sites:writeChanges the live siteIdempotency-Key optionalMCP tool: refresh_instagram

Parameters

Named placeholders go in the path; the rest in a JSON body.

site_idstringPath · required: The site's id.1 to 100 characters

Response

200 with JSON on success (schema on the right). Errors use the standard envelope; a retry with the same Idempotency-Key gets the first answer back (how retries work).

curl

curl -X POST 'https://websites.workflowcorp.com/api/v1/sites/SITE_ID/instagram/refresh' \
  -H "Authorization: Bearer $WEBSITEBUDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Example arguments

{
  "site_id": "SITE_ID"
}

Response schema

{
  "type": "object",
  "properties": {
    "available": {
      "type": "boolean",
      "description": "Instagram can be connected on this service (Workflow Corp's Instagram app keys are set). false = the section shows only its Follow button."
    },
    "connected": {
      "type": "boolean"
    },
    "username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "is_sample": {
      "type": "boolean"
    },
    "read_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "When the posts were last read from Instagram (they are read again every hour)."
    },
    "problem": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Plain words for the last failed read; the last posts read stay on the site."
    },
    "posts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "permalink": {
            "type": "string",
            "description": "The post on Instagram."
          },
          "caption": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "description": "IMAGE, VIDEO (its cover picture is shown) or CAROUSEL_ALBUM."
          },
          "image_url": {
            "type": "string",
            "description": "The picture as stored on the site (never loaded from Instagram)."
          },
          "posted_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "permalink",
          "caption",
          "kind",
          "image_url",
          "posted_at"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "available",
    "connected",
    "username",
    "is_sample",
    "read_at",
    "problem",
    "posts"
  ],
  "additionalProperties": false
}