> ## 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 the pending AI improvement proposals a ticket produced

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



## OpenAPI

````yaml https://assist.i.moneyforward.com/api/v1/openapi.json get /api/v1/sessions/{sessionKey}/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/sessions/{sessionKey}/proposals:
    get:
      tags:
        - Sessions
      summary: List the pending AI improvement proposals a ticket produced
      description: >-
        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).
      operationId: getApiV1SessionsBySessionKeyProposals
      parameters:
        - in: path
          name: sessionKey
          schema:
            type: string
          required: true
          description: Composite key like `C123:1700000000.000001`
      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
                required:
                  - ok
                  - proposals
                  - count
        '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.