# Upload Guest Profile Documents

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Guest Profiles
> Source: https://www.podengine.ai/api-docs/upload-guest-profile-documents.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/upload-guest-profile-documents
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### POST /api/v1/guest-profiles/:guestProfileId/documents
**Upload Guest Profile Documents**

Upload files (PDF, DOCX, TXT, CSV, JPG, JPEG, PNG) to a guest profile. Documents are automatically analyzed in the background. Send files as multipart form data with field name "documents". Maximum 5 files per request.

```bash
curl -X POST "http://localhost:4000/api/v1/guest-profiles/example-guest-profile-id/documents" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Path parameters schema:**
```json
{
  "type": "object",
  "properties": {
    "guestProfileId": {
      "type": "string",
      "description": "The guest profile ID"
    }
  },
  "required": [
    "guestProfileId"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "uploadedDocuments": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The document ID"
              },
              "fileName": {
                "type": "string",
                "description": "Original file name"
              },
              "fileSize": {
                "type": "number",
                "description": "File size in bytes"
              }
            },
            "required": [
              "id",
              "fileName",
              "fileSize"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "uploadedDocuments"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai