---
title: "Schedule the post group at a time or in the next queue slot"
method: POST
path: "/posts/{id}/schedule"
---

# Schedule the post group at a time or in the next queue slot

`POST /posts/{id}/schedule`

## Request

- Base URL: `https://govir.app/api/v1`
- URL: `https://govir.app/api/v1/posts/{id}/schedule`
- Auth: HTTP bearer

Scope: `write`.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `at` string, date-time: Send either at or queue.
  - `queue` true
  - `acknowledge_warnings` boolean

## Response `200`

OK

- Scheduled
  - `status` 'scheduled'
  - `scheduled_at` string, date-time
  - `warnings` object[]
  - `group_id` string, uuid, nullable
  - `posts` Post[]
    - `id` string, uuid
    - `status` 'draft' | 'scheduled' | 'publishing' | 'published' | 'partially_published' | 'failed' | 'needs_review' | 'deleted'
    - `account_id` string, uuid
    - `group_id` string, uuid, nullable
    - `scheduled_at` string, date-time, nullable
    - `published_at` string, date-time, nullable
    - `permalink` string, nullable
    - `topic` string, nullable
    - `reply_control` string, nullable
    - `part_numbers` string
    - `quote` object, nullable
      - `post_id` string, uuid
      - `permalink` string, nullable
      - `username` string
    - `error_code` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `parts` object[]
      - `position` integer
      - `text` string
      - `link_attachment` string, nullable
      - `poll_options` string[], nullable
      - `text_attachment` object, nullable
        - `text` string
        - `link_url` string, nullable
      - `gif` object, nullable
        - `id` string
        - `title` string
        - `width` integer
        - `height` integer
        - `url` string
      - `published` boolean
      - `media` object[]
        - `id` string, uuid
        - `kind` string
        - `url` string, nullable
        - `alt_text` string, nullable

## Other responses

- `400`: The request isn't valid
- `401`: No key, a wrong key, or a revoked one
- `402`: Your plan doesn't include this
- `403`: The key lacks the scope, or publishing right away isn't allowed
- `404`: Not found in your workspace
- `409`: Not possible now, or warnings to confirm (needs_confirmation)
- `422`: The Idempotency-Key was used with another request
- `429`: Too many requests; see Retry-After

---

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