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

# Get Motion ICP detail

> Get full detail for a Motion ICP cell including the AI-generated narrative and learning count. Use includeReport=true to include the latest report run summary and comparisonWithPrevious. Use GET /api/v2/motion-icp/elements/list to fetch recommended library entities for this cell.



## OpenAPI

````yaml get /api/v2/motion-icp/get
openapi: 3.0.0
info:
  version: 6.0.0
  title: Octave API
  description: API for Octave workspace management and AI-powered content generation
servers:
  - url: https://app.octavehq.com
security:
  - ApiKeyAuth: []
paths:
  /api/v2/motion-icp/get:
    get:
      tags:
        - MotionICP
      summary: Get Motion ICP detail
      description: >-
        Get full detail for a Motion ICP cell including the AI-generated
        narrative and learning count. Use includeReport=true to include the
        latest report run summary and comparisonWithPrevious. Use GET
        /api/v2/motion-icp/elements/list to fetch recommended library entities
        for this cell.
      operationId: getMotionIcp
      parameters:
        - schema:
            type: string
            description: Motion ICP oId (micp_ prefix)
          required: true
          description: Motion ICP oId (micp_ prefix)
          name: oId
          in: query
        - schema:
            type: string
            description: >-
              Pass true to include the latest completed report run summary and
              comparisonWithPrevious in the response. Defaults to false.
          required: false
          description: >-
            Pass true to include the latest completed report run summary and
            comparisonWithPrevious in the response. Defaults to false.
          name: includeReport
          in: query
      responses:
        '200':
          description: Motion ICP detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    $ref: '#/components/schemas/Metadata'
                  data:
                    $ref: '#/components/schemas/MotionIcpDetail'
                required:
                  - _metadata
                  - data
      deprecated: false
