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

> Laden Sie Dateien hoch, mit denen Devin während Sitzungen arbeiten kann. Unterstützt verschiedene Dateitypen, einschließlich Code-, Daten- und Dokumentationsdateien.

# Anhang hochladen

Dieser Endpunkt lädt Dateien auf unsere Server hoch und gibt eine URL zurück, auf die Sie in Devin-Sitzungen verweisen können. Die Datei wird nicht automatisch an eine Sitzung gesendet – Sie müssen die URL in Ihre Prompts einfügen.

<div id="how-to-use-uploaded-files">
  ## Verwendung hochgeladener Dateien
</div>

<Warning>
  Devin erkennt Anhänge nur, wenn sie exakt im Format `ATTACHMENT:"{file_url}"` geschrieben sind (`ATTACHMENT` im Singular, komplett in Großbuchstaben). Die Zeile mit `ATTACHMENT:` muss im Prompt in einer eigenen Zeile stehen, und die URL muss in doppelte Anführungszeichen eingeschlossen sein.

  Nur die URL ohne dieses Format anzugeben, funktioniert nicht. Varianten wie `ATTACHMENTS:` (Plural) werden ebenfalls nicht erkannt.
</Warning>

Um in einer Devin-Session auf eine hochgeladene Datei zu verweisen:

1. **Laden Sie die Datei hoch**, indem Sie diesen Endpoint verwenden und so eine URL erhalten
2. **Fügen Sie die URL in Ihren Prompt ein**, wenn Sie eine Session erstellen oder eine Nachricht senden
3. **Formatieren Sie die URL korrekt**, indem Sie `ATTACHMENT:"{file_url}"` in Ihrem Prompt in eine eigene Zeile schreiben

<div id="complete-example">
  ## Komplettes Beispiel
</div>

```python theme={null}
import os
import requests

DEVIN_API_KEY = os.getenv("DEVIN_API_KEY")

# Schritt 1: Datei hochladen
with open("data.csv", "rb") as f:
    response = requests.post(
        "https://api.devin.ai/v1/attachments",
        headers={"Authorization": f"Bearer {DEVIN_API_KEY}"},
        files={"file": f}
    )
file_url = response.text

# Schritt 2: Sitzung erstellen, die auf die hochgeladene Datei verweist
session_response = requests.post(
    "https://api.devin.ai/v1/sessions",
    headers={"Authorization": f"Bearer {DEVIN_API_KEY}"},
    json={
        "prompt": f"""Bitte analysieren Sie die Daten in der angehängten CSV-Datei und erstellen Sie einen Zusammenfassungsbericht.
Konzentrieren Sie sich auf die Identifizierung von Trends und wichtigen Erkenntnissen.

ATTACHMENT:"{file_url}"
"""
    }
)

print(session_response.json())
```

**Wichtig:** Das Präfix `ATTACHMENT:` muss im Prompt in einer eigenen Zeile stehen, wobei die URL in doppelte Anführungszeichen gesetzt ist, genau wie oben gezeigt: `ATTACHMENT:"{url}"`. Um mehrere Dateien anzuhängen, fügen Sie pro Datei eine Zeile `ATTACHMENT:"{file_url}"` hinzu.


## OpenAPI

````yaml de/v1-openapi.yaml POST /v1/attachments
openapi: 3.1.0
info:
  description: Devin v1 API mit persönlichen API Keys und Service-API Keys
  title: Devin API v1
  version: 1.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v1/attachments:
    post:
      summary: Anhang hochladen
      description: >-
        Laden Sie einen Dateianhang hoch, der in Devin-Sitzungen verwendet
        werden kann. Gibt die URL des hochgeladenen Anhangs als String zurück.
      operationId: upload_attachment_customer_endpoint_v1_attachments_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: >-
                #/components/schemas/Body_upload_attachment_customer_endpoint_v1_attachments_post
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                title: >-
                  Response Upload Attachment Customer Endpoint V1 Attachments
                  Post
                type: string
          description: Erfolgreiche Antwort
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validierungsfehler
components:
  schemas:
    Body_upload_attachment_customer_endpoint_v1_attachments_post:
      properties:
        file:
          format: binary
          title: File
          type: string
      required:
        - file
      title: Body_upload_attachment_customer_endpoint_v1_attachments_post
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    bearerAuth:
      description: >-
        Persönlicher API-Schlüssel (apk_user_\*) oder Service-API-Schlüssel
        (apk_\*)
      scheme: bearer
      type: http

````