Integrations

Feed a project's seasons from a connected product.

Feed (feeding: true) or withdraw (feeding: false) a project from a product. No season has to be live: every current and future internal season reads every place chosen in the product unless the season has its own rule (PUT /season-runs/{runId}/integration-feed); a season meant for outside readers still reads only places picked for it. Items found before a season starts wait for it. Every item still waits for someone to keep it. Owners and admins, on their own projects. Scope: story:write. Free.

put/story-projects/{projectId}/integration-feed

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/integration-feed
  • Auth: HTTP bearer

Request body

providerSlugstring required

The product: notion, slack, github, linear, …

feedingboolean required

True feeds the project's seasons from it; false withdraws (nothing already found is removed).

Response

The project's feeds now, and what changed.

projectIdstring required
projectNamestring required
liveSeasonsinteger required

Live seasons the feeds reach now; zero means found items wait for the first season.

itemsHeldinteger required
summarystring required

One plain line for a chat or a CLI.

providerSlugstring required
feedingboolean required
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.