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

# List a playbook's pending AI improvement proposals

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



## OpenAPI

````yaml https://assist.i.moneyforward.com/api/v1/openapi.json get /api/v1/procedures/{name}/proposals
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/{name}/proposals:
    get:
      tags:
        - Procedures
      summary: List a playbook's pending AI improvement proposals
      description: >-
        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.
      operationId: getApiV1ProceduresByNameProposals
      parameters:
        - in: path
          name: name
          schema:
            type: string
            minLength: 1
          required: true
          description: >-
            Filename (e.g. `vpn.md`) or the URL-encoded typePath (e.g.
            `procedure%23skills/triage/procedures/vpn.md`)
      responses:
        '200':
          description: Proposals
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    const: true
                  proposals:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        title:
                          type: string
                        description:
                          type: string
                        priority:
                          type: string
                          enum:
                            - high
                            - medium
                            - low
                        actionType:
                          type: string
                          description: >-
                            `update` (edit the target playbook) or `create` (a
                            new playbook at `newPath`)
                        sessionKey:
                          type: string
                          description: The ticket the proposal was generated from
                        generatedAt:
                          type: string
                        targetTypePath:
                          type: string
                          description: >-
                            The playbook the proposal applies to; for `create`,
                            the typePath the new playbook would get
                        newPath:
                          type: string
                        newMetadata:
                          type: object
                          properties:
                            category:
                              type: string
                            subcategory:
                              type: string
                            description:
                              type: string
                        validationResult:
                          type: object
                          properties:
                            status:
                              type: string
                              enum:
                                - PASS
                                - NEEDS_REVISION
                                - REJECT
                            issues:
                              type: array
                              items:
                                type: string
                          required:
                            - status
                            - issues
                        draftContent:
                          type: string
                          description: >-
                            The full proposed playbook text, frontmatter
                            included
                        currentContent:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: >-
                            The target playbook's current text, frontmatter
                            included — compare it with `draftContent` for the
                            change. Accepting an `update` proposal applies only
                            the draft's BODY: the playbook keeps its current
                            frontmatter, so a frontmatter difference between the
                            two is never applied. Null for a `create` proposal
                            (the playbook does not exist yet).
                      required:
                        - id
                        - title
                        - description
                        - priority
                        - actionType
                        - sessionKey
                        - generatedAt
                        - targetTypePath
                        - draftContent
                        - currentContent
                  count:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  typePath:
                    type: string
                required:
                  - ok
                  - proposals
                  - count
                  - typePath
        '400':
          description: Invalid name
          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
        '404':
          description: 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
      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.