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

```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"
}
```