Skip to main content
DELETE
Delete Period

Delete Period

Delete a specific period from a sold product. All related data for this period (country sales, total impacts, and conversion steps) will be permanently removed.
You cannot delete the last remaining period of a sold product. To remove the entire product, use the Delete Sold Product endpoint instead.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

string
required
UUID of the sold productExample: "550e8400-e29b-41d4-a716-446655440000"
string
required
UUID of the period to deleteExample: "11111111-1111-1111-1111-111111111111"

Response

Returns HTTP 204 No Content on success.

Example

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

400 Bad Request

Cause: Attempting to delete the last period of a product

404 Not Found

Cause: Product or period does not exist

List Periods

View all periods for a product

Delete Sold Product

Remove the entire product instead