---
title: "Tell SteadyFeed what to post about"
method: POST
path: "/drops"
---

# Tell SteadyFeed what to post about

`POST /drops`

## Request

- Base URL: `https://api.steadyfeed.app/v1`
- URL: `https://api.steadyfeed.app/v1/drops`
- Auth: HTTP bearer

An idea, news, an offer, a link and pictures. Mention a day in text if it matters. Writing takes a minute or two; follow it with getDrop.

## Request body

- object
  - `text` string: What to post about, in plain words.
  - `link` string, uri: A web page to read.
  - `image_urls` string[]: Public https picture addresses.
  - `images` string[]: Pictures as base64, about 3 MB in all per call.
  - `date` string, date: The day the first post goes out.
  - `hour` integer: The hour that day, brand time.
  - `keep_words` boolean: Use text as the caption, as written; makes one post.

## Response `201`

Created

- Drop
  - `id` string
  - `status` 'new' | 'working' | 'done' | 'question' | 'failed'
  - `text` string
  - `link` string, nullable
  - `reply` string, nullable
  - `question` string, nullable: Something to answer in the app.
  - `error` string, nullable
  - `auto_publish` boolean: Posts that pass the quality check go out on their own.
  - `posts` object[]
    - `id` string
    - `title` string
    - `date` string, nullable
    - `passed_check` boolean
    - `score` number, nullable
    - `held_because` string[]
  - `created_at` string

## Other responses

- `400`: Problem
- `401`: Problem
- `404`: Problem
- `429`: Problem

---

[API](https://skmtc.dev/steadyfeed/apis/steadyfeed-api.md) · [All operations](https://skmtc.dev/steadyfeed/apis/steadyfeed-api/llms.txt) · [OpenAPI document](https://skmtc.dev/steadyfeed/apis/steadyfeed-api/revisions/359d702d1421?raw)
