{"openapi":"3.1.0","info":{"title":"DuckDuckGo API (Bowmark)","version":"e833508f87ff","description":"DuckDuckGo (duckduckgo.com) — private web, image, video, news and maps search, Instant Answers, autocomplete, the dictionary, currency, weather, time and translation answers, !bangs, and Duck.ai chat; once a caller signs in, their Email Protection @duck.com addresses.\n\nEvery function Bowmark has for DuckDuckGo (duckduckgo.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/duckduckgo/chatWithDuckAi":{"post":{"operationId":"chatWithDuckAi","summary":"Sends one message to Duck.ai, DuckDuckGo's free private AI chat, and returns the model's full reply.","description":"Sends one message to Duck.ai, DuckDuckGo's free private AI chat, and returns the model's full reply. Pick a free model from listDuckAiModels (entityHasAccess true); omit model for Duck.ai's default. Drives a real browser, so expect ~20-40s.\n\nCalls `bowmark.providers.duckduckgo.chatWithDuckAi`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckAiReply>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ChatWithDuckAiArgs","description":"TypeScript: `ChatWithDuckAiArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/getEmailProtectionAccount":{"post":{"operationId":"getEmailProtectionAccount","summary":"Reads the signed-in caller's DuckDuckGo Email Protection account — their permanent @duck.com address, the inbox it forwards to, and the private address that will be handed out next.","description":"Reads the signed-in caller's DuckDuckGo Email Protection account — their permanent @duck.com address, the inbox it forwards to, and the private address that will be handed out next. NEEDS A SIGN-IN through the relay.\n\nCalls `bowmark.providers.duckduckgo.getEmailProtectionAccount`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoEmailProtectionAccount>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/createPrivateDuckAddress":{"post":{"operationId":"createPrivateDuckAddress","summary":"Generates a brand new private @duck.com address on the signed-in caller's Email Protection account, forwarding to their inbox.","description":"Generates a brand new private @duck.com address on the signed-in caller's Email Protection account, forwarding to their inbox. Not idempotent — each call mints another address, up to DuckDuckGo's own cap of 30 per day. NEEDS A SIGN-IN through the relay.\n\nCalls `bowmark.providers.duckduckgo.createPrivateDuckAddress`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoCreatedPrivateAddress>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/setPrivateDuckAddressActive":{"post":{"operationId":"setPrivateDuckAddressActive","summary":"Turns one private @duck.com address off (stop forwarding) or back on, using the deactivate/reactivate link at the foot of a mail DuckDuckGo forwarded — pass the `link`, or its `address` and `addressTo","description":"Turns one private @duck.com address off (stop forwarding) or back on, using the deactivate/reactivate link at the foot of a mail DuckDuckGo forwarded — pass the `link`, or its `address` and `addressToken`, plus `active`. No sign-in needed; the link's one-time token is the authorization.\n\nCalls `bowmark.providers.duckduckgo.setPrivateDuckAddressActive`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoPrivateAddressState>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SetPrivateDuckAddressActiveArgs","description":"TypeScript: `SetPrivateDuckAddressActiveArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/changeForwardingAddress":{"post":{"operationId":"changeForwardingAddress","summary":"Changes the signed-in caller's @duck.com forwarding address — a two-step flow.","description":"Changes the signed-in caller's @duck.com forwarding address — a two-step flow. Call with just `newEmail` to start it (DuckDuckGo emails a one-time code); call again with the same `newEmail` plus that `otp` and the `hash` the first call returned to confirm it. NEEDS A SIGN-IN through the relay.\n\nCalls `bowmark.providers.duckduckgo.changeForwardingAddress`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoForwardingChangeResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ChangeForwardingAddressArgs","description":"TypeScript: `ChangeForwardingAddressArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/searchNews":{"post":{"operationId":"searchNews","summary":"Search DuckDuckGo News vertical and returns news stories.","description":"Search DuckDuckGo News vertical and returns news stories.\n\nCalls `bowmark.providers.duckduckgo.searchNews`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoNewsStory[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SearchNewsArgs","description":"TypeScript: `SearchNewsArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/searchWeb":{"post":{"operationId":"searchWeb","summary":"Searches the web the way duckduckgo.com's own search box does and returns the ranked organic results (ads skipped) — title, destination URL, display URL, DuckDuckGo's snippet and a date when it shows ","description":"Searches the web the way duckduckgo.com's own search box does and returns the ranked organic results (ads skipped) — title, destination URL, display URL, DuckDuckGo's snippet and a date when it shows one — about ten per page; a trustworthy first page short of that is topped up with one more free request to this engine's own next page before answering. Optional `region` (\"us-en\", \"uk-en\", \"wt-wt\"…), `safeSearch` and `time` filters; pass the returned `next` back as `cursor` for the following page. `substituted` is true when these rows look like an answer to a different query than the one asked, or no trustworthy answer at all — an empty page, no row sharing a query word, or the query's identity words mostly absent.\n\nCalls `bowmark.providers.duckduckgo.searchWeb`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoSearchWebResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/DuckDuckGoSearchWebArgs","description":"TypeScript: `DuckDuckGoSearchWebArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/searchVideos":{"post":{"operationId":"searchVideos","summary":"Searches DuckDuckGo's Videos vertical and returns each hit's title, page URL (usually YouTube), description, duration, publisher, uploader, publish date, view count and thumbnail — about 60 per page.","description":"Searches DuckDuckGo's Videos vertical and returns each hit's title, page URL (usually YouTube), description, duration, publisher, uploader, publish date, view count and thumbnail — about 60 per page. Pass the returned `next` back as `cursor` for the following page.\n\nCalls `bowmark.providers.duckduckgo.searchVideos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SearchVideosResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SearchVideosArgs","description":"TypeScript: `SearchVideosArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/searchPlaces":{"post":{"operationId":"searchPlaces","summary":"Searches DuckDuckGo's Maps vertical for places and returns each location's name, URL, address, phone number, coordinates, rating and hours of operation — about 19 per page.","description":"Searches DuckDuckGo's Maps vertical for places and returns each location's name, URL, address, phone number, coordinates, rating and hours of operation — about 19 per page. Optional `near` (a place name such as `Manhattan, New York`) steers the results; coordinates are not accepted. Pass the returned `next` back as `cursor` for the following page.\n\nCalls `bowmark.providers.duckduckgo.searchPlaces`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SearchPlacesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SearchPlacesArgs","description":"TypeScript: `SearchPlacesArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/searchImages":{"post":{"operationId":"searchImages","summary":"Searches DuckDuckGo's Images vertical and returns each result's title, page URL, direct image URL, thumbnail, dimensions, and source site.","description":"Searches DuckDuckGo's Images vertical and returns each result's title, page URL, direct image URL, thumbnail, dimensions, and source site. Pass the returned `next` back as `cursor` for the following page.\n\nCalls `bowmark.providers.duckduckgo.searchImages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SearchImagesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SearchImagesArgs","description":"TypeScript: `SearchImagesArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/getInstantAnswer":{"post":{"operationId":"getInstantAnswer","summary":"Gets DuckDuckGo's Instant Answer panel for a topic — the Wikipedia-style abstract and its source, DuckDuckGo's own zero-click answer when it has one, a headline definition, and related topics.","description":"Gets DuckDuckGo's Instant Answer panel for a topic — the Wikipedia-style abstract and its source, DuckDuckGo's own zero-click answer when it has one, a headline definition, and related topics. Fields are `null` when DuckDuckGo has nothing for that slot.\n\nCalls `bowmark.providers.duckduckgo.getInstantAnswer`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoInstantAnswer>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetInstantAnswerArgs","description":"TypeScript: `GetInstantAnswerArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/suggestQueries":{"post":{"operationId":"suggestQueries","summary":"Returns the search box's own autocomplete suggestions for a partial query, most-likely first.","description":"Returns the search box's own autocomplete suggestions for a partial query, most-likely first.\n\nCalls `bowmark.providers.duckduckgo.suggestQueries`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<string[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SuggestQueriesArgs","description":"TypeScript: `SuggestQueriesArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/defineWord":{"post":{"operationId":"defineWord","summary":"Looks a word up the way DuckDuckGo's dictionary answer does — one entry per sense, each with its part of speech, definition text and which dictionary it came from (American Heritage via Wordnik).","description":"Looks a word up the way DuckDuckGo's dictionary answer does — one entry per sense, each with its part of speech, definition text and which dictionary it came from (American Heritage via Wordnik).\n\nCalls `bowmark.providers.duckduckgo.defineWord`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoDefinition[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/DefineWordArgs","description":"TypeScript: `DefineWordArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/convertCurrency":{"post":{"operationId":"convertCurrency","summary":"Converts an amount between two currencies at DuckDuckGo's current mid-market rate (sourced from xe.com), with the rate's timestamp.","description":"Converts an amount between two currencies at DuckDuckGo's current mid-market rate (sourced from xe.com), with the rate's timestamp.\n\nCalls `bowmark.providers.duckduckgo.convertCurrency`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoCurrencyConversion>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ConvertCurrencyArgs","description":"TypeScript: `ConvertCurrencyArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/getWeather":{"post":{"operationId":"getWeather","summary":"Gets current conditions, an hourly outlook and a multi-day forecast for a place, the way DuckDuckGo's weather answer does (sourced from Apple WeatherKit).","description":"Gets current conditions, an hourly outlook and a multi-day forecast for a place, the way DuckDuckGo's weather answer does (sourced from Apple WeatherKit). Metric units throughout.\n\nCalls `bowmark.providers.duckduckgo.getWeather`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoWeather>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetWeatherArgs","description":"TypeScript: `GetWeatherArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/getLocalTime":{"post":{"operationId":"getLocalTime","summary":"Gets the current local time, UTC offset and time zone name in a city, the way DuckDuckGo's time answer does.","description":"Gets the current local time, UTC offset and time zone name in a city, the way DuckDuckGo's time answer does.\n\nCalls `bowmark.providers.duckduckgo.getLocalTime`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoLocalTime>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetLocalTimeArgs","description":"TypeScript: `GetLocalTimeArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/listBangs":{"post":{"operationId":"listBangs","summary":"Lists DuckDuckGo's !bangs — the shortcut, the site it searches and its category — filtered by a word so a caller can find the bang for a site; omit the filter for the highest-relevance bangs overall.","description":"Lists DuckDuckGo's !bangs — the shortcut, the site it searches and its category — filtered by a word so a caller can find the bang for a site; omit the filter for the highest-relevance bangs overall.\n\nCalls `bowmark.providers.duckduckgo.listBangs`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoBang[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ListBangsArgs","description":"TypeScript: `ListBangsArgs`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/resolveBang":{"post":{"operationId":"resolveBang","summary":"Turns a !bang query (\"!w duck\", \"usb-c cable !a\") into the destination URL DuckDuckGo would redirect to, by resolving the trigger against the live !bang directory.","description":"Turns a !bang query (\"!w duck\", \"usb-c cable !a\") into the destination URL DuckDuckGo would redirect to, by resolving the trigger against the live !bang directory.\n\nCalls `bowmark.providers.duckduckgo.resolveBang`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoBangResolution>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ResolveBangArgs","description":"TypeScript: `ResolveBangArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/listRegions":{"post":{"operationId":"listRegions","summary":"Lists every search region DuckDuckGo offers — the code (\"us-en\", \"uk-en\", \"wt-wt\" for all regions…) and its name — so a caller can pick a valid `region` for searchWeb and the other search functions.","description":"Lists every search region DuckDuckGo offers — the code (\"us-en\", \"uk-en\", \"wt-wt\" for all regions…) and its name — so a caller can pick a valid `region` for searchWeb and the other search functions.\n\nCalls `bowmark.providers.duckduckgo.listRegions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoRegion[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/listDuckAiModels":{"post":{"operationId":"listDuckAiModels","summary":"Lists the AI models Duck.ai currently offers — the id chatWithDuckAi takes, the underlying vendor, and whether an anonymous caller (no DuckDuckGo account) can use it today, since several models are ga","description":"Lists the AI models Duck.ai currently offers — the id chatWithDuckAi takes, the underlying vendor, and whether an anonymous caller (no DuckDuckGo account) can use it today, since several models are gated to a Plus/Pro account.\n\nCalls `bowmark.providers.duckduckgo.listDuckAiModels`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoAiModel[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/duckduckgo/translateText":{"post":{"operationId":"translateText","summary":"Translate text the way DuckDuckGo's own translation Instant Answer does, returning the detected source language, the target language and the translation.","description":"Translate text the way DuckDuckGo's own translation Instant Answer does, returning the detected source language, the target language and the translation. `to` is a language name DuckDuckGo's own trigger recognizes, e.g. \"french\".\n\nCalls `bowmark.providers.duckduckgo.translateText`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DuckDuckGoTranslation>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/TranslateTextArgs","description":"TypeScript: `TranslateTextArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"ChangeForwardingAddressArgs":{"type":"object","properties":{"newEmail":{"type":"string"},"otp":{"type":"string"},"hash":{"type":"string"}},"required":["newEmail"],"additionalProperties":true},"ChatWithDuckAiArgs":{"type":"object","properties":{"message":{"type":"string"},"model":{"type":"string"}},"required":["message"],"additionalProperties":true},"ConvertCurrencyArgs":{"type":"object","properties":{"amount":{"type":"number"},"from":{"type":"string"},"to":{"type":"string"}},"required":["amount","from","to"],"additionalProperties":true},"DefineWordArgs":{"type":"object","properties":{"word":{"type":"string"}},"required":["word"],"additionalProperties":true},"DuckDuckGoSearchWebArgs":{"type":"object","properties":{"query":{"type":"string"},"region":{"type":"string"},"safeSearch":{"anyOf":[{"const":"strict"},{"const":"moderate"},{"const":"off"}]},"time":{"anyOf":[{"const":"day"},{"const":"week"},{"const":"month"},{"const":"year"}]},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true},"GetInstantAnswerArgs":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true},"GetLocalTimeArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetWeatherArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"ListBangsArgs":{"type":"object","properties":{"filter":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"ResolveBangArgs":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true},"SearchImagesArgs":{"type":"object","properties":{"query":{"type":"string"},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true},"SearchNewsArgs":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true},"SearchPlacesArgs":{"type":"object","properties":{"query":{"type":"string"},"near":{"type":"string"},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true},"SearchVideosArgs":{"type":"object","properties":{"query":{"type":"string"},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true},"SetPrivateDuckAddressActiveArgs":{"type":"object","properties":{"link":{"type":"string"},"address":{"type":"string"},"addressToken":{"type":"string"},"active":{"type":"boolean"}},"additionalProperties":true},"SuggestQueriesArgs":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true},"TranslateTextArgs":{"type":"object","properties":{"text":{"type":"string"},"to":{"type":"string"}},"required":["text","to"],"additionalProperties":true}}}}