Skip to main content
POST
/
v1
/
portfolios
/
{id}
/
marks
Add Marks to Portfolio
curl --request POST \
  --url https://api.example.com/v1/portfolios/{id}/marks \
  --header 'Content-Type: application/json' \
  --data '
{
  "trademark_ids": [
    "<string>"
  ]
}
'
{
  "id": "ptf_abc123",
  "object": "portfolio_update",
  "mark_count": 52,
  "added": 5,
  "livemode": true,
  "request_id": "req_iB8sT4uV"
}

​
Overview

Add trademarks to a portfolio. You can add up to 100 trademark IDs per request. Marks that are already in the portfolio are silently ignored. To remove marks, use the separate POST /v1/portfolios/{id}/marks/remove endpoint.

​
Path Parameters

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

​
Request Body

​
trademark_ids
string[]
required
Trademark IDs to add to the portfolio (max 100 per request)

​
Response

Returns the updated portfolio summary with the new mark count.
​
response
object
{
  "id": "ptf_abc123",
  "object": "portfolio_update",
  "mark_count": 52,
  "added": 5,
  "livemode": true,
  "request_id": "req_iB8sT4uV"
}

​
Code Examples

curl -X POST https://api.signa.so/v1/portfolios/ptf_abc123/marks \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "trademark_ids": ["tm_8kLm2nPq", "tm_Xp4wQ7vR", "tm_Qr6nK9jL"]
  }'

​
Errors

StatusTypeDescription
400validation_errortrademark_ids is empty or exceeds 100 items
401unauthorizedMissing or invalid API key
404not_foundPortfolio ID does not exist
422unprocessable_entityOne or more trademark IDs are invalid
429rate_limitedToo many requests