---
title: "Update a workflow"
method: PUT
path: "/v1/workflows/{id}"
---

# Update a workflow

`PUT /v1/workflows/{id}`

## Request

- Base URL: `https://postonce.to/api/public`
- URL: `https://postonce.to/api/public/v1/workflows/{id}`
- Auth: HTTP bearer

Updates a future-content workflow configuration, including activation state, target accounts, and optional `settings.content_filters`.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `description` string, nullable
  - `source_account_id` string
  - `target_account_ids` string[]
  - `is_active` boolean
  - `future_content_enabled` boolean
  - `settings` WorkflowSettings
    - `content_filters` object
      - `types` object
        - `text` boolean
        - `image` boolean
        - `quote` boolean
        - `video` boolean
      - `hashtags` object
        - `include` string[]
        - `exclude` string[]
    - `platform_settings` object
      - `tiktok` object
        - `keep_source_thumbnail` boolean: When false, TikTok workflow posts do not prepend the source thumbnail as the first video frame.
    - `destination_publish_settings` object

## Response `200`

Workflow updated successfully.

- object
  - `data` Workflow
    - `id` string
    - `profile_id` string
    - `source_account_id` string
    - `target_account_ids` string[]
    - `settings` WorkflowSettings
      - `content_filters` object
        - `types` object
          - `text` boolean
          - `image` boolean
          - `quote` boolean
          - `video` boolean
        - `hashtags` object
          - `include` string[]
          - `exclude` string[]
      - `platform_settings` object
        - `tiktok` object
          - `keep_source_thumbnail` boolean: When false, TikTok workflow posts do not prepend the source thumbnail as the first video frame.
      - `destination_publish_settings` object
    - `is_active` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `name` string
    - `description` string, nullable
    - `future_content_enabled` boolean
    - `last_checked` string, date-time, nullable
    - `last_enabled_at` string, date-time, nullable

## Other responses

- `401`: Missing, invalid, revoked, or expired API key.

---

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