# Admina Help Center: English API & MCP ## API & MCP - [English / API & MCP / IT Management API (179 pages)](https://support.i.moneyforward.com/_llms/en/api-and-mcp/it-management-api.txt): Documentation for English / API & MCP / IT Management API. ### AI Helpdesk API #### AI Helpdesk API - [About AI Helpdesk API](https://support.i.moneyforward.com/en/api-reference/ai-helpdesk/index.md): Overview of the AI Helpdesk API, a read-only REST API for querying sessions and knowledge articles. #### Guides - [Exploring the AI Helpdesk API with AI](https://support.i.moneyforward.com/en/api-reference/ai-helpdesk/exploring-with-ai.md): The AI Helpdesk API is a read-only REST API. Pair it with AI coding assistants to streamline data exploration and operational workflows over sessions, knowledge articles, and procedures. ##### Getting started - [AI Helpdesk API authentication](https://support.i.moneyforward.com/en/api-reference/ai-helpdesk/authentication.md): AI Helpdesk API access requires an API key. Include the key in the `X-API-Key` header on every request. - [AI Helpdesk API pagination](https://support.i.moneyforward.com/en/api-reference/ai-helpdesk/pagination.md): AI Helpdesk API list endpoints control result size with the `limit` query parameter. There is no page number or cursor. - [AI Helpdesk API errors](https://support.i.moneyforward.com/en/api-reference/ai-helpdesk/errors.md): The AI Helpdesk API returns appropriate HTTP status codes and a consistent error body when something goes wrong. - [AI Helpdesk API rate limits](https://support.i.moneyforward.com/en/api-reference/ai-helpdesk/rate-limits.md): The AI Helpdesk API does not currently enforce rate limits at the HTTP layer. Respect upstream DynamoDB capacity and keep concurrency below ~20 RPS per API key. - [AI Helpdesk API support](https://support.i.moneyforward.com/en/api-reference/ai-helpdesk/support.md): Use the following resources if you have questions or issues with the AI Helpdesk API. #### Endpoints ##### Sessions - [Session statistics](https://support.i.moneyforward.com/api-reference/ai-helpdesk/sessions/session-statistics.md): Counts grouped by status and assignee type. - [Get session by key](https://support.i.moneyforward.com/api-reference/ai-helpdesk/sessions/get-session-by-key.md) - [List sessions](https://support.i.moneyforward.com/api-reference/ai-helpdesk/sessions/list-sessions.md): Returns support sessions for the authenticated tenant. Optional filters by status and assignee type. - [List the pending AI improvement proposals a ticket produced](https://support.i.moneyforward.com/api-reference/ai-helpdesk/sessions/list-the-pending-ai-improvement-proposals-a-ticket-produced.md): Every PENDING proposal generated from this ticket (one not yet accepted or discarded — both remove it), across all playbooks, newest first — each with the playbook it targets (`targetTypePath`), its full draft and that playbook's current body (`currentContent`, null for a `create` proposal). ##### Knowledge - [List knowledge folders](https://support.i.moneyforward.com/api-reference/ai-helpdesk/knowledge/list-knowledge-folders.md): Returns the tenant's native knowledge folder tree (id, name, parentId, derived path, and direct doc count). - [Get knowledge article (with content)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/knowledge/get-knowledge-article-with-content.md) - [Delete a native knowledge article (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/knowledge/delete-a-native-knowledge-article-admin-only.md): Deletes the DynamoDB row and every S3 object under the document (content, original, images), then schedules a managed-KB re-ingest so the Bedrock lane stops citing it. - [Update a native knowledge article (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/knowledge/update-a-native-knowledge-article-admin-only.md): Field-driven: an omitted field is left alone. `content` rewrites the S3 body, drops any stored original and schedules a managed-KB re-ingest; `tags` rewrites the tag sidecar and also re-ingests; `folderId` (`null` = root) and `title` touch DynamoDB only. A PATCH that omits `content` never touches S3… - [List knowledge articles](https://support.i.moneyforward.com/api-reference/ai-helpdesk/knowledge/list-knowledge-articles.md): Returns knowledge article summaries (without full content). Optional filter by type. - [Create a native knowledge article (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/knowledge/create-a-native-knowledge-article-admin-only.md): Creates a native document. `docId` is generated by the backend — connector documents (Notion, Box, …) are read-only mirrors and cannot be written. An embedded image over the 10 MB cap is replaced by its alt text rather than rejected. ##### Procedures - [Get procedure (with content) by typePath](https://support.i.moneyforward.com/api-reference/ai-helpdesk/procedures/get-procedure-with-content-by-typepath.md) - [List procedures](https://support.i.moneyforward.com/api-reference/ai-helpdesk/procedures/list-procedures.md): Procedures are tenant-scoped triage skill documents. Returns summaries without content. - [Create a playbook (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/procedures/create-a-playbook-admin-only.md): `path` is a filename only; the server stores it under `skills/triage/procedures/`. `description` is required here even though the UI allows it to be empty — a playbook without one is routed as `Other` / `-`. Creating a playbook writes a `create` entry to its change history. - [Delete a playbook (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/procedures/delete-a-playbook-admin-only.md): Records a `delete` entry (with a content snapshot) in the playbook's history and prunes the playbook from every agent's WEB-3135 scope. `general.md` — the built-in triage fallback — cannot be deleted through this API; the UI can still delete it. - [Update a playbook (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/procedures/update-a-playbook-admin-only.md): `:name` is a filename (`vpn.md`) or the URL-encoded typePath (`procedure%23skills/triage/procedures/legacy`), which is the only way to address a legacy row stored without a `.md` extension. Every field is optional; at least one is required. The PRE-change body is snapshotted into the playbook's chan… - [List a playbook's pending AI improvement proposals](https://support.i.moneyforward.com/api-reference/ai-helpdesk/procedures/list-a-playbooks-pending-ai-improvement-proposals.md): Every PENDING proposal on the playbook (one not yet accepted or discarded — both remove it), newest first, each with its full draft and the current playbook body (`currentContent`) to compare it with. `:name` is a filename or the URL-encoded typePath. - [Accept a pending AI proposal (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/procedures/accept-a-pending-ai-proposal-admin-only.md): Same as Accept on the playbook page. An `update` proposal replaces the playbook's BODY with the draft's (or `editedContent`'s) body and keeps its frontmatter; the PRE-accept body is snapshotted into history (`proposal_accepted`), so the change stays revertable from the UI. A `create` proposal fills… - [Discard a pending AI proposal (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/procedures/discard-a-pending-ai-proposal-admin-only.md): Same as Discard on the playbook page: the proposal is removed and nothing is applied. Discarding a `create` proposal also deletes its draft playbook while that draft is still empty and has no other proposal. ##### Settings - [Get agent settings (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/settings/get-agent-settings-admin-only.md): Escalation fallback user IDs are stripped — only names are returned. - [Get admin settings + team members (ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/settings/get-admin-settings-+-team-members-admin-only.md): Team member emails, linked accounts, and `updatedBy` are stripped. ##### Integrations - [List MCP tools for an integration](https://support.i.moneyforward.com/api-reference/ai-helpdesk/integrations/list-mcp-tools-for-an-integration.md): Connects to the MCP server (template command + tenant env) and returns the advertised tool list with enabled state. - [Get integration (no credentials)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/integrations/get-integration-no-credentials.md): The `env` credential map is intentionally not returned — use `hasCredentials` to know if it is populated. - [List integrations](https://support.i.moneyforward.com/api-reference/ai-helpdesk/integrations/list-integrations.md): Returns all MCP integrations available to the tenant (template + overrides). ##### Notifications - [Count unread notifications (tenant-wide, ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/notifications/count-unread-notifications-tenant-wide-admin-only.md) - [List notifications (tenant-wide, ADMIN only)](https://support.i.moneyforward.com/api-reference/ai-helpdesk/notifications/list-notifications-tenant-wide-admin-only.md): Returns the newest notifications across all users in the tenant. ### Remote MCP #### IT Management - [About Remote MCP](https://support.i.moneyforward.com/en/remote-mcp/it-management/index.md): Overview of the IT Management Remote MCP Server. Access Admina data directly from your AI coding assistant. - [Connection Guide](https://support.i.moneyforward.com/en/remote-mcp/it-management/connection-guide.md): How to connect AI coding assistants to Admina Remote MCP Server. - [Tool Reference](https://support.i.moneyforward.com/en/remote-mcp/it-management/tools.md): List of available tools on the IT Management Remote MCP Server. ## OpenAPI Specs - [v1-json](https://api.itmc.i.moneyforward.com/public-api/docs/v1-json) - [openapi](https://assist.i.moneyforward.com/api/v1/openapi.json)