Skip to main content
PATCH
/
v1
/
portfolios
/
{id}
Update Portfolio
curl --request PATCH \
  --url https://api.example.com/v1/portfolios/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>"
}
'
{
  "id": "ptf_abc123",
  "object": "portfolio",
    "name": "Core Brand Portfolio",
    "description": "Primary brand trademarks across all jurisdictions",
    "mark_count": 47,
    "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-03-24T14:45:00Z",
  "livemode": true,
  "request_id": "req_hA7rS3tU"
}

Overview

Updates the name or description of an existing portfolio. This does not modify the marks within the portfolio. Use Add Marks to manage portfolio membership.

Path Parameters

id
string
required
Portfolio ID (e.g., ptf_abc123)

Request Body

name
string
New portfolio name
description
string
New portfolio description (pass null to clear)

Response

Returns the updated portfolio object.
{
  "id": "ptf_abc123",
  "object": "portfolio",
    "name": "Core Brand Portfolio",
    "description": "Primary brand trademarks across all jurisdictions",
    "mark_count": 47,
    "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-03-24T14:45:00Z",
  "livemode": true,
  "request_id": "req_hA7rS3tU"
}

Code Examples

curl -X PATCH https://api.signa.so/v1/portfolios/ptf_abc123 \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Core Brand Portfolio",
    "description": "Primary brand trademarks across all jurisdictions"
  }'

Errors

StatusTypeDescription
400validation_errorRequest body is empty or contains invalid fields
401unauthorizedMissing or invalid API key
404not_foundPortfolio ID does not exist
409conflictA portfolio with the same name already exists
429rate_limitedToo many requests