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.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
name
string
required
Display name for the saved search.
customFields
object[] | null
Patch organization-defined fields using keys and types returned in customFields. Omitted, null, or empty arrays preserve values. Each supplied key changes only that field; value null clears it. Unknown, archived, duplicate, or incorrectly typed fields reject the whole edit. Text identifiers retain leading zeros.
Show child attributes
query
string
Free-text search terms.
searchType
enum<string>
Market this search covers. Defaults to the caller's market focus and is stored, so it bounds every later replay.
Available options:
fed,
sled,
international
recipientNames
string[]
Recipient/vendor names to filter by.
buyerNames
string[]
Awarding buyer names.
funderNames
string[]
Funding agency names.
naics
string[]
NAICS codes to filter by.
psc
string[]
Product/service codes.
amountRange
number[]
[min, max] awarded amount.
Required array length: 2 elements
placeIds
string[]
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
string[]
Canonical Govly Place ids to exclude. Same matching rules as placeIds.
dateRangeParam
string
Which award date field the relative window applies to.
relativeStartDayPivot
integer
Window start, in days relative to today. Defaults to -365.
relativeEndDayPivot
integer
Window end, in days relative to today. Defaults to 0.
Response
Created award saved search
data
object
required
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Govly Developer Documentation","colors":{"primary":"#2D72D2","light":"#4C90F0","dark":"#252A31"},"logo":{"light":"https://mintcdn.com/govly/fiZJVi8g9yenM-kL/logo/light.svg?fit=max\u0026auto=format\u0026n=fiZJVi8g9yenM-kL\u0026q=85\u0026s=d66609a9754e369eff54b7f9bf198824","dark":"https://mintcdn.com/govly/fiZJVi8g9yenM-kL/logo/dark.svg?fit=max\u0026auto=format\u0026n=fiZJVi8g9yenM-kL\u0026q=85\u0026s=37d5fe8d09791ef8fe69aef6c20c5c00"},"favicon":"https://mintcdn.com/govly/ckcRaBILPVyWGu14/favicon.png?fit=max\u0026auto=format\u0026n=ckcRaBILPVyWGu14\u0026q=85\u0026s=bc8e0e5715a4f0fa93f492ef92fd0e56","api":{"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://app.govly.com"}},"navbar":{"links":[{"href":"mailto:support@govly.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.govly.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/govly"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"govly","hasAudioNarration":false,"actualSubdomain":"govly","customDomains":["docs.govly.com"],"gitSource":{"type":"github","owner":"govly","repo":"govly","deployBranch":"main","contentDirectory":"external_docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af21b028da4e23f58724d4a","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"Overview","count":109},{"language":"default","tag":"Enterprise","count":99},{"language":"default","tag":"Tools API Reference","count":78},{"language":"default","tag":"Saved Searches","count":15},{"language":"default","tag":"Opportunities","count":11},{"language":"default","tag":"Workspaces","count":11},{"language":"default","tag":"Enterprise API Reference","count":9},{"language":"default","tag":"Integrations","count":9},{"language":"default","tag":"Inbox","count":8},{"language":"default","tag":"Awards","count":6}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":""}],"page":{"pagePath":"api-reference/tools-v1/saved-searches/create-an-award-saved-search","slug":"/api-reference/tools-v1/saved-searches/create-an-award-saved-search","pageMetadata":{"title":"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.\n","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/awards/saved_searches","href":"/api-reference/tools-v1/saved-searches/create-an-award-saved-search","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"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.\n","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/awards/saved_searches","href":"/api-reference/tools-v1/saved-searches/create-an-award-saved-search","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Saved Searches"],"operationId":"create_award_saved_search","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.\n","requestBody":"1fd74c98-e3cb-488a-bf4b-297615294736","responses":{"201":"da1c462d-1590-4ed6-94ec-eb733f5a2e0b","400":"fa7ff86b-62e2-4844-a373-d9a3480dd5df","401":"96a79ef9-ff33-4edd-92b2-8051b892d747","403":"b7098f96-114d-4dd4-94c4-cc1e3b01ec03","422":"3a20fd9b-bf93-4abb-abef-77bd1042e41d","429":"b43e1328-4e3d-44fc-922c-071b8ce58787"},"method":"post","type":"path","servers":["431047c8-0434-446c-b875-ace9e6957c7d"],"security":["1e3d4134-78b6-49ac-b82d-e6c4ac056e8e","d57ba6ed-7bd4-4d90-88fc-2417e5ee121d"],"path":"/api/tools/v1/awards/saved_searches","baseUrlOptions":["https://app.govly.com"],"title":"Create an award saved search","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","description":"Display name for the saved search.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"customFields":{"oneOf":[{"type":"array","description":"Patch organization-defined fields using keys and types returned in customFields. Omitted, null, or empty arrays preserve values. Each supplied key changes only that field; value null clears it. Unknown, archived, duplicate, or incorrectly typed fields reject the whole edit. Text identifiers retain leading zeros.\n","items":{"type":"object","additionalProperties":false,"required":["key","value"],"properties":{"key":{"type":"string","isRequired":true,"uniqueKey":"customFields.oneOf.0.items.[INDEX].key","typeLabel":"string"},"value":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customFields.oneOf.0.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"number","isRequired":true,"uniqueKey":"customFields.oneOf.0.items.[INDEX].value.oneOf.1","typeLabel":"number"},{"type":"boolean","isRequired":true,"uniqueKey":"customFields.oneOf.0.items.[INDEX].value.oneOf.2","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"customFields.oneOf.0.items.[INDEX].value.oneOf.3","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customFields.oneOf.0.items.[INDEX].value","typeLabel":"string | number | boolean | null"}},"uniqueKey":"customFields.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"customFields.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Patch organization-defined fields using keys and types returned in customFields. Omitted, null, or empty arrays preserve values. Each supplied key changes only that field; value null clears it. Unknown, archived, duplicate, or incorrectly typed fields reject the whole edit. Text identifiers retain leading zeros.\n","items":{"type":"object","additionalProperties":false,"required":["key","value"],"properties":{"key":{"type":"string"},"value":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"uniqueKey":"customFields.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields","typeLabel":"object[] | null"},"query":{"type":"string","description":"Free-text search terms.","uniqueKey":"query","typeLabel":"string"},"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.\n","uniqueKey":"searchType","typeLabel":"enum\u003cstring>"},"recipientNames":{"type":"array","items":{"type":"string","uniqueKey":"recipientNames.items.[INDEX]","typeLabel":"string"},"description":"Recipient/vendor names to filter by.","uniqueKey":"recipientNames","typeLabel":"string[]"},"buyerNames":{"type":"array","items":{"type":"string","uniqueKey":"buyerNames.items.[INDEX]","typeLabel":"string"},"description":"Awarding buyer names.","uniqueKey":"buyerNames","typeLabel":"string[]"},"funderNames":{"type":"array","items":{"type":"string","uniqueKey":"funderNames.items.[INDEX]","typeLabel":"string"},"description":"Funding agency names.","uniqueKey":"funderNames","typeLabel":"string[]"},"naics":{"type":"array","items":{"type":"string","uniqueKey":"naics.items.[INDEX]","typeLabel":"string"},"description":"NAICS codes to filter by.","uniqueKey":"naics","typeLabel":"string[]"},"psc":{"type":"array","items":{"type":"string","uniqueKey":"psc.items.[INDEX]","typeLabel":"string"},"description":"Product/service codes.","uniqueKey":"psc","typeLabel":"string[]"},"amountRange":{"type":"array","items":{"type":"number","uniqueKey":"amountRange.items.[INDEX]","typeLabel":"number"},"minItems":2,"maxItems":2,"description":"[min, max] awarded amount.","uniqueKey":"amountRange","typeLabel":"number[]"},"placeIds":{"type":"array","items":{"type":"string","uniqueKey":"placeIds.items.[INDEX]","typeLabel":"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.\n","uniqueKey":"placeIds","typeLabel":"string[]"},"placeIdsNone":{"type":"array","items":{"type":"string","uniqueKey":"placeIdsNone.items.[INDEX]","typeLabel":"string"},"description":"Canonical Govly Place ids to exclude. Same matching rules as placeIds.","uniqueKey":"placeIdsNone","typeLabel":"string[]"},"dateRangeParam":{"type":"string","description":"Which award date field the relative window applies to.","uniqueKey":"dateRangeParam","typeLabel":"string"},"relativeStartDayPivot":{"type":"integer","description":"Window start, in days relative to today. Defaults to -365.","uniqueKey":"relativeStartDayPivot","typeLabel":"integer"},"relativeEndDayPivot":{"type":"integer","description":"Window end, in days relative to today. Defaults to 0.","uniqueKey":"relativeEndDayPivot","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","customFields":[{"key":"\u003cstring>","value":"\u003cstring>"}],"query":"\u003cstring>","recipientNames":["\u003cstring>"],"buyerNames":["\u003cstring>"],"funderNames":["\u003cstring>"],"naics":["\u003cstring>"],"psc":["\u003cstring>"],"amountRange":[123],"placeIds":["\u003cstring>"],"placeIdsNone":["\u003cstring>"],"dateRangeParam":"\u003cstring>","relativeStartDayPivot":123,"relativeEndDayPivot":123}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"da1c462d-1590-4ed6-94ec-eb733f5a2e0b":{"description":"Created award saved search","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","name","searchableType","followedByCurrentUser","createdByCurrentUser","createdByName"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"searchableType":{"type":"string","enum":["Award","Contact"],"description":"Which corpus this saved search targets.","isRequired":true,"uniqueKey":"data.searchableType","typeLabel":"enum\u003cstring>"},"followedByCurrentUser":{"type":"boolean","description":"True when the requesting user follows this search, directly or through one of their teams.","isRequired":true,"uniqueKey":"data.followedByCurrentUser","typeLabel":"boolean"},"createdByCurrentUser":{"type":"boolean","description":"True when the requesting user created this search.","isRequired":true,"uniqueKey":"data.createdByCurrentUser","typeLabel":"boolean"},"createdByName":{"oneOf":[{"type":"string","description":"Name of the user who created this search, or null when no creator is recorded.","isRequired":true,"uniqueKey":"data.createdByName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the user who created this search, or null when no creator is recorded.","isRequired":true,"uniqueKey":"data.createdByName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.createdByName","typeLabel":"string | null"},"customFields":{"type":"array","items":{"type":"object","required":["key","name","fieldType","value"],"properties":{"key":{"type":"string","description":"Stable organization-defined integration key; never case-converted.","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].key","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].name","typeLabel":"string"},"fieldType":{"type":"string","enum":["text","number","boolean"],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].fieldType","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"number","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].value.oneOf.1","typeLabel":"number"},{"type":"boolean","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].value.oneOf.2","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].value.oneOf.3","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].value","typeLabel":"string | number | boolean | null"}},"uniqueKey":"data.customFields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.customFields","typeLabel":"object[]"},"active":{"type":"boolean","uniqueKey":"data.active","typeLabel":"boolean"},"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.\n","uniqueKey":"data.criteria","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","name":"\u003cstring>","searchableType":"Award","followedByCurrentUser":true,"createdByCurrentUser":true,"createdByName":"\u003cstring>","customFields":[{"key":"\u003cstring>","name":"\u003cstring>","fieldType":"text","value":"\u003cstring>"}],"active":true,"criteria":{},"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"fa7ff86b-62e2-4844-a373-d9a3480dd5df":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"type":"object","required":["status","code","title","detail"],"properties":{"status":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"\u003cstring>","code":"\u003cstring>","title":"\u003cstring>","detail":"\u003cstring>","source":{"pointer":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"96a79ef9-ff33-4edd-92b2-8051b892d747":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"type":"object","required":["status","code","title","detail"],"properties":{"status":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"\u003cstring>","code":"\u003cstring>","title":"\u003cstring>","detail":"\u003cstring>","source":{"pointer":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"b7098f96-114d-4dd4-94c4-cc1e3b01ec03":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"type":"object","required":["status","code","title","detail"],"properties":{"status":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"\u003cstring>","code":"\u003cstring>","title":"\u003cstring>","detail":"\u003cstring>","source":{"pointer":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"3a20fd9b-bf93-4abb-abef-77bd1042e41d":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"type":"object","required":["status","code","title","detail"],"properties":{"status":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].source.pointer","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"\u003cstring>","code":"\u003cstring>","title":"\u003cstring>","detail":"\u003cstring>","source":{"pointer":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"b43e1328-4e3d-44fc-922c-071b8ce58787":{"description":"Too many requests. Two limiters can produce this status and they use different bodies. The per-user limit of 70 requests per minute for each resource returns the standard error envelope with `code: rate_limited` and a `Retry-After` header. Keys sent in the `X-API-KEY` header are also subject to the Enterprise API limit of 300 requests per minute per key, which returns the plain `error` form with `Retry-After` and the `X-RateLimit-*` headers. Clients should accept either body.\n","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"type":"object","required":["status","code","title","detail"],"properties":{"status":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].status","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].code","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].title","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].detail","typeLabel":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string","uniqueKey":"oneOf.0.errors.items.[INDEX].source.pointer","typeLabel":"string"}},"uniqueKey":"oneOf.0.errors.items.[INDEX].source","typeLabel":"object"}},"uniqueKey":"oneOf.0.errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.errors","typeLabel":"object[]"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"status":"\u003cstring>","code":"\u003cstring>","title":"\u003cstring>","detail":"\u003cstring>","source":{"pointer":"\u003cstring>"}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1e3d4134-78b6-49ac-b82d-e6c4ac056e8e":{"bearerApiKey":{"type":"http","scheme":"bearer","bearerFormat":"API key","scopes":[],"schemeName":"bearerApiKey"}},"d57ba6ed-7bd4-4d90-88fc-2417e5ee121d":{"headerApiKey":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"headerApiKey"}}},"servers":{"431047c8-0434-446c-b875-ace9e6957c7d":{"url":"https://app.govly.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API key","scopes":[],"schemeName":"bearerApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerApiKey","name":"Authorization"}],"title":"bearerApiKey"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"headerApiKey"},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"headerApiKey","name":"X-API-KEY"}],"title":"headerApiKey"}]},"originalFileLocation":"openapi/tools-v1.yaml"},"subdomain":"govly","siteName":"Govly Developer Documentation","title":"Create an award saved search - Govly Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T19:12:13.387Z","originalFileLocation":"api-reference/tools-v1/saved-searches/create-an-award-saved-search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Govly Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an award saved search - Govly Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Govly Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://govly.mintlify.site/_mintlify/api/og/v2?division=Saved+Searches\u0026amp;title=Create+an+award+saved+search\u0026amp;description=Saves+a+set+of+award+search+criteria+as+a+replayable+search.+Award+saved+searches+do+not+send+notifications+%E2%80%94+run+one+any+time+with+the+results+endpoint.+The+da\u0026amp;theme=d87f0cb11f6760e6b1a4ee96\u0026amp;signature=fe130c05fe3c0c63ce936229761b45566b185b1af294aba9e76c15174c820115\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create an award saved search - Govly Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://govly.mintlify.site/_mintlify/api/og/v2?division=Saved+Searches\u0026amp;title=Create+an+award+saved+search\u0026amp;description=Saves+a+set+of+award+search+criteria+as+a+replayable+search.+Award+saved+searches+do+not+send+notifications+%E2%80%94+run+one+any+time+with+the+results+endpoint.+The+da\u0026amp;theme=d87f0cb11f6760e6b1a4ee96\u0026amp;signature=fe130c05fe3c0c63ce936229761b45566b185b1af294aba9e76c15174c820115\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/govly/tLEtLkgSI5N0MGS1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Govly Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2D72D2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tools-v1/saved-searches/create-an-award-saved-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.govly.com/#organization\",\"name\":\"Govly Developer Documentation\",\"url\":\"https://docs.govly.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/govly/fiZJVi8g9yenM-kL/logo/light.svg?fit=max\u0026auto=format\u0026n=fiZJVi8g9yenM-kL\u0026q=85\u0026s=d66609a9754e369eff54b7f9bf198824\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.govly.com#website\",\"name\":\"Govly Developer Documentation\",\"url\":\"https://docs.govly.com\",\"publisher\":{\"@id\":\"https://docs.govly.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search#webpage\",\"url\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search\",\"name\":\"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.\",\"dateModified\":\"2026-11-09T19:12:13.387Z\",\"isPartOf\":{\"@id\":\"https://docs.govly.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Enterprise\",\"item\":\"https://docs.govly.com/enterprise/email-integration\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tools API Reference\",\"item\":\"https://docs.govly.com/api-reference/tools-v1/organization-users/list-users-in-your-govly-organization\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Saved Searches\",\"item\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/list-award-saved-searches\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Create an award saved search\",\"item\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search#apireference\",\"headline\":\"Create an award saved search\",\"name\":\"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.\",\"url\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.govly.com/api-reference/tools-v1/saved-searches/create-an-award-saved-search#webpage\"},\"dateModified\":\"2026-11-09T19:12:13.387Z\",\"publisher\":{\"@id\":\"https://docs.govly.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.govly.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Govly Developer Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Govly Developer Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/tools-v1/saved-searches/create-an-award-saved-search.md","siteName":"Govly Developer Documentation","nav":{"global":null,"tabs":[{"tab":"Overview","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/getting-started/introduction"}]},{"group":"Integrations","pages":[{"title":"Salesforce Integration","href":"/enterprise/integrations/sfdc"},{"title":"HubSpot Integration","href":"/enterprise/integrations/hubspot"},{"group":"MCP","pages":[{"title":"MCP Overview","href":"/enterprise/integrations/mcp"},{"title":"Connect to Claude","href":"/enterprise/integrations/mcp/claude"},{"title":"MCP for Developers","href":"/enterprise/integrations/mcp/developers"}]},{"title":"Single Sign-On (SSO)","href":"/enterprise/integrations/sso"},{"group":"Webhooks","pages":[{"title":"Webhooks Overview","href":"/api-reference/enterprise/webhooks/overview"},{"title":"Webhook Events","href":"/webhooks/events"},{"title":"Webhook Security","href":"/webhooks/security"}]}]},{"group":"Enterprise","pages":[{"group":"Contract Ingestion","pages":[{"title":"Email Integration","href":"/enterprise/email-integration"},{"title":"Web Automation","href":"/enterprise/web-automation"}]},{"group":"Security and Privacy","pages":[{"title":"Overview","href":"/enterprise/security"},{"title":"Opportunity Attachment Handling","href":"/enterprise/security/restricted-opportunity-attachments"},{"title":"Secure Enclave","href":"/enterprise/security/secure-enclave"},{"title":"SOC 2","href":"/enterprise/security/soc2"}]},{"group":"Enterprise API Reference","pages":[{"title":"Rate Limits","href":"/api-reference/enterprise/rate-limits"},{"title":"Errors","href":"/api-reference/enterprise/errors"},{"group":"Opportunities","pages":[{"title":"List opportunities by ID","api":"GET /api/enterprise/opportunities","href":"/api-reference/enterprise/opportunities/list"},{"group":"Saved Searches","pages":[{"title":"List Saved Searches","api":"GET /api/enterprise/opportunities/saved_searches","href":"/api-reference/enterprise/opportunities/saved_searches/list"},{"title":"Execute a search on a saved search","api":"GET /api/enterprise/opportunities/saved_searches/{id}/search","href":"/api-reference/enterprise/opportunities/saved_searches/search"},{"title":"List saved search matches","api":"GET /api/enterprise/opportunities/saved_search_matches","href":"/api-reference/enterprise/opportunities/saved_search_matches/list"}]}]},{"group":"Awards","pages":[{"title":"List awards","api":"GET /api/enterprise/awards","href":"/api-reference/enterprise/awards/list"},{"group":"Saved Searches","pages":[{"title":"List Saved Searches","api":"GET /api/enterprise/awards/saved_searches","href":"/api-reference/enterprise/awards/saved_searches/list"},{"title":"Execute a search on a saved search","api":"GET /api/enterprise/awards/saved_searches/{id}/search","href":"/api-reference/enterprise/awards/saved_searches/search"}]}]}]},{"group":"Tools API Reference","pages":[{"group":"Organization Users","pages":[{"title":"List users in your Govly organization","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/organization_users","href":"/api-reference/tools-v1/organization-users/list-users-in-your-govly-organization"}]},{"group":"Opportunities","pages":[{"title":"Fetch opportunities by ID","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/opportunities","href":"/api-reference/tools-v1/opportunities/fetch-opportunities-by-id"},{"title":"Show an opportunity","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/opportunities/{id}","href":"/api-reference/tools-v1/opportunities/show-an-opportunity"},{"title":"Search opportunities","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/opportunities/search","href":"/api-reference/tools-v1/opportunities/search-opportunities"},{"title":"Mark an opportunity not interested","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/opportunities/{opportunityId}/not_interested","href":"/api-reference/tools-v1/opportunities/mark-an-opportunity-not-interested"},{"title":"Undo a not-interested mark","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml delete /api/tools/v1/opportunities/{opportunityId}/not_interested","href":"/api-reference/tools-v1/opportunities/undo-a-not-interested-mark"}]},{"group":"Awards","pages":[{"title":"Show an award","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/awards/{id}","href":"/api-reference/tools-v1/awards/show-an-award"},{"title":"Search awards","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/awards/search","href":"/api-reference/tools-v1/awards/search-awards"},{"title":"Aggregate awards by one dimension","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/awards/aggregate","href":"/api-reference/tools-v1/awards/aggregate-awards-by-one-dimension"}]},{"group":"Contacts","pages":[{"title":"Show a contact","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/contacts/{id}","href":"/api-reference/tools-v1/contacts/show-a-contact"},{"title":"Search contacts","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/contacts/search","href":"/api-reference/tools-v1/contacts/search-contacts"}]},{"group":"Places","pages":[{"title":"Resolve place names to canonical Place ids","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/places/search","href":"/api-reference/tools-v1/places/resolve-place-names-to-canonical-place-ids"},{"title":"Enumerate every Place of a category within a jurisdiction","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/places/list","href":"/api-reference/tools-v1/places/enumerate-every-place-of-a-category-within-a-jurisdiction"}]},{"group":"Signals","pages":[{"title":"Show a signal cluster","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/signals/{id}","href":"/api-reference/tools-v1/signals/show-a-signal-cluster"},{"title":"Search signals","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/signals/search","href":"/api-reference/tools-v1/signals/search-signals"}]},{"group":"Product Catalogs","pages":[{"title":"List public product catalogs","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/product_catalogs","href":"/api-reference/tools-v1/product-catalogs/list-public-product-catalogs"},{"title":"Search product catalog items","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/product_catalogs/search","href":"/api-reference/tools-v1/product-catalogs/search-product-catalog-items"}]},{"group":"Workspaces","pages":[{"title":"List workspaces associated with an entity","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/workspaces","href":"/api-reference/tools-v1/workspaces/list-workspaces-associated-with-an-entity"},{"title":"Create a workspace","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/workspaces","href":"/api-reference/tools-v1/workspaces/create-a-workspace"},{"title":"List saved Workspace views","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/workspace_views","href":"/api-reference/tools-v1/workspaces/list-saved-workspace-views"},{"title":"Dismiss workspaces for yourself","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/workspace_dismissals","href":"/api-reference/tools-v1/workspaces/dismiss-workspaces-for-yourself"},{"title":"Restore workspaces you dismissed","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml delete /api/tools/v1/workspace_dismissals","href":"/api-reference/tools-v1/workspaces/restore-workspaces-you-dismissed"},{"title":"Search active workspaces","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/workspaces/search","href":"/api-reference/tools-v1/workspaces/search-active-workspaces"},{"title":"Show a workspace","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/workspaces/{id}","href":"/api-reference/tools-v1/workspaces/show-a-workspace"},{"title":"Update a workspace","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml patch /api/tools/v1/workspaces/{id}","href":"/api-reference/tools-v1/workspaces/update-a-workspace"}]},{"group":"Workspace Members","pages":[{"title":"Add a user or team member to a workspace","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/workspaces/{workspaceId}/members","href":"/api-reference/tools-v1/workspace-members/add-a-user-or-team-member-to-a-workspace"},{"title":"Remove a user or team member from a workspace","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml delete /api/tools/v1/workspaces/{workspaceId}/members","href":"/api-reference/tools-v1/workspace-members/remove-a-user-or-team-member-from-a-workspace"}]},{"group":"Workflows","pages":[{"title":"Find workflows in your organization","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/workflows","href":"/api-reference/tools-v1/workflows/find-workflows-in-your-organization"},{"title":"List the current files attached to a workflow","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/workflows/{workflowId}/attachments","href":"/api-reference/tools-v1/workflows/list-the-current-files-attached-to-a-workflow"},{"title":"Upload workflow files as an organization admin","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/workflows/{workflowId}/attachments","href":"/api-reference/tools-v1/workflows/upload-workflow-files-as-an-organization-admin"},{"title":"Remove a workflow file as an organization admin","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml delete /api/tools/v1/workflows/{workflowId}/attachments/{attachmentId}","href":"/api-reference/tools-v1/workflows/remove-a-workflow-file-as-an-organization-admin"},{"title":"Open a workflow file after checking current access","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/workflows/{workflowId}/attachments/{attachmentId}/file","href":"/api-reference/tools-v1/workflows/open-a-workflow-file-after-checking-current-access"}]},{"group":"Libraries","pages":[{"title":"List accessible Libraries","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/libraries","href":"/api-reference/tools-v1/libraries/list-accessible-libraries"},{"title":"Create an additional Library","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/libraries","href":"/api-reference/tools-v1/libraries/create-an-additional-library"},{"title":"Get Library metadata","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/libraries/{id}","href":"/api-reference/tools-v1/libraries/get-library-metadata"},{"title":"Replace a Library description","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml patch /api/tools/v1/libraries/{id}","href":"/api-reference/tools-v1/libraries/replace-a-library-description"}]},{"group":"Library Documents","pages":[{"title":"List documents in a selected Library","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/libraries/{libraryId}/documents","href":"/api-reference/tools-v1/library-documents/list-documents-in-a-selected-library"},{"title":"Get a Library document's metadata","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/libraries/{libraryId}/documents/{id}","href":"/api-reference/tools-v1/library-documents/get-a-library-documents-metadata"},{"title":"Archive a Library document","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml delete /api/tools/v1/libraries/{libraryId}/documents/{id}","href":"/api-reference/tools-v1/library-documents/archive-a-library-document"},{"title":"Update a Library document's title or tags","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml patch /api/tools/v1/libraries/{libraryId}/documents/{id}","href":"/api-reference/tools-v1/library-documents/update-a-library-documents-title-or-tags"}]},{"group":"File Attachments","pages":[{"title":"Attach a new or existing file to a supported destination","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/file_attachments","href":"/api-reference/tools-v1/file-attachments/attach-a-new-or-existing-file-to-a-supported-destination"}]},{"group":"Workspace Attachments","pages":[{"title":"Send file bytes to a signed Govly upload URL","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/upload_files","href":"/api-reference/tools-v1/workspace-attachments/send-file-bytes-to-a-signed-govly-upload-url"},{"title":"List workspace attachments","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/workspaces/{workspaceId}/attachments","href":"/api-reference/tools-v1/workspace-attachments/list-workspace-attachments"},{"title":"Upload workspace attachments","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/workspaces/{workspaceId}/attachments","href":"/api-reference/tools-v1/workspace-attachments/upload-workspace-attachments"}]},{"group":"Workspace Comments","pages":[{"title":"Post a Markdown comment to a workspace","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/workspaces/{workspaceId}/comments","href":"/api-reference/tools-v1/workspace-comments/post-a-markdown-comment-to-a-workspace"}]},{"group":"Organization Labels","pages":[{"title":"List organization labels","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/organization_labels","href":"/api-reference/tools-v1/organization-labels/list-organization-labels"},{"title":"Create an organization label","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/organization_labels","href":"/api-reference/tools-v1/organization-labels/create-an-organization-label"},{"title":"Delete an organization label","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml delete /api/tools/v1/organization_labels/{id}","href":"/api-reference/tools-v1/organization-labels/delete-an-organization-label"},{"title":"Update an organization label","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml patch /api/tools/v1/organization_labels/{id}","href":"/api-reference/tools-v1/organization-labels/update-an-organization-label"}]},{"group":"Record Labels","pages":[{"title":"Apply labels to a record","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/record_labels","href":"/api-reference/tools-v1/record-labels/apply-labels-to-a-record"},{"title":"Remove labels from a record","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml delete /api/tools/v1/record_labels","href":"/api-reference/tools-v1/record-labels/remove-labels-from-a-record"}]},{"group":"Follows","pages":[{"title":"Follow a Govly entity","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/follows","href":"/api-reference/tools-v1/follows/follow-a-govly-entity"},{"title":"Unfollow a Govly entity","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml delete /api/tools/v1/follows","href":"/api-reference/tools-v1/follows/unfollow-a-govly-entity"}]},{"group":"Shares","pages":[{"title":"Share an opportunity, award, or contact by email","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/shares","href":"/api-reference/tools-v1/shares/share-an-opportunity-award-or-contact-by-email"}]},{"group":"Saved Searches","pages":[{"title":"List award saved searches","description":null,"deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/awards/saved_searches","href":"/api-reference/tools-v1/saved-searches/list-award-saved-searches"},{"title":"Create an award saved search","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/awards/saved_searches","href":"/api-reference/tools-v1/saved-searches/create-an-award-saved-search"},{"title":"Show an award saved search","description":null,"deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/awards/saved_searches/{id}","href":"/api-reference/tools-v1/saved-searches/show-an-award-saved-search"},{"title":"Update an award saved search","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml patch /api/tools/v1/awards/saved_searches/{id}","href":"/api-reference/tools-v1/saved-searches/update-an-award-saved-search"},{"title":"Execute an award saved search","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/awards/saved_searches/{savedSearchId}/results","href":"/api-reference/tools-v1/saved-searches/execute-an-award-saved-search"},{"title":"List opportunity saved searches","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/opportunities/saved_searches","href":"/api-reference/tools-v1/saved-searches/list-opportunity-saved-searches"},{"title":"Create an opportunity saved search","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/opportunities/saved_searches","href":"/api-reference/tools-v1/saved-searches/create-an-opportunity-saved-search"},{"title":"Show an opportunity saved search","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/opportunities/saved_searches/{id}","href":"/api-reference/tools-v1/saved-searches/show-an-opportunity-saved-search"},{"title":"Update an opportunity saved search","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml patch /api/tools/v1/opportunities/saved_searches/{id}","href":"/api-reference/tools-v1/saved-searches/update-an-opportunity-saved-search"},{"title":"List cached opportunity results for a saved search","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/opportunities/saved_searches/{savedSearchId}/results","href":"/api-reference/tools-v1/saved-searches/list-cached-opportunity-results-for-a-saved-search"}]},{"group":"Documents","pages":[{"title":"Read bounded document content","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/documents/read","href":"/api-reference/tools-v1/documents/read-bounded-document-content"},{"title":"Get a temporary original-file download","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/documents/download","href":"/api-reference/tools-v1/documents/get-a-temporary-original-file-download"}]},{"group":"Quote Submissions","pages":[{"title":"Check quote submission requirements","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/quote/submissions/requirements","href":"/api-reference/tools-v1/quote-submissions/check-quote-submission-requirements"},{"title":"List quote submissions for a workspace","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/quote/submissions","href":"/api-reference/tools-v1/quote-submissions/list-quote-submissions-for-a-workspace"},{"title":"Submit a quote","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/quote/submissions","href":"/api-reference/tools-v1/quote-submissions/submit-a-quote"},{"title":"Show quote submission status","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/quote/submissions/{id}","href":"/api-reference/tools-v1/quote-submissions/show-quote-submission-status"}]},{"group":"Inbox","pages":[{"title":"List saved Inbox views","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/inbox_views","href":"/api-reference/tools-v1/inbox/list-saved-inbox-views"},{"title":"List inbox items","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/inbox_items","href":"/api-reference/tools-v1/inbox/list-inbox-items"},{"title":"Search inbox items","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/inbox_items/search","href":"/api-reference/tools-v1/inbox/search-inbox-items"},{"title":"Show an inbox item","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml get /api/tools/v1/inbox_items/{id}","href":"/api-reference/tools-v1/inbox/show-an-inbox-item"},{"title":"Accept an inbox item","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/inbox_items/{id}/accept","href":"/api-reference/tools-v1/inbox/accept-an-inbox-item"},{"title":"Dismiss an inbox item","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/inbox_items/{id}/dismiss","href":"/api-reference/tools-v1/inbox/dismiss-an-inbox-item"},{"title":"Decline (reject) an inbox item as a bad fit","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/inbox_items/{id}/decline","href":"/api-reference/tools-v1/inbox/decline-reject-an-inbox-item-as-a-bad-fit"},{"title":"Restore a dismissed or declined inbox item","deprecated":null,"version":null,"openapi":"/openapi/tools-v1.yaml post /api/tools/v1/inbox_items/{id}/restore","href":"/api-reference/tools-v1/inbox/restore-a-dismissed-or-declined-inbox-item"}]}]},{"group":"Legacy API Reference (v3)","pages":[{"group":"Opportunities","pages":[{"title":"Get Opportunity","api":"GET /api/v3/opportunities/{id}","href":"/api-reference/v3/opportunities/get"},{"title":"Filter Opportunities","api":"POST /api/v3/opportunities/filter","href":"/api-reference/v3/opportunities/filter"}]},{"group":"Workspaces","pages":[{"title":"Get Workspace","api":"GET /api/v3/opportunity_workspaces/{id}","href":"/api-reference/v3/workspaces/get"},{"title":"Create Workspace","api":"POST /api/v3/opportunity_workspaces","href":"/api-reference/v3/workspaces/create"},{"title":"Update Workspace","api":"PATCH /api/v3/opportunity_workspaces/{id}","href":"/api-reference/v3/workspaces/update"}]},{"group":"Contract Vehicles","pages":[{"title":"List Contract Vehicles","api":"GET /api/v3/contract_vehicles","href":"/api-reference/v3/contract-vehicles/list"}]}]}]}]}]},"basePath":"","title":"Create an award saved search - Govly Developer Documentation","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DbeN8Wo6.js","utils-CwSb5Doc.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BmREeM3N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-AYjWerCj.js","snippetPresets-QD4ULQlp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Digj5cjF.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CiHrzluR.js","shallow-D7h7pFGg.js","getApiPlaygroundDisplay-mlxkpAUf.js","CodeSnippet-D2rH5lZI.js","CodeSnippets-B53ulOaL.js","Page-CqcDm2To.js","getPastedJson-DxGeNMih.js","icon-BHbyrebp.js","MethodPill-C7F_KEEJ.js","DuplicateIcon-j3c5-73z.js","createIcon-OvCnyFqD.js","DynamicMarkdown-DpAS3GCb.js","SectionHeading-DMPpdrvW.js","axios-vUo_bRtp.js","Markdown-D7pDRguu.js","clsx-2_c6mSt_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cu7_SikL.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ydqCcy4b.js"]}