{ "service": "elevio", "displayName": "Elevio", "categories": [ "Productivity", "Communication" ], "authTypes": [ "api_key" ], "auth": [ { "type": "api_key", "label": "API Key", "placeholder": "ELEVIO_API_KEY", "description": "Elevio REST API key sent in the x-api-key header. Create or view API keys from the Elevio dashboard API Keys page: https://app.elev.io/apikeys.", "extraFields": [ { "key": "jwt", "label": "JSON Web Token", "inputType": "password", "required": true, "secret": true, "placeholder": "ELEVIO_JWT", "description": "Elevio REST API JWT sent as the Bearer token. Generate it with the matching API key from the Elevio dashboard API Keys page: https://app.elev.io/apikeys." } ] } ], "homepageUrl": "https://elev.io", "actions": [ { "id": "elevio.get_article", "service": "elevio", "name": "get_article", "description": "Get one Elevio knowledge base article by ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The Elevio numeric resource ID." } }, "additionalProperties": false, "description": "Input parameters for retrieving an Elevio resource by ID." }, "outputSchema": { "type": "object", "properties": { "article": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio article ID." }, "title": { "type": "string", "description": "The article title derived from the default translation." }, "order": { "type": "integer", "description": "Sort order for displaying the article." }, "creator": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio user ID." }, "name": { "type": "string", "description": "The user display name." }, "gravatar": { "type": "string", "description": "The user Gravatar URL." }, "email": { "type": "string", "description": "The user email address.", "format": "email" } }, "additionalProperties": true, "description": "An Elevio user reference." }, "author": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio user ID." }, "name": { "type": "string", "description": "The user display name." }, "gravatar": { "type": "string", "description": "The user Gravatar URL." }, "email": { "type": "string", "description": "The user email address.", "format": "email" } }, "additionalProperties": true, "description": "An Elevio user reference." }, "source": { "type": "string", "description": "The source that created the article." }, "external_id": { "anyOf": [ { "type": "string", "description": "The article identifier in the source system." }, { "type": "null" } ] }, "editor_version": { "type": "string", "description": "The Elevio editor version used for the article." }, "notes": { "type": "string", "description": "Internal notes for contributors." }, "keywords": { "type": "array", "items": { "type": "string", "description": "One global article keyword." }, "description": "Global article keywords." }, "category_id": { "type": "integer", "description": "The category ID that contains the article." }, "access": { "type": "string", "description": "Deprecated Elevio access level for the article." }, "restriction": { "type": "string", "description": "Direct access restriction for the article." }, "discoverable": { "type": "boolean", "description": "Whether the article is searchable and listable." }, "is_internal": { "type": "boolean", "description": "Whether the article is internal only." }, "access_emails": { "type": "array", "items": { "type": "string", "description": "One allowed email address." }, "description": "Deprecated email allow-list values returned by Elevio." }, "access_domains": { "type": "array", "items": { "type": "string", "description": "One allowed domain." }, "description": "Deprecated domain allow-list values returned by Elevio." }, "access_groups": { "type": "array", "items": { "type": "string", "description": "One allowed group." }, "description": "Deprecated group allow-list values returned by Elevio." }, "smart_groups": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The smart group ID." }, "name": { "type": "string", "description": "The smart group name." } }, "additionalProperties": true, "description": "An Elevio smart group reference." }, "description": "Smart groups attached to the article." }, "status": { "type": "string", "description": "The article publication status." }, "last_publisher": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio user ID." }, "name": { "type": "string", "description": "The user display name." }, "gravatar": { "type": "string", "description": "The user Gravatar URL." }, "email": { "type": "string", "description": "The user email address.", "format": "email" } }, "additionalProperties": true, "description": "An Elevio user reference." }, "last_published_at": { "type": "string", "description": "Timestamp when the article was last published." }, "contributors": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio user ID." }, "name": { "type": "string", "description": "The user display name." }, "gravatar": { "type": "string", "description": "The user Gravatar URL." }, "email": { "type": "string", "description": "The user email address.", "format": "email" } }, "additionalProperties": true, "description": "An Elevio user reference." }, "description": "Users who contributed to the article." }, "created_at": { "type": "string", "description": "Timestamp when the article was created." }, "updated_at": { "type": "string", "description": "Timestamp when the article was last updated." }, "tags": { "type": "array", "items": { "type": "string", "description": "One article tag." }, "description": "Tags associated with the article." }, "translations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The translation ID." }, "title": { "type": "string", "description": "The translated article title." }, "body": { "type": "string", "description": "The translated article body." }, "summary": { "type": "string", "description": "The translated article summary." }, "machine_summary": { "type": "string", "description": "Deprecated machine-generated article summary." }, "language_id": { "type": "string", "description": "The translation language code." }, "keywords": { "type": "array", "items": { "type": "string", "description": "One translation keyword." }, "description": "Language-specific translation keywords." }, "tags": { "type": "array", "items": { "type": "string", "description": "One translation tag." }, "description": "Language-specific translation tags." }, "created_at": { "type": "string", "description": "Timestamp when the translation was created." }, "updated_at": { "type": "string", "description": "Timestamp when the translation was last updated." } }, "additionalProperties": true, "description": "An Elevio article translation." }, "description": "Translations available for the article." } }, "additionalProperties": true, "description": "An Elevio article resource." } }, "additionalProperties": false, "description": "Elevio article lookup response." } }, { "id": "elevio.get_category", "service": "elevio", "name": "get_category", "description": "Get one Elevio knowledge base category by ID.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "id": { "type": "integer", "minimum": 1, "description": "The Elevio numeric resource ID." } }, "additionalProperties": false, "description": "Input parameters for retrieving an Elevio resource by ID." }, "outputSchema": { "type": "object", "properties": { "category": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio category ID." }, "parent_category_id": { "anyOf": [ { "type": "integer", "description": "The parent category ID." }, { "type": "null" } ] }, "source": { "type": "string", "description": "The source that created the category." }, "external_id": { "anyOf": [ { "type": "string", "description": "The category identifier in the source system." }, { "type": "null" } ] }, "order": { "type": "integer", "description": "Sort order for displaying the category." }, "access": { "type": "string", "description": "Deprecated Elevio access level for the category." }, "restriction": { "type": "string", "description": "Direct access restriction for the category." }, "discoverable": { "type": "boolean", "description": "Whether articles in the category are searchable and listable." }, "is_internal": { "type": "boolean", "description": "Whether the category is internal only." }, "access_emails": { "type": "array", "items": { "type": "string", "description": "One allowed email address." }, "description": "Deprecated email allow-list values returned by Elevio." }, "access_domains": { "type": "array", "items": { "type": "string", "description": "One allowed domain." }, "description": "Deprecated domain allow-list values returned by Elevio." }, "access_groups": { "type": "array", "items": { "type": "string", "description": "One allowed group." }, "description": "Deprecated group allow-list values returned by Elevio." }, "smart_groups": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The smart group ID." }, "name": { "type": "string", "description": "The smart group name." } }, "additionalProperties": true, "description": "An Elevio smart group reference." }, "description": "Smart groups attached to the category." }, "translations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The translation ID." }, "language_id": { "type": "string", "description": "The translation language code." }, "title": { "type": "string", "description": "The translated category title." } }, "additionalProperties": true, "description": "An Elevio category translation." }, "description": "Translations available for the category." }, "created_at": { "type": "string", "description": "Timestamp when the category was created." }, "updated_at": { "type": "string", "description": "Timestamp when the category was last updated." } }, "additionalProperties": true, "description": "An Elevio category resource." } }, "additionalProperties": false, "description": "Elevio category lookup response." } }, { "id": "elevio.list_articles", "service": "elevio", "name": "list_articles", "description": "List Elevio knowledge base articles with optional pagination and filters.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "description": "The page number to request." }, "pageSize": { "type": "integer", "minimum": 1, "maximum": 500, "description": "Number of articles per page. Elevio allows up to 500." }, "status": { "type": "string", "enum": [ "draft", "published" ], "description": "Filter articles by publication status." }, "fromCreatedAt": { "type": "integer", "minimum": 0, "description": "Epoch millisecond timestamp used by Elevio filters." }, "toCreatedAt": { "type": "integer", "minimum": 0, "description": "Epoch millisecond timestamp used by Elevio filters." }, "fromPublishedAt": { "type": "integer", "minimum": 0, "description": "Epoch millisecond timestamp used by Elevio filters." }, "toPublishedAt": { "type": "integer", "minimum": 0, "description": "Epoch millisecond timestamp used by Elevio filters." }, "tags": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One article tag." }, "description": "Article tags to filter by. Elevio receives each value as a repeated tag[] query parameter." } }, "additionalProperties": false, "description": "Query parameters for listing Elevio articles." }, "outputSchema": { "type": "object", "properties": { "articles": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio article ID." }, "title": { "type": "string", "description": "The article title derived from the default translation." }, "order": { "type": "integer", "description": "Sort order for displaying the article." }, "creator": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio user ID." }, "name": { "type": "string", "description": "The user display name." }, "gravatar": { "type": "string", "description": "The user Gravatar URL." }, "email": { "type": "string", "description": "The user email address.", "format": "email" } }, "additionalProperties": true, "description": "An Elevio user reference." }, "author": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio user ID." }, "name": { "type": "string", "description": "The user display name." }, "gravatar": { "type": "string", "description": "The user Gravatar URL." }, "email": { "type": "string", "description": "The user email address.", "format": "email" } }, "additionalProperties": true, "description": "An Elevio user reference." }, "source": { "type": "string", "description": "The source that created the article." }, "external_id": { "anyOf": [ { "type": "string", "description": "The article identifier in the source system." }, { "type": "null" } ] }, "editor_version": { "type": "string", "description": "The Elevio editor version used for the article." }, "notes": { "type": "string", "description": "Internal notes for contributors." }, "keywords": { "type": "array", "items": { "type": "string", "description": "One global article keyword." }, "description": "Global article keywords." }, "category_id": { "type": "integer", "description": "The category ID that contains the article." }, "access": { "type": "string", "description": "Deprecated Elevio access level for the article." }, "restriction": { "type": "string", "description": "Direct access restriction for the article." }, "discoverable": { "type": "boolean", "description": "Whether the article is searchable and listable." }, "is_internal": { "type": "boolean", "description": "Whether the article is internal only." }, "access_emails": { "type": "array", "items": { "type": "string", "description": "One allowed email address." }, "description": "Deprecated email allow-list values returned by Elevio." }, "access_domains": { "type": "array", "items": { "type": "string", "description": "One allowed domain." }, "description": "Deprecated domain allow-list values returned by Elevio." }, "access_groups": { "type": "array", "items": { "type": "string", "description": "One allowed group." }, "description": "Deprecated group allow-list values returned by Elevio." }, "smart_groups": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The smart group ID." }, "name": { "type": "string", "description": "The smart group name." } }, "additionalProperties": true, "description": "An Elevio smart group reference." }, "description": "Smart groups attached to the article." }, "status": { "type": "string", "description": "The article publication status." }, "last_publisher": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio user ID." }, "name": { "type": "string", "description": "The user display name." }, "gravatar": { "type": "string", "description": "The user Gravatar URL." }, "email": { "type": "string", "description": "The user email address.", "format": "email" } }, "additionalProperties": true, "description": "An Elevio user reference." }, "last_published_at": { "type": "string", "description": "Timestamp when the article was last published." }, "contributors": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio user ID." }, "name": { "type": "string", "description": "The user display name." }, "gravatar": { "type": "string", "description": "The user Gravatar URL." }, "email": { "type": "string", "description": "The user email address.", "format": "email" } }, "additionalProperties": true, "description": "An Elevio user reference." }, "description": "Users who contributed to the article." }, "created_at": { "type": "string", "description": "Timestamp when the article was created." }, "updated_at": { "type": "string", "description": "Timestamp when the article was last updated." }, "tags": { "type": "array", "items": { "type": "string", "description": "One article tag." }, "description": "Tags associated with the article." }, "translations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The translation ID." }, "title": { "type": "string", "description": "The translated article title." }, "body": { "type": "string", "description": "The translated article body." }, "summary": { "type": "string", "description": "The translated article summary." }, "machine_summary": { "type": "string", "description": "Deprecated machine-generated article summary." }, "language_id": { "type": "string", "description": "The translation language code." }, "keywords": { "type": "array", "items": { "type": "string", "description": "One translation keyword." }, "description": "Language-specific translation keywords." }, "tags": { "type": "array", "items": { "type": "string", "description": "One translation tag." }, "description": "Language-specific translation tags." }, "created_at": { "type": "string", "description": "Timestamp when the translation was created." }, "updated_at": { "type": "string", "description": "Timestamp when the translation was last updated." } }, "additionalProperties": true, "description": "An Elevio article translation." }, "description": "Translations available for the article." } }, "additionalProperties": true, "description": "An Elevio article resource." }, "description": "Articles returned by Elevio." }, "page_number": { "type": "integer", "description": "Current Elevio page number." }, "page_size": { "type": "integer", "description": "Current Elevio page size." }, "total_pages": { "type": "integer", "description": "Total number of result pages." }, "total_entries": { "type": "integer", "description": "Total number of matching articles." } }, "additionalProperties": false, "required": [ "articles" ], "description": "Elevio articles list response with upstream pagination metadata." } }, { "id": "elevio.list_categories", "service": "elevio", "name": "list_categories", "description": "List Elevio knowledge base categories.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "Input parameters for listing Elevio categories." }, "outputSchema": { "type": "object", "properties": { "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The Elevio category ID." }, "parent_category_id": { "anyOf": [ { "type": "integer", "description": "The parent category ID." }, { "type": "null" } ] }, "source": { "type": "string", "description": "The source that created the category." }, "external_id": { "anyOf": [ { "type": "string", "description": "The category identifier in the source system." }, { "type": "null" } ] }, "order": { "type": "integer", "description": "Sort order for displaying the category." }, "access": { "type": "string", "description": "Deprecated Elevio access level for the category." }, "restriction": { "type": "string", "description": "Direct access restriction for the category." }, "discoverable": { "type": "boolean", "description": "Whether articles in the category are searchable and listable." }, "is_internal": { "type": "boolean", "description": "Whether the category is internal only." }, "access_emails": { "type": "array", "items": { "type": "string", "description": "One allowed email address." }, "description": "Deprecated email allow-list values returned by Elevio." }, "access_domains": { "type": "array", "items": { "type": "string", "description": "One allowed domain." }, "description": "Deprecated domain allow-list values returned by Elevio." }, "access_groups": { "type": "array", "items": { "type": "string", "description": "One allowed group." }, "description": "Deprecated group allow-list values returned by Elevio." }, "smart_groups": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The smart group ID." }, "name": { "type": "string", "description": "The smart group name." } }, "additionalProperties": true, "description": "An Elevio smart group reference." }, "description": "Smart groups attached to the category." }, "translations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "The translation ID." }, "language_id": { "type": "string", "description": "The translation language code." }, "title": { "type": "string", "description": "The translated category title." } }, "additionalProperties": true, "description": "An Elevio category translation." }, "description": "Translations available for the category." }, "created_at": { "type": "string", "description": "Timestamp when the category was created." }, "updated_at": { "type": "string", "description": "Timestamp when the category was last updated." } }, "additionalProperties": true, "description": "An Elevio category resource." }, "description": "Categories returned by Elevio." } }, "additionalProperties": false, "description": "Elevio categories list response." } }, { "id": "elevio.search_articles", "service": "elevio", "name": "search_articles", "description": "Search Elevio articles in a language with optional access filters.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "languageCode": { "type": "string", "minLength": 1, "description": "The Elevio language code to search, such as en." }, "query": { "type": "string", "minLength": 1, "description": "Search keywords to look for in article content." }, "page": { "type": "integer", "minimum": 1, "description": "The page number to request." }, "rows": { "type": "integer", "minimum": 1, "maximum": 100, "description": "Number of search rows to return. Elevio allows up to 100." }, "tags": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One article tag." }, "description": "Article tags to filter by. Elevio receives each value as a repeated tag[] query parameter." }, "userEmail": { "type": "string", "description": "Optional user email used for Elevio access filtering.", "format": "email" }, "groups": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "One Elevio access group." }, "description": "Optional user groups used for Elevio access filtering." }, "hash": { "type": "string", "minLength": 1, "description": "Optional user hash used for Elevio access filtering." }, "url": { "type": "string", "minLength": 1, "description": "Optional originating domain or page URL used for Elevio access filtering." } }, "additionalProperties": false, "required": [ "languageCode", "query" ], "description": "Query parameters for searching Elevio articles." }, "outputSchema": { "type": "object", "properties": { "queryTerm": { "type": "string", "description": "The query term Elevio searched for." }, "totalResults": { "type": "integer", "description": "Total number of matching search results." }, "totalPages": { "type": "integer", "description": "Total number of result pages." }, "currentPage": { "type": "integer", "description": "Current result page." }, "count": { "type": "integer", "description": "Number of results in this response." }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "anyOf": [ { "type": "string", "description": "The matching article ID as a string." }, { "type": "integer", "description": "The matching article ID as a number." } ], "description": "The matching article ID returned by Elevio." }, "title": { "type": "string", "description": "The highlighted article title returned by Elevio." } }, "additionalProperties": true, "description": "One Elevio article search result." }, "description": "Article search results returned by Elevio." } }, "additionalProperties": false, "description": "Elevio article search response." } } ] }