Skip to main content
DELETE
/
v1
/
portfolios
/
{id}
Delete Portfolio
curl --request DELETE \
  --url https://api.example.com/v1/portfolios/{id}
{
  "id": "ptf_abc123",
  "object": "portfolio",
  "deleted": true,
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Deletes a portfolio. Cascades the portfolio_marks join table so the marks themselves are not affected, only their membership in this portfolio. Requires the portfolios:manage scope.

​
Path Parameters

​
id
string
required
Portfolio ID (ptf_...).

​
Response

​
id
string
Echo of the deleted portfolio ID.
​
object
string
Always portfolio.
​
deleted
boolean
Always true on success.
{
  "id": "ptf_abc123",
  "object": "portfolio",
  "deleted": true,
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

curl -X DELETE "https://api.signa.so/v1/portfolios/ptf_abc123" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
400validation_errorInvalid portfolio ID format
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage
404not_foundPortfolio does not exist or belongs to another org