{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Search the knowledge base contents — articles, snippets, external pages, uploaded files, and internal articles — using a keyword query.\n\nEach result row has a `type` discriminator. Most types (`content_snippet`, `external_content`, `file_source_content`, `internal_article`) return a flat `{ type, id, title }` shape. Help center articles return a nested shape with a `contents[]` array, one entry per locale.\n\nRequires the `read_content` OAuth scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"query":{"type":"object","properties":{"query":{"type":"string","maxLength":500,"examples":["billing"],"description":"A free-text search term matched against the title and body of each content item. When omitted, returns the most recent content items. Keep it to 500 characters or fewer. The API doesn't currently reject longer values."},"page":{"type":"integer","default":1,"minimum":1,"examples":[1],"description":"The page number to fetch. Defaults to 1. Values below 1 are clamped to 1. Values above 5001 return a `400` `parameter_invalid` error."},"per_page":{"type":"integer","default":10,"minimum":1,"maximum":50,"examples":[10],"description":"Number of results per page. Defaults to 10. Maximum 50."},"states":{"type":"array","items":{"type":"string","enum":["published","draft"]},"examples":["published,draft"],"description":"Filter by publication state. Accepts a comma-separated list or repeated params."},"locales":{"type":"array","items":{"type":"string"},"examples":["en,fr"],"description":"Filter by locale codes (e.g. `en`, `fr`, `de`). Accepts a comma-separated list or repeated params."},"tag_ids":{"type":"array","items":{"type":"integer"},"examples":["1,2,3"],"description":"Filter by tag IDs. Pairs with `tag_operator` to control match semantics. Accepts a comma-separated list or repeated params."},"tag_operator":{"type":"string","enum":["IN","NIN"],"examples":["IN"],"description":"Match operator paired with `tag_ids`. `IN` returns content matching any of the given tags; `NIN` excludes content matching any of them."},"any_tag_ids":{"type":"array","items":{"type":"integer"},"examples":["1,2,3"],"description":"Filter by tag IDs using OR semantics — returns content matching any of the given tags. Alternative to `tag_ids` + `tag_operator`. Accepts a comma-separated list or repeated params."},"folder_ids":{"type":"array","items":{"type":"integer"},"examples":["10,20"],"description":"Filter by folder IDs. Must be sent together with `folder_entity_type`. Accepts a comma-separated list or repeated params."},"folder_entity_type":{"type":"string","enum":["folder"],"examples":["folder"],"description":"Required when `folder_ids` is provided. Identifies the entity type the folder IDs refer to."},"content_types":{"type":"array","items":{"type":"string","enum":["snippet","external_content","file_source_content","internal_article","article"]},"examples":["article,snippet"],"description":"Restrict the search to specific content types. When provided, this REPLACES the default content type set rather than filtering on top of it. Accepts a comma-separated list or repeated params."},"copilot_state":{"type":"string","enum":["on","off"],"examples":["on"],"description":"Filter by whether the content is enabled for Copilot."},"fin_service_state":{"type":"string","enum":["on","off"],"examples":["on"],"description":"Filter by whether the content is enabled for Fin AI Agent (customer-facing service)."},"fin_sales_state":{"type":"string","enum":["on","off"],"examples":["on"],"description":"Filter by whether the content is enabled for Fin Sales Agent."},"created_by_ids":{"type":"array","items":{"type":"integer"},"examples":["991267464,991267465"],"description":"Filter by the admin IDs that created the content. Accepts a comma-separated list or repeated params."},"last_updated_by_ids":{"type":"array","items":{"type":"integer"},"examples":["991267464,991267465"],"description":"Filter by the admin IDs that last updated the content. Accepts a comma-separated list or repeated params."},"created_at_after":{"type":"integer","examples":[1677253093],"description":"Return content created at or after this time. Unix epoch seconds."},"created_at_before":{"type":"integer","examples":[1677861493],"description":"Return content created at or before this time. Unix epoch seconds."},"updated_at_after":{"type":"integer","examples":[1677253093],"description":"Return content last updated at or after this time. Unix epoch seconds."},"updated_at_before":{"type":"integer","examples":[1677861493],"description":"Return content last updated at or before this time. Unix epoch seconds."}},"required":[],"additionalProperties":false}},"required":[],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]}}},"name":"Search knowledge base contents","id":"intercom.searchcontent","example":{},"maxRequests":1,"summary":false}}