components:
  schemas:
    Metadata:
      type: object
      properties:
        usage:
          type: number
          default: 0
          example: 0
          description: API usage
        requestId:
          type: string
          example: requestId
          description: Request ID
        message:
          type: string
          example: message
          description: Message
        timestamp:
          type: string
          example: '2021-01-01T00:00:00.000Z'
          description: Timestamp
      required:
        - requestId
        - timestamp
    MotionIcpDetail:
      type: object
      properties:
        oId:
          type: string
          description: Motion ICP oId (micp_ prefix)
        motionPlaybookOId:
          type: string
          description: Parent motion playbook oId
        persona:
          $ref: '#/components/schemas/EntityRef'
        segment:
          allOf:
            - $ref: '#/components/schemas/EntityRef'
            - description: Target segment
        status:
          type: string
          enum:
            - PENDING_INITIAL_VERSION
            - HAS_VERSION
            - GENERATING_INITIAL_VERSION
            - RUNNING_REPORT
            - ANALYZING_LEARNINGS
            - ANALYZING_ICP_RECOMMENDATIONS
            - UPDATING_VERSION
          description: Current generation status
        disabled:
          type: boolean
          description: Whether this ICP cell is disabled
        narrative:
          type: object
          nullable: true
          properties:
            targetIcpOverview:
              type: string
            operatingLandscape:
              type: array
              items:
                type: string
            strategicNarrative:
              type: array
              items:
                type: string
            painsAndConsequences:
              type: array
              items:
                type: string
            benefitsAndImpacts:
              type: array
              items:
                type: string
            valueProps:
              type: array
              items:
                type: string
            approachAngle:
              type: array
              items:
                type: string
            businessImpact:
              type: array
              items:
                type: string
            uniqueInsight:
              type: array
              items:
                type: string
            salesMethodology:
              type: array
              items:
                type: object
                properties:
                  stageName:
                    type: string
                  stageObjective:
                    type: string
                  sections:
                    type: array
                    items:
                      type: object
                      properties:
                        sectionName:
                          type: string
                        content:
                          anyOf:
                            - type: string
                            - type: array
                              items:
                                type: string
                      required:
                        - sectionName
                        - content
                required:
                  - stageName
                  - sections
          required:
            - targetIcpOverview
            - operatingLandscape
            - strategicNarrative
            - painsAndConsequences
            - benefitsAndImpacts
            - salesMethodology
          description: >-
            AI-generated narrative fields from the active version
            (targetIcpOverview, strategicNarrative, painsAndConsequences,
            benefitsAndImpacts, salesMethodology). salesMethodology stageName
            values are Early Stage / Mid Stage / Late Stage for OCTAVE motions;
            each stage's sections are Buyer Mindset, Value Propositions, Talking
            Points, plus Methodology Focus (one entry per tenet of the
            workspace's active sales methodology) when the workspace has one.
            Null when no active version exists yet.
        learningsCount:
          type: integer
          description: Total number of current learnings for this ICP cell
        stale:
          type: boolean
          description: >-
            True when an input to this cell (persona, segment, offering, motion,
            playbook, intel, sales methodology, brand voice) changed after its
            active version was generated, or the cell has no version yet.
            Regenerate with POST /api/v2/motion-icp/regenerate.
        staleReasons:
          type: array
          items:
            type: string
          description: >-
            Why the cell is stale; empty when it is not. One or more of:
            no_version, parent_motion_updated, parent_offering_updated,
            parent_persona_updated, parent_segment_updated,
            segment_intel_updated, segment_containment_updated,
            playbook_updated, default_cell_updated, competitor_updated,
            buying_trigger_updated, new_learnings, motion_ref_updated,
            methodology_updated, brand_voice_updated.
        staleDetails:
          type: array
          items:
            $ref: '#/components/schemas/MotionIcpStaleDetail'
          description: >-
            The elements behind staleReasons — which one changed and when. A
            reason with no single element behind it (no_version) has no entry.
        latestReport:
          type: object
          nullable: true
          properties:
            oId:
              type: string
              description: Pass to GET /api/v2/report-run/get for full sections
            title:
              type: string
              nullable: true
            summary:
              type: string
              nullable: true
            windowStart:
              type: string
              nullable: true
              format: date-time
            windowEnd:
              type: string
              nullable: true
              format: date-time
            comparisonWithPrevious:
              type: object
              nullable: true
              properties:
                summaryOfChanges:
                  type: string
                emphasisShift:
                  type: string
                keyDelta:
                  type: string
                newThemes:
                  type: array
                  items:
                    type: string
                continuingThemes:
                  type: array
                  items:
                    type: string
              description: What changed vs the prior report period
          required:
            - oId
            - title
            - summary
            - windowStart
            - windowEnd
            - comparisonWithPrevious
          description: >-
            Latest completed report run summary. Only included when
            includeReport=true.
      required:
        - oId
        - motionPlaybookOId
        - persona
        - segment
        - status
        - disabled
        - narrative
        - learningsCount
        - stale
        - staleReasons
        - staleDetails
    EntityRef:
      type: object
      nullable: true
      properties:
        oId:
          type: string
        name:
          type: string
      required:
        - oId
        - name
      description: Target persona
    MotionIcpStaleDetail:
      type: object
      properties:
        reason:
          type: string
          description: The staleReasons value this element is behind
        entityType:
          type: string
          description: >-
            Kind of element that changed, e.g. Persona, Segment, Product,
            Competitor, CoreFeature, Intel, Motion, MotionPlaybook, Methodology,
            BrandVoice
        entityOId:
          type: string
          nullable: true
        entityName:
          type: string
          nullable: true
        updatedAt:
          type: string
          nullable: true
          description: When the element changed (ISO 8601). Null when unknown.
        referenceAt:
          type: string
          nullable: true
          description: >-
            The instant the change was compared against — when the cell's active
            version was generated (ISO 8601).
      required:
        - reason
        - entityType
        - entityOId
        - entityName
        - updatedAt
        - referenceAt
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key

````

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