Reference

Delete a short link

Deletes a short link; anyone who opens it afterwards sees a not found page.

REST	`POST /api/v1/agents/{agent_id}/short-links/{short_link_id}/delete`
MCP tool	`delete_short_link`
Classification	Sensitive write
Scope	`agents:write`
Minimum role on the agent	editor
Confirmation	Required: `confirm: true`, after the person agrees
Retry safety	Safe to retry with the same input
Success status	200

What it does

Deletes a short link; anyone who opens it afterwards sees a not found page. Needs agents:delete and confirm: true. To stop it for a while, use update_short_link with enabled: false.

Side effects

Deletes the link; it answers not found from then on.

Inputs

Name	Type	Required	In	Description
`agent_id`	string	yes	path	The agent id (agt_...), from list_agents.
`short_link_id`	string	yes	path	The short link id, from list_short_links.
`confirm`	true	no	body	Set to true after reviewing the effect with the person you work for. Required for destructive operations.

Example

REST

curl -X POST "https://covo.lanaai.io/api/v1/agents/agt_4edc89bb2964/short-links/33f5aef6-f05a-4a0e-8716-76aed5e209f9/delete" \
  -H "Authorization: Bearer $COVO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"confirm":true}'

MCP (POST /mcp)

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_short_link",
    "arguments": {
      "agent_id": "agt_4edc89bb2964",
      "short_link_id": "33f5aef6-f05a-4a0e-8716-76aed5e209f9",
      "confirm": true
    }
  }
}

Response

Returns an object with short_link_id and deleted. This is a real response, shortened to two items per list.

200 response

{
  "short_link_id": "33f5aef6-f05a-4a0e-8716-76aed5e209f9",
  "deleted": true
}

Over MCP the same object comes back as the tool result, in structuredContent and as JSON text.

Errors

Status	Code	Meaning
401	`unauthorized`	No token, or it is unknown, revoked or expired. OAuth apps refresh or reconnect.
403	`account_suspended`	The account that owns the token is paused.
403	`insufficient_scope`	The token lacks `agents:write`.
404	`agent_not_found`	Unknown agent, or not reachable with this token.
400	`bad_request`	An input is invalid; `field` names it.
409	`confirmation_required`	Review the effect with the person you work for, then send `confirm: true`.
429	`rate_limited`	Wait `Retry-After` seconds.