Delete an alias

DELETE 
/v2/agent_aliases/:alias_key

Deletes an alias. The underlying agents the alias points at are not affected. A platform-generated alias fronted by a widget connector cannot be deleted directly (409); it is deleted with its connector. Returns 409 if any live resources still reference this alias.

Request

Responses

204

The alias is deleted.

403

Permissions do not allow deleting this alias.

404

Alias not found.

409

The alias has live references (e.g. connectors) that prevent deletion.