{"openapi":"3.1.0","info":{"title":"Intercom News (BYOK) API","version":"0.1.0","description":"Intercom News (BYOK) lets an AI assistant read your own Intercom News data through the Intercom News API with a key you supply (Intercom access token (US-hosted workspace)). Read-only: 5 tools (list_news_items, get_news_item, list_newsfeeds, get_newsfeed, list_newsfeed_items). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-intercom-news.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-intercom-news/docs"},"termsOfService":"https://connectorbay.com/byok-intercom-news/terms"},"servers":[{"url":"https://byok-intercom-news.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-intercom-news/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_news_items":{"post":{"operationId":"list_news_items","summary":"List news items (drafts and live) with title, state, sender admin id, labels, newsfeed assignments and dates. Bodies are","description":"List news items (drafts and live) with title, state, sender admin id, labels, newsfeed assignments and dates. Bodies are not returned. Use for \"What product news have we published in Intercom\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_news_itemsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_news_item":{"post":{"operationId":"get_news_item","summary":"Get one news item by id: title, state, sender admin id, labels, newsfeed assignments with publish time, and dates. Use f","description":"Get one news item by id: title, state, sender admin id, labels, newsfeed assignments with publish time, and dates. Use for \"When was Intercom news item 61 published\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"news_item_id":{"description":"Id of the news item (a numeric string such as '61').","maxLength":200,"title":"News Item Id","type":"string"}},"required":["news_item_id"],"title":"get_news_itemArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_newsfeeds":{"post":{"operationId":"list_newsfeeds","summary":"List newsfeeds with id, name and dates. Use for \"Which newsfeeds exist in our Intercom workspace\".","description":"List newsfeeds with id, name and dates. Use for \"Which newsfeeds exist in our Intercom workspace\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_newsfeedsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_newsfeed":{"post":{"operationId":"get_newsfeed","summary":"Get one newsfeed by id: name and dates. Use for \"What is Intercom newsfeed 5 called\".","description":"Get one newsfeed by id: name and dates. Use for \"What is Intercom newsfeed 5 called\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"newsfeed_id":{"description":"Id of the newsfeed (a numeric string such as '5').","maxLength":200,"title":"Newsfeed Id","type":"string"}},"required":["newsfeed_id"],"title":"get_newsfeedArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_newsfeed_items":{"post":{"operationId":"list_newsfeed_items","summary":"List the live news items shown in one newsfeed with title, state, labels, publication info and dates. Use for \"What is l","description":"List the live news items shown in one newsfeed with title, state, labels, publication info and dates. Use for \"What is live in Intercom newsfeed 5 right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"newsfeed_id":{"description":"Id of the newsfeed (a numeric string such as '5').","maxLength":200,"title":"Newsfeed Id","type":"string"}},"required":["newsfeed_id"],"title":"list_newsfeed_itemsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}