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

# Dateien auflisten

> Alle abgeschlossenen Dateien für dein Team auflisten. Optional nach Zweck filtern.



## OpenAPI

````yaml de/openapi/files.json GET /v1/files
openapi: 3.0.3
info:
  title: Dateien-API
  version: 1.0.0
servers:
  - url: https://api.olostep.com
security: []
paths:
  /v1/files:
    get:
      summary: Dateien auflisten
      description: >-
        Liste alle abgeschlossenen Dateien für dein Team auf. Optional nach
        Zweck filtern. Gibt nur Dateien mit dem Status 'completed' zurück.
      parameters:
        - name: purpose
          in: query
          required: false
          schema:
            type: string
            enum:
              - context
              - batch
          description: >-
            Dateien nach Zweck filtern. Unterstützte Werte: 'context' oder
            'batch'.
      responses:
        '200':
          description: Erfolgreiche Antwort mit Liste der Dateien.
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    description: Die Art des Objekts. "list" für diesen Endpunkt.
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Datei-ID
                        object:
                          type: string
                          description: Die Art des Objekts. "file" für diesen Endpunkt.
                        created:
                          type: integer
                          description: Erstellter Epoch-Zeitstempel
                        filename:
                          type: string
                          description: Der Dateiname der hochgeladenen Datei
                        bytes:
                          type: integer
                          description: Dateigröße in Bytes
                        purpose:
                          type: string
                          description: Der Zweck der Datei
                        status:
                          type: string
                          description: >-
                            Dateistatus. Immer 'completed' für aufgelistete
                            Dateien.
        '401':
          description: Ungültiger API-Schlüssel
        '500':
          description: Interner Serverfehler
      security:
        - Authorization: []
components:
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Bearer-Authentifizierungsheader in der Form Bearer <token>, wobei
        <token> dein Authentifizierungstoken ist.

````