Create a portfolio
Creates an empty portfolio. Properties are put into it afterwards, either when they are created or by moving an existing property.
Authorization
AuthorizationstringrequiredBearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.
Body
application/json
namestringrequiredWhat to call the portfolio. Up to 150 characters, and it must not be blank. Leading and trailing spaces are trimmed.
iconsstring[]Accepted by the endpoint but ignored on create — icons are only applied when a portfolio is updated.
Response
200 · The new portfolio. Note that it is the plain portfolio, without the `properties` array the list endpoint returns.
idstringSnowflake id of the portfolio.
activebooleanfalse once the portfolio has been deactivated.
namestringThe portfolio's name.
propertyCountintegerHow many properties sit in the portfolio, active and deactivated together.
iconsstring[]Icon keys pinned to the portfolio. Free-form strings; they are added and removed through the icons endpoints, not here.