Skip to main content

Delete Strategy

Permanently delete a strategy. Only allowed when the strategy is not actively running. Deleted strategies cannot be restored, but their backtest reports and historical trades remain accessible by id for audit.

Endpoint

DELETE /v1/strategies/{id}

Weight: 5 Authentication: Required (signed) — see Authentication.

Request

Path parameter: id — the strategy identifier (e.g. strat_8f2a1b).

No body.

Response

{
"deleted": true,
"id": "strat_8f2a1b"
}

Response fields

FieldTypeDescription
deletedbooleanAlways true on success.
idstringThe strategy identifier that was deleted.

Errors

  • 404 NOT_FOUND — strategy does not exist or is not owned by the caller.
  • 409 INVALID_STATE — strategy is currently deployed. Pause or stop it first, then retry.

See Errors for the full list.

Example

curl -X DELETE "https://api.pipai.example/v1/strategies/strat_8f2a1b" \
-H "X-PipAI-API-Key: $API_KEY" \
-H "X-PipAI-Timestamp: $TS" \
-H "X-PipAI-Signature: $SIG"