Delete Watchlist

This API allows a user to delete an existing Watchlist that was created by them. Deletion is version-controlled to prevent accidental overrides.

🔍Query Parameters

Parameter	Type	Required	Description	Example/ENUM
id	string	Yes	Unique ID of the Watchlist to be deleted	b515ae62-2f92-40ef-845b-309719d8242f
_version	number	Yes	Current version number of the Watchlist (for safe delete)	1

🔑Header Parameters

Header	Type	Required	Description	Example/ENUM
Authorization	string	Yes	Bearer token for user authentication	Bearer{{access_token}}
x-api-key	string	Yes	API key for access control	{{x-api-key}}

🟢Success Response - 200 Ok

Field	Type	Description	Example/ENUM
status	string	Status of the API call	"success"
code	string	Response code	"s-101"
message	string	Descriptive success message	"Watchlist Deleted successfully"
data	array of object	List of Watchlist objects	See details below

🧭Watchlist Object Schema

Field	Type	Description	Example/ENUM
id	string	Unique Watchlist ID	"32b95c61-370-b215-bb8857f9c949"
sWatchListName	string	Name of the Watchlist	"My Portfolio"
bIsPrivate	boolean	If true, watchlist is private	true
bIsDefault	boolean	If true, this is the default watchlist	false
sUserId	string	User ID of the watchlist creator	"user123"
sTenantId	string	Tenant/Broker ID	"1256878"
sSettings	string	Reserved for future (must be valid JSON string)	"{\"subCount\":13}"
scrips	array	List of scrips within the watchlist	See Scrip Object below
_version	number	Version number of the watchlist	1
_deleted	boolean	Flag to indicate if deleted	true
_lastChangedAt	number	Epoch timestamp of last change	1718008123
createdAt	string	ISO date-time of watchlist creation	"2025-06-01T12:00:00Z"
updatedAt	string	ISO date-time of last update	"2025-06-10T09:45:00Z"

📝Scrip Objects

Field	Type	Required	Description	Example/ENUM
nMarketSegmentId	number	Yes	Exchange segment ID
1
nToken	number	Yes	Exchange token number for the scrip	123456
nSequenceNo	number	Yes	Sequence number in the Watchlist	1, 2, ...
sSettings	string	No	Reserved for future settings (JSON string)	""

delete/nontransactional/v1/watchListProfile