DELETE
/
segments
/
{tableName}
/
{segmentName}
Delete a segment
curl --request DELETE \
  --url https://dev.startree.ai/segments/{tableName}/{segmentName} \
  --header 'Authorization: <api-key>'
{
  "status": "<string>"
}

Authorizations

​
Authorization
string
header
required

The format of the key is "Basic <token>" or "Bearer <token>"

Path Parameters

​
tableName
string
required

Name of the table

​
segmentName
string
required

Name of the segment

Query Parameters

​
retention
string

Retention period for the table segments (e.g. 12h, 3d); If not set, the retention period will default to the first config that's not null: the table config, then to cluster setting, then '7d'. Using 0d or -1d will instantly delete segments without retention

Response

200 - application/json

successful operation

The response is of type object.