Skip to main content
POST
Create Portfolio
See portfolio limits and references for current caps and external_ref semantics.

Overview

A portfolio groups Signa trademark records into a customer-owned folder. It does not create matters, tasks, or completion state. New portfolios start empty; use Add Trademarks to populate them.

Request

Send a unique name (1–255 characters), optional description (up to 2,000 characters), and optional string-valued metadata (up to 50 keys). Requires an Idempotency-Key header.

Response

The created portfolio at the top level, with a ptf_ ID and HTTP 201.

Errors

The portfolio-count limit is separate from the managed-marks allowance: free 3, beta 20, starter 10, pro 50, enterprise unlimited. Exceeding it returns 409 resource_quota_exceeded with quota_scope: "portfolios". A duplicate name returns 409 conflict.