---
title: "Update flow metadata only"
method: PATCH
path: "/flows/{id}/metadata"
tags: ["Flow"]
---

# Update flow metadata only

`PATCH /flows/{id}/metadata`

Update the unversioned metadata of an existing flow

## Path parameters

- `id` string, required

## Headers

- `If-Match` string

## Request body

- FlowMetadata
  - `id` string — Unique identifier
  - `created_by_id` string — The ID of the user who created this test
  - `last_updated_time` integer — Time the test was last updated in epoch milliseconds
  - `last_updated_by_id` string — The ID of the user who last updated this test
  - `created_time` integer — Time the test was created in epoch milliseconds
  - `revision_history` string — Serialized graph describing the test's version history. Managed by mabl API only.
  - `version_tags` object — Mapping of version tags to version numbers that the tag is currently applied to
  - `latest_version` integer — The latest numeric version of this test
  - `organization_id` string — (deprecated) The ID of the organization that this journey belongs to
  - `workspace_id` string — Workspace Id
  - `flow_type` 'validate_page' | 'login' | 'verify_url' | 'mablscript' | 'check_links' | 'visual_page_validation' | 'api' | 'mobile' — the type of flow
  - `reusable` boolean — Indicates whether this can be used by multiple tests
  - `description` string — Summary of the flow
  - `labels` Label[] — User provided labels
    - `name` string, required — name
    - `color` string — color
  - `source_control_tags` object — mapping of tags to version numbers the tag is currently applied to
  - `import_source_id` 'postman' | 'selenium_node_proxy' | 'selenium_java_agent'
  - `import_source_version` string — Version of the import tool used to import this flow
  - `mobile_platform` 'android' | 'ios' — The mobile platform associated with this object
  - `minimize_execution_overhead` boolean — When enabled, mabl will not capture screenshots, network logs, DOM snapshots, or other test artifacts in order to report the most accurate flow execution time

## Response `200`

The updated flow metadata

- FlowMetadata
  - `id` string — Unique identifier
  - `created_by_id` string — The ID of the user who created this test
  - `last_updated_time` integer — Time the test was last updated in epoch milliseconds
  - `last_updated_by_id` string — The ID of the user who last updated this test
  - `created_time` integer — Time the test was created in epoch milliseconds
  - `revision_history` string — Serialized graph describing the test's version history. Managed by mabl API only.
  - `version_tags` object — Mapping of version tags to version numbers that the tag is currently applied to
  - `latest_version` integer — The latest numeric version of this test
  - `organization_id` string — (deprecated) The ID of the organization that this journey belongs to
  - `workspace_id` string — Workspace Id
  - `flow_type` 'validate_page' | 'login' | 'verify_url' | 'mablscript' | 'check_links' | 'visual_page_validation' | 'api' | 'mobile' — the type of flow
  - `reusable` boolean — Indicates whether this can be used by multiple tests
  - `description` string — Summary of the flow
  - `labels` Label[] — User provided labels
    - `name` string, required — name
    - `color` string — color
  - `source_control_tags` object — mapping of tags to version numbers the tag is currently applied to
  - `import_source_id` 'postman' | 'selenium_node_proxy' | 'selenium_java_agent'
  - `import_source_version` string — Version of the import tool used to import this flow
  - `mobile_platform` 'android' | 'ios' — The mobile platform associated with this object
  - `minimize_execution_overhead` boolean — When enabled, mabl will not capture screenshots, network logs, DOM snapshots, or other test artifacts in order to report the most accurate flow execution time

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Flow not found
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)