> ## Documentation Index
> Fetch the complete documentation index at: https://api-documentation.kare-app.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Get authorized navigation and creation metadata for the current RS session.



## OpenAPI

````yaml /api/rs/openapi.json get /rs/search/v1/catalog
openapi: 3.0.3
info:
  title: KARE API
  description: Backend API for the KARE platform
  version: dev
servers:
  - url: http://localhost:3000
    description: Local dev
security: []
tags:
  - name: better-auth
    description: >-
      Better Auth's own endpoints (sign-in, session, MFA, password) - generated
      from the audience's live config via `generateOpenAPISchema()`, not
      hand-written.
paths:
  /rs/search/v1/catalog:
    get:
      tags:
        - search
      summary: >-
        Get authorized navigation and creation metadata for the current RS
        session.
      operationId: getSearchCatalogRSV1
      parameters:
        - schema:
            type: string
            maxLength: 500
          in: query
          name: q
          required: false
          description: >-
            Literal query for native Fuse suggestions, at most three per group.
            Omit or leave blank for the complete authorized catalogue.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  pages:
                    maxItems: 32
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          enum:
                            - dashboard
                            - calendar
                            - inbox_pending
                            - inbox_received
                            - inbox_sent
                            - inbox_trash
                            - messages
                            - anomalies
                            - interventions
                            - curative_interventions
                            - exercises
                            - personnel
                            - documents
                            - plans
                            - equipments
                            - register
                            - maintenance
                            - deadlines
                            - commissions
                            - building_works
                            - controls
                            - reports
                            - providers
                            - formations
                            - qualifications
                            - activity_logs
                            - rules
                            - technical_installations
                            - labels
                            - units
                            - estate
                            - responsibilities
                      required:
                        - id
                      additionalProperties: false
                  commands:
                    maxItems: 8
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          enum:
                            - preventiveIntervention
                            - curativeIntervention
                            - commission
                            - observation
                            - equipment
                            - buildingWork
                            - importReport
                            - formation
                      required:
                        - id
                      additionalProperties: false
                  firstGroup:
                    type: string
                    enum:
                      - pages
                      - commands
                    description: >-
                      Category of the first native Fuse result; commands when
                      both lists are empty.
                required:
                  - pages
                  - commands
                  - firstGroup
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false

````