Delete Saved Search

Delete_Saved_Search removes an existing GovTribe saved search by ID and returns a text confirmation on success.

Input Contract

Delete_Saved_Search has a single required input and relies on request model binding plus authorization. The request resolver validates that saved_search_id is a string GovTribe ID, binds it to an existing saved-search model, and then checks delete permission for the calling user. If the ID does not resolve, or the caller is not authorized, the tool fails before deletion runs. This aligns with Saved Search ownership controls where delete operations are restricted to authorized account users.

• saved_search_id: GovTribe ID of the saved search to delete.

  • type: string

  • required: yes

  • default: n/a

Output Contract

• Top-level keys:

  • response

• Row keys:

  • n/a

• Relationship retrieval map:

  • saved_search_id (input context)

    • tool: Search_Saved_Searches

    • filter: saved_search_ids

    • fallback: after deletion, this lookup may return zero rows; use previously captured saved-search details for audit history.

Usage Patterns

Pattern A: Direct delete when the saved-search ID is known. Tool: Delete_Saved_Search

{
  "saved_search_id": "<SAVED_SEARCH_ID>"
}