---
title: "Replace Project Operation"
method: PUT
path: "/api/v1/projects/{project_id}/replacement-operations/{operation_id}"
tags: ["Projects"]
---

# Replace Project Operation

`PUT /api/v1/projects/{project_id}/replacement-operations/{operation_id}`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `api/v1/login`
  - API key in query parameter `x-api-key`
  - API key in header `x-api-key`

Replace a project's full flow set and persist an immutable retry receipt.

## Path parameters

- `project_id` string, uuid, required
- `operation_id` string, uuid, required

## Request body

- ProjectReplacementRequest: Complete target flow set, description, and opaque dependency snapshot.
  - `dependencies` object, nullable
  - `description` string, nullable, required
  - `flows` ReplacementFlowCreate[], required
    - `a2a_card_overrides` object, nullable: User overrides for the generated A2A agent card (skill description, examples, tags)
    - `a2a_enabled` boolean, nullable: Can be exposed as an A2A agent (only meaningful when flow_type=agent)
    - `access_type` 'PRIVATE' | 'PUBLIC'
    - `action_description` string, nullable: The description of the action associated with the flow
    - `action_name` string, nullable: The name of the action associated with the flow
    - `data` object, required
    - `description` string, nullable
    - `endpoint_name` string, nullable
    - `flow_type` 'workflow' | 'agent'
    - `folder_id` string, uuid, nullable
    - `fs_path` string, nullable
    - `gradient` string, nullable
    - `icon` string, nullable
    - `icon_bg_color` string, nullable
    - `id` string, uuid, required
    - `is_component` boolean, nullable
    - `locked` boolean, nullable
    - `mcp_enabled` boolean, nullable: Can be exposed in the MCP server
    - `name` string, required
    - `tags` string[], nullable
    - `updated_at` string, date-time, nullable
    - `user_id` string, uuid, nullable
    - `webhook` boolean, nullable: Can be used on the webhook endpoint
    - `workspace_id` string, uuid, nullable
  - `project_name` string, nullable

## Response `200`

Successful Response

- ProjectReplacementResult: Immutable response snapshot saved with the replacement transaction.
  - `dependencies` object, nullable
  - `flows` FlowRead[], required
    - `a2a_card_overrides` object, nullable: User overrides for the generated A2A agent card (skill description, examples, tags)
    - `a2a_enabled` boolean, nullable: Can be exposed as an A2A agent (only meaningful when flow_type=agent)
    - `access_type` 'PRIVATE' | 'PUBLIC'
    - `action_description` string, nullable: The description of the action associated with the flow
    - `action_name` string, nullable: The name of the action associated with the flow
    - `data` object, nullable
    - `description` string, nullable
    - `endpoint_name` string, nullable
    - `flow_type` 'workflow' | 'agent'
    - `folder_id` string, uuid, nullable, required
    - `gradient` string, nullable
    - `icon` string, nullable
    - `icon_bg_color` string, nullable
    - `id` string, uuid, required
    - `is_component` boolean, nullable
    - `locked` boolean, nullable
    - `mcp_enabled` boolean, nullable: Can be exposed in the MCP server
    - `name` string, required
    - `name_key` string, nullable: Stable i18n key derived from the original English name
    - `tags` string[], nullable: The tags of the flow
    - `updated_at` string, date-time, nullable
    - `user_id` string, uuid, nullable, required
    - `version_token` string, uuid, nullable: Token identifying the version this response carries
    - `webhook` boolean, nullable: Can be used on the webhook endpoint
    - `workspace_id` string, uuid, nullable
  - `project` FolderRead, required
    - `auth_settings` object, nullable: Authentication settings for the folder/project
    - `description` string, nullable
    - `id` string, uuid, required
    - `name` string, required
    - `parent_id` string, uuid, nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `4349fbe90c64`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v1/projects/:project_id/replacement-operations/:operation_id/put.md)

---

[API](https://skmtc.dev/langflow-ai/apis/langflow.md) - [All operations](https://skmtc.dev/langflow-ai/apis/langflow/llms.txt) - [OpenAPI document](https://skmtc.dev/langflow-ai/apis/langflow/revisions/4349fbe90c64?raw)