> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a playbook (ADMIN only)

> `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.



## OpenAPI

````yaml https://assist.i.moneyforward.com/api/v1/openapi.json post /api/v1/procedures
openapi: 3.1.0
info:
  title: Minabot Public API
  description: >-
    REST API for querying sessions, knowledge articles and playbooks, and for
    maintaining native knowledge articles and playbooks. Requires an API key
    issued from the Admina admin panel; every write endpoint requires an ADMIN
    key.


    ### Rate limits

    Not currently enforced at the HTTP layer. Respect upstream DynamoDB capacity
    when making bulk requests (keep concurrency under ~20 RPS per key).
  version: 1.0.0
  contact:
    name: Minabot
    url: https://github.com/moneyforward-i/minabot
servers:
  - url: https://assist.i.moneyforward.com
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /api/v1/procedures:
    post:
      tags:
        - Procedures
      summary: Create a playbook (ADMIN only)
      description: >-
        `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.
      operationId: postApiV1Procedures
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                path:
                  type: string
                  minLength: 1
                  maxLength: 100
                  pattern: ^[a-z0-9][a-z0-9_-]*\.md$
                  description: >-
                    Filename only — the server stores it under
                    skills/triage/procedures/.
                content:
                  type: string
                  minLength: 1
                  maxLength: 65536
                description:
                  type: string
                  minLength: 1
                  maxLength: 500
                  description: >-
                    Required here (the UI allows it to be empty): a playbook
                    without one is routed as Other / -.
                category:
                  type: string
                  maxLength: 100
                subcategory:
                  type: string
                  maxLength: 100
              required:
                - path
                - content
                - description
      responses:
        '201':
          description: The created playbook, including its typePath
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    const: true
                  procedure:
                    type: object
                    properties:
                      typePath:
                        type: string
                        description: Composite key used to get the full procedure
                      type:
                        type: string
                        description: Instruction type — always 'procedure' here
                      path:
                        type: string
                        description: Filename — last path segment
                      description:
                        type: string
                      category:
                        type: string
                      subcategory:
                        type: string
                      updatedAt:
                        type: string
                        format: date-time
                        pattern: >-
                          ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                      proposalCount:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                        description: >-
                          PENDING AI improvement proposals on this playbook —
                          accepted or discarded ones are removed, so not counted
                      content:
                        type: string
                        description: Full procedure markdown body
                    required:
                      - typePath
                      - type
                      - path
                      - updatedAt
                      - proposalCount
                      - content
                required:
                  - ok
                  - procedure
        '400':
          description: Invalid body or name; deleting general.md
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                  error:
                    type: string
                    description: Human-readable error message
                required:
                  - ok
                  - error
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                  error:
                    type: string
                    description: Human-readable error message
                required:
                  - ok
                  - error
        '403':
          description: API key lacks ADMIN role
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                  error:
                    type: string
                    description: Human-readable error message
                required:
                  - ok
                  - error
        '404':
          description: Procedure not found in this tenant
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                  error:
                    type: string
                    description: Human-readable error message
                required:
                  - ok
                  - error
        '409':
          description: >-
            path already exists, expectedUpdatedAt is stale, or an import is in
            progress
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                  error:
                    type: string
                    description: Human-readable error message
                required:
                  - ok
                  - error
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key created via the Admina admin panel (`Settings → API Keys →
        Create`). Format: `mb_live_<40-hex>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.