---
title: "Save a customer report workflow"
method: POST
path: "/v1/report-workflows"
tags: ["report-workflows"]
---

# Save a customer report workflow

`POST /v1/report-workflows`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/report-workflows`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Request body

- ReportWorkflowSaveRequest
  - `workflow` ReportWorkflow, required
    - `workflow_id` string, required
    - `version` string, required
    - `name` string, required
    - `owner_scope` 'seed' | 'customer' | 'internal'
    - `source` string, nullable
    - `payload_schema` string, nullable
    - `payload_schema_inline` object, nullable
    - `theme_id` string
    - `strict_policy` object
    - `name_template` string, nullable
    - `connector` object, nullable
    - `slides` WorkflowSlide[], required
      - `id` string, required
      - `role` string, nullable
      - `required` boolean
      - `when` string, nullable
      - `form` string, required
      - `variant` string, required
      - `constants` object
      - `bindings` object
      - `optional_bindings` object
  - `validation_payload` object, nullable
  - `compile_check` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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