> ## Documentation Index > Fetch the complete documentation index at: https://docs.govly.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an award saved search > Saves a set of award search criteria as a replayable search. Award saved searches do not send notifications — run one any time with the results endpoint. The date window is stored as relative day offsets and defaults to the last year. The market the search is created under is stored and bounds every replay, so set searchType explicitly when scoping to a state or local place. Stored filters can be changed but not removed. ## OpenAPI ````yaml /openapi/tools-v1.yaml post /api/tools/v1/awards/saved_searches openapi: 3.1.0 info: title: Govly Tools API (Alpha) version: 1.0.0-alpha description: > ALPHA / UNSTABLE: This API is still in active development. Endpoint behavior, request fields, response fields, error codes, and operation names may change before the Tools API is declared stable. REST-callable tool surface for agent and automation workflows. Agents are the primary consumer, but integrations can be built on this API. Responses are JSON for typed clients; MCP tools may render action results into text-oriented formats separately. servers: - url: https://app.govly.com security: - bearerApiKey: [] - headerApiKey: [] tags: - name: Opportunities description: Search, fetch, and inspect Govly opportunity records. - name: Awards description: Search and inspect awarded government contracts. - name: Contacts description: Search and inspect government points of contact. - name: Signals description: Search clustered procurement and market intelligence signals. - name: Places description: Resolve place names to canonical Govly Place ids. - name: Product Catalogs description: List government contract price lists and search their line items. - name: Workspaces description: Create, update, and inspect opportunity workspaces. - name: Workspace Members description: Add users and teams to workspaces. - name: Workspace Attachments description: List and upload workspace attachments. - name: Workspace Comments description: Post comments to workspaces. - name: Follows description: Follow opportunities and related workspace activity. - name: Saved Searches description: List saved opportunity searches and cached matches. - name: Documents description: >- Read document representations and request temporary original-file downloads. - name: Quote Submissions description: >- Inspect quote submission requirements, submit quotes, and poll submission status. - name: Inbox description: Read and triage the authenticated user's matched inbox items. paths: /api/tools/v1/awards/saved_searches: post: tags: - Saved Searches summary: Create an award saved search description: > Saves a set of award search criteria as a replayable search. Award saved searches do not send notifications — run one any time with the results endpoint. The date window is stored as relative day offsets and defaults to the last year. The market the search is created under is stored and bounds every replay, so set searchType explicitly when scoping to a state or local place. Stored filters can be changed but not removed. operationId: create_award_saved_search requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - name properties: name: type: string description: Display name for the saved search. query: type: string description: Free-text search terms. searchType: type: string enum: - fed - sled - international description: > Market this search covers. Defaults to the caller's market focus and is stored, so it bounds every later replay. recipientNames: type: array items: type: string description: Recipient/vendor names to filter by. buyerNames: type: array items: type: string description: Awarding buyer names. funderNames: type: array items: type: string description: Funding agency names. naics: type: array items: type: string description: NAICS codes to filter by. psc: type: array items: type: string description: Product/service codes. amountRange: type: array items: type: number minItems: 2 maxItems: 2 description: '[min, max] awarded amount.' placeIds: type: array items: type: string description: > Canonical Govly Place ids to scope the saved search to, from the place search or list tools. Matches at any administrative level. Bounded by the stored market, and changeable but not removable. placeIdsNone: type: array items: type: string description: >- Canonical Govly Place ids to exclude. Same matching rules as placeIds. dateRangeParam: type: string description: Which award date field the relative window applies to. relativeStartDayPivot: type: integer description: Window start, in days relative to today. Defaults to -365. relativeEndDayPivot: type: integer description: Window end, in days relative to today. Defaults to 0. responses: '201': description: Created award saved search content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/SavedSearch' '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' components: schemas: SavedSearch: type: object required: - id - name - searchableType properties: id: type: string name: type: string active: type: boolean searchableType: type: string enum: - Award - Contact description: Which corpus this saved search targets. criteria: type: object additionalProperties: true description: > The stored filter set. Keys are camelized on the way out like every other field, so they do not match the snake_case names a search request expects; convert before replaying them. createdAt: type: string format: date-time updatedAt: type: string format: date-time ErrorEnvelope: type: object required: - errors properties: errors: type: array items: type: object required: - status - code - title - detail properties: status: type: string code: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string responses: Error: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: bearerApiKey: type: http scheme: bearer bearerFormat: API key headerApiKey: type: apiKey in: header name: X-API-KEY ````