Create Saved Search

Create_Saved_Search creates a new saved search from an existing search_* result persistence ID and returns the created saved-search resource as JSON text.

Input Contract

• search_persistence_id: Persistence identifier produced by a prior search_* tool call.

  • type: string

  • required: yes

  • default: n/a

• frequency: Notification cadence for new matching results.

  • type: string enum

  • required: yes

  • default: Daily

  • options: Daily, Weekly, Instant, Never

• name: Saved-search display name.

  • type: string

  • required: yes

  • default: n/a

  • shape: min length 1, max length 100

Output Contract

• Top-level keys:

  • govtribe_id

  • govtribe_type

  • govtribe_url

  • name

  • frequency

  • q

  • filters

  • sorts

  • view_results_url

  • searches_govtribe_type

  • search_persistence_id

  • last_sent

  • created_at

  • updated_at

  • owner

  • creator

• Row keys:

  • n/a

• Relationship retrieval map:

  • creator

    • resource_type: user

    • tool: Search_Users

    • filter: user_ids

    • nested_keys: govtribe_id, govtribe_type, name, email

  • owner

    • resource_type: user

    • tool: Search_Users

    • filter: user_ids

    • nested_keys: govtribe_id, govtribe_type, name, email

Usage Patterns

Pattern A: Create a daily digest saved search from an existing search result set. Tool: Create_Saved_Search

{
  "search_persistence_id": "<SEARCH_RESULTS_ID>",
  "frequency": "Daily",
  "name": "Army cybersecurity opportunities"
}

Pattern B: Create an instant alert for high-urgency monitoring. Tool: Create_Saved_Search

{
  "search_persistence_id": "<SEARCH_RESULTS_ID>",
  "frequency": "Instant",
  "name": "DoD recompete notices - immediate alerts"
}

Pattern C: Save reusable criteria without email notifications. Tool: Create_Saved_Search

{
  "search_persistence_id": "<SEARCH_RESULTS_ID>",
  "frequency": "Never",
  "name": "Quarterly pipeline research baseline"
}