> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Portfolio

> Update a portfolio name, description, or metadata

<Snippet file="portfolios/access.mdx" />

See [portfolio limits and references](/guides/portfolios) for current caps and
`external_ref` semantics.

## Overview

Updates a portfolio's own attributes. Membership references are changed through the
[add/remove operations](/api-reference/portfolios/add-trademarks), not through
portfolio metadata.

## Request

Send the fields to change and an `Idempotency-Key` header. `name` must remain
non-empty and unique within your organization. Set `description` to `null` to
clear it. `metadata` merges with existing keys; a `null` value removes that key.

## Response

The updated portfolio at the top level.

## Errors

An unknown or foreign portfolio returns 404; a duplicate name returns
409 `conflict`.