---
title: "Check an RSS feed now"
method: POST
path: "/rss-feeds/{id}/check"
tags: ["RSS feeds"]
---

# Check an RSS feed now

`POST /rss-feeds/{id}/check`

## Request

- Base URL: `https://post.adaptlypost.com/post/api/v1`
- URL: `https://post.adaptlypost.com/post/api/v1/rss-feeds/{id}/check`
- Auth: HTTP bearer

Moves the next check to now; the feed is fetched within a minute. Requires the `posts.draft` permission.

## Path parameters

- `id` string, required

## Headers

- `X-Workspace-Id` string

## Response `200`

The RSS feed

- RssFeed
  - `id` string
  - `userId` string: Member the feed posts as: whoever last saved it
  - `accountGroupId` string
  - `name` string
  - `url` string
  - `siteUrl` string
  - `status` 'ACTIVE' | 'PAUSED'
  - `pauseReason` 'USER' | 'FETCH_FAILURES' | 'CONSECUTIVE_FAILURES' | 'ACCESS_LOST' | 'SUBSCRIPTION_INACTIVE' | 'CONNECTION_REMOVED': Why the feed stopped: USER (paused by hand), FETCH_FAILURES (5 failed fetches in a row), CONSECUTIVE_FAILURES (3 items in a row failed to post), ACCESS_LOST (its owner lost the permission its post mode needs), SUBSCRIPTION_INACTIVE (the plan no longer covers publishing) or CONNECTION_REMOVED (every target account was disconnected)
  - `lastError` string
  - `postMode` 'DRAFT' | 'SCHEDULE' | 'PUBLISH': DRAFT creates a draft and needs `posts.draft`; SCHEDULE schedules the post `publishDelayMinutes` after the item is found and needs `posts.schedule`; PUBLISH publishes it right away and needs `posts.publish`
  - `publishDelayMinutes` integer
  - `contentMode` 'TEMPLATE' | 'AI': TEMPLATE fills `template`; AI writes one caption per platform from the article, appends the link, spends 1 AI credit per platform per item and needs `ai.generate`
  - `template` string
  - `aiInstructions` string
  - `includeImage` boolean
  - `twitterKeepLinks` boolean
  - `includeKeywords` string[]
  - `excludeKeywords` string[]
  - `maxPostsPerCheck` integer
  - `checkIntervalMinutes` integer
  - `targets` RssFeedTarget[]
    - `platform` 'FACEBOOK' | 'INSTAGRAM' | 'THREADS' | 'TWITTER' | 'BLUESKY' | 'LINKEDIN' | 'MASTODON' | 'TELEGRAM' | 'GOOGLE_BUSINESS', required
    - `connectionId` string, required: Account ID from `GET /social-accounts`
    - `pageId` string: Facebook page ID. Required for FACEBOOK
    - `displayName` string
  - `nextCheckAt` string, date-time
  - `lastCheckedAt` string, date-time
  - `lastPostedAt` string, date-time
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `401`: Invalid or missing API key
- `403`: The key's role does not hold `posts.draft`
- `404`: RSS feed not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api.md) · [All operations](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/revisions/8390a5fa9a0d?raw)