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

# Search facts and documents together

> Searches the end-user's own facts, the workspace, and every collection in it,
and returns facts and passages in one ranked list with the source of each. This
replaces the separate fact and document search endpoints. Metered as one
retrieval.



## OpenAPI

````yaml /api-reference/openapi.json post /recall/search
openapi: 3.1.0
info:
  title: Akumi
  version: 0.0.1
servers:
  - url: https://api.akumi.eu/v1
    description: Production
security:
  - http: []
tags:
  - name: Audit log
  - name: Chat completions
  - name: Embeddings
  - name: Models
  - name: Recall
  - name: Scores
paths:
  /recall/search:
    post:
      tags:
        - Recall
      summary: Search facts and documents together
      description: >-
        Searches the end-user's own facts, the workspace, and every collection
        in it,

        and returns facts and passages in one ranked list with the source of
        each. This

        replaces the separate fact and document search endpoints. Metered as one

        retrieval.
      operationId: v1.recall.search
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items: {}
                required:
                  - data
        '401':
          $ref: '#/components/responses/AuthenticationException'
        '422':
          $ref: '#/components/responses/ValidationException'
components:
  schemas:
    SearchRequest:
      type: object
      description: >-
        Validates a POST /v1/recall/search body: the unified retrieval endpoint
        over

        the caller's personal scope, the workspace, and every collection in it,
        or

        over exactly the collections named in `collection`.
      properties:
        query:
          type: string
          maxLength: 2000
        collection:
          type:
            - array
            - 'null'
          description: |-
            Omit it to blend every collection in the workspace; pass a
            collection slug, or a list of slugs, to read only those plus the
            caller's own personal memory. A slug the workspace does not have
            is rejected, never ignored.
          items:
            type: string
            maxLength: 255
        user_ref:
          type:
            - string
            - 'null'
          maxLength: 255
        limit:
          type:
            - integer
            - 'null'
          minimum: 1
          maximum: 50
      required:
        - query
      title: SearchRequest
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    ValidationException:
      description: Validation error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Errors overview.
              errors:
                type: object
                description: A detailed description of each field that failed validation.
                additionalProperties:
                  type: array
                  items:
                    type: string
            required:
              - message
              - errors
  securitySchemes:
    http:
      type: http
      scheme: bearer

````