Delete a segment

Deletes a segment. Every brand-segment attachment is removed at the same time; the brands themselves are left untouched. A project must keep at least one segment, so attempting to delete the last one will return 422.

DELETE /api/v1/segments/{segment}

Path parameters

Name	Type	Required	Description
segment	integer	Required	The numeric ID of the segment.

import os import requests response = requests.delete( "https://pineprompt.com/api/v1/segments/7", headers={ "Authorization": f"Bearer {os.environ['PINEPROMPT_TOKEN']}", "Pineprompt-Project-Id": "1", }, ) response.raise_for_status() payload = response.json()

use GuzzleHttp\Client; $response = (new Client())->delete('https://pineprompt.com/api/v1/segments/7', [ 'headers' => [ 'Authorization' => 'Bearer '.getenv('PINEPROMPT_TOKEN'), 'Pineprompt-Project-Id' => '1', ], ]); // Guzzle throws on 4xx/5xx by default, so no manual check needed. $payload = json_decode((string) $response->getBody(), true);