# 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.

## 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`

```json
{
  "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`

```json
{
  "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`

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.govtribe.com/user-guide/mcp/tools/create-saved-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.