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

# Generate Analysis Cards

> Generate an LLM-orchestrated card layout for an analysis.

The LLM selects which reusable card components to display,
fills their data from the analysis, and optionally generates
dynamic HTML cards for novel insights.

Returns: { "cards": [{ "type": "...", "data": {...} }, ...] }



## OpenAPI

````yaml /api/openapi.json post /agent/v1/analysis/{analysis_id}/generate-cards
openapi: 3.1.0
info:
  title: CrowdListen Agent API
  description: >-
    Configure sources, collect and retain originals, run durable analysis, and
    read or revise cited insights. Humans and agents share authorized
    entity/project records, research jobs and evidence history.
  version: 1.0.0
servers:
  - url: https://agent.crowdlisten.com
    description: Production
  - url: http://localhost:8000
    description: Local development
security: []
paths:
  /agent/v1/analysis/{analysis_id}/generate-cards:
    post:
      tags:
        - analysis
      summary: Generate Analysis Cards
      description: |-
        Generate an LLM-orchestrated card layout for an analysis.

        The LLM selects which reusable card components to display,
        fills their data from the analysis, and optionally generates
        dynamic HTML cards for novel insights.

        Returns: { "cards": [{ "type": "...", "data": {...} }, ...] }
      operationId: >-
        generate_analysis_cards_agent_v1_analysis__analysis_id__generate_cards_post
      parameters:
        - name: analysis_id
          in: path
          required: true
          schema:
            type: string
            title: Analysis Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````

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