Delete a portfolio snapshot
/portfolios/{identifier}Deletes one snapshot of a portfolio. It works on any portfolio in your organization, including portfolios created in the Connect Earth app. When you delete the last listed snapshot, the portfolio is deleted too. A portfolio with no listed snapshots, for example one whose snapshots are all older than about five years, is deleted entirely by a DELETE, whatever snapshot_at you send. If the snapshot is not listed, nothing is deleted and the message says so. metadata.message is one of Fund snapshot deleted successfully, Fund deleted successfully with all snapshots, Fund deleted successfully or Fund snapshot not found.
Authorization
apiKey Your Connect Earth API key.
In: header
Path Parameters
The portfolio identifier returned by POST /portfolios or GET /portfolios.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://eco.datia.app/portfolios/datia-portfolio:12345_pension-fund-a" \ -H "x-api-key: $CE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "snapshot_at": "2026-06-30" }'{ "identifier": "datia-portfolio:12345_pension-fund-a", "metadata": { "message": "Fund snapshot deleted successfully" }}Create or replace a portfolio snapshot POST
Uploads the holdings of a portfolio for one date. Sending the same identifier with a date in the same quarter replaces that snapshot. A date in another quarter adds a new snapshot. When the identifier already exists, only the holdings are replaced or added: name and currency are changed only with PUT /portfolios/{identifier}. Use the identifier in the response to update or delete the portfolio later. A snapshot_at in a future year fails with 400 and the message Snapshot date cannot be higher than actual date. A date that cannot be read fails with 400 and the message You are not using a valid date as snapshot parameter.
Rename a portfolio or change its currency PUT
Updates the name or currency of a portfolio. Send only the fields you want to change. It works on any portfolio in your organization, including portfolios created in the Connect Earth app. An unknown currency code is ignored.