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

# Download Library

> Exports the workspace library as files. With more than one entity the response is a ZIP archive with one folder per entity type (personas/, segments/, competitors/, …) and one file per entity; a single entity comes back as that file directly. Products, Services and Solutions each export with their core features and linked personas, use cases, references and segments; Competitors carry their battlecard brief and active intel; Segments and the workspace company carry their intel. Requires the CAN_EXPORT_ENTITIES entitlement.



## OpenAPI

````yaml get /api/v2/library/download
openapi: 3.0.0
info:
  version: 3.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/library/download:
    get:
      tags:
        - Library
      summary: Download Library
      description: >-
        Exports the workspace library as files. With more than one entity the
        response is a ZIP archive with one folder per entity type (personas/,
        segments/, competitors/, …) and one file per entity; a single entity
        comes back as that file directly. Products, Services and Solutions each
        export with their core features and linked personas, use cases,
        references and segments; Competitors carry their battlecard brief and
        active intel; Segments and the workspace company carry their intel.
        Requires the CAN_EXPORT_ENTITIES entitlement.
      operationId: downloadLibrary
      parameters:
        - schema:
            type: string
            description: >-
              Comma-separated entity types to include. Omit for the whole
              library. One of: UseCase, Persona, Reference, Segment, Competitor,
              Alternative, BuyingTrigger, Objection, ProofPoint, Playbook,
              Product, Service, Solution, WorkspaceCompany, WritingStyle,
              BrandVoice. Core features are not listed separately — they are
              nested inside their parent Product, Service or Solution.
            example: Persona,Segment,Competitor
          required: false
          description: >-
            Comma-separated entity types to include. Omit for the whole library.
            One of: UseCase, Persona, Reference, Segment, Competitor,
            Alternative, BuyingTrigger, Objection, ProofPoint, Playbook,
            Product, Service, Solution, WorkspaceCompany, WritingStyle,
            BrandVoice. Core features are not listed separately — they are
            nested inside their parent Product, Service or Solution.
          name: entityTypes
          in: query
        - schema:
            type: string
            description: >-
              Output format for each entity file: MARKDOWN (default) or JSON.
              Case-insensitive.
            example: MARKDOWN
          required: false
          description: >-
            Output format for each entity file: MARKDOWN (default) or JSON.
            Case-insensitive.
          name: format
          in: query
      responses:
        '200':
          description: >-
            The export. Content-Type is application/zip for multi-file
            downloads, text/markdown or application/json for a single file. The
            file name is in the Content-Disposition header.
          content:
            application/zip:
              schema:
                type: string
                format: binary
            text/markdown:
              schema:
                type: string
                format: binary
            application/json:
              schema:
                type: string
                format: binary
        '400':
          description: Unknown entity type or format, or the selection is empty
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key

````