---
title: "Rename Workflow"
method: PATCH
path: "/api/v1/workflows/{workflow_id}/name"
tags: ["Workflows"]
---

# Rename Workflow

`PATCH /api/v1/workflows/{workflow_id}/name`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/workflows/{workflow_id}/name`
- Auth: HTTP bearer

Sets the workflow's name. Single-field PATCH — the only body field is `name` (required, trimmed, non-empty).

**This does not rename the main sheet's tab.** The workflow name and the main sheet's label are stored separately. To rename a sheet — main or child — use `PATCH /api/v1/workflows/{workflow_id}/sheets/{sheet_id}/name` (Rename Sheet). Get Workflow Overview reports this name as `data.name`; `data.sheets[0].name` follows it only until the main sheet is given its own label.

**Cache.** Renaming does not affect sheets, rows, cached action runs, or the action chain — only the name.

Any caller with access to the workflow may rename it; unlike Delete Workflow this is not restricted to the owner.

## Path parameters

- `workflow_id` string, required

## Request body

- RenameWorkflowBody: Body for Rename Workflow. `name` is the only field.
  - `name` string, required: New workflow name. Trimmed before saving; whitespace-only values are rejected with 400. Not required to be unique.

## Response `200`

Default Response

- object
  - `status` integer
  - `data` WorkflowRenamed: Confirmation envelope for a renamed workflow. This is the workflow's own name; the main sheet's tab label is stored separately and is set via Rename Sheet.
    - `workflow_id` string, uuid, required: UUID of the workflow that was renamed.
    - `name` string, required: The stored workflow name, after trimming.

## Other responses

- `400`: Invalid request — `name` is empty after trimming
- `401`: Unauthorized — missing or invalid API key
- `403`: Forbidden. `code` says which permission refused: ROLE_FORBIDDEN (your role), INSUFFICIENT_SCOPE (the API key's scopes), WORKFLOW_FORBIDDEN (no access to the workflow), KEY_WORKFLOW_FORBIDDEN (the API key's workflow restriction).
- `404`: Workflow not found
- `429`: Too Many Requests — rate limit exceeded. Check `Retry-After` header for seconds until the limit resets.

---

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