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

# Upload

> Upload text or video URLs (JSON)

Upload text memories or video URLs using JSON.

## Parameters

<ParamField body="unique_id" type="string" required>
  Bucket ID to upload to
</ParamField>

<ParamField body="text" type="string">
  Text memory or description
</ParamField>

<ParamField body="url" type="string">
  Video URL (direct link to mp4, etc.)
</ParamField>

<ParamField body="tags" type="array">
  Array of tags
</ParamField>

<ParamField body="latitude" type="string">
  GPS latitude
</ParamField>

<ParamField body="longitude" type="string">
  GPS longitude
</ParamField>

<ParamField body="timestamp" type="string">
  ISO timestamp for the memory
</ParamField>

## Examples

<RequestExample>
  ```python Text Memory theme={null}
  import requests

  response = requests.post(
      "https://memoryapi-production.up.railway.app/upload",
      headers={"X-API-Key": "xinobi", "Content-Type": "application/json"},
      json={
          "unique_id": "your-bucket-id",
          "text": "Had coffee with Sarah, discussed the new project",
          "tags": ["meeting", "project"]
      }
  )
  ```

  ```python Video URL theme={null}
  import requests

  response = requests.post(
      "https://memoryapi-production.up.railway.app/upload",
      headers={"X-API-Key": "xinobi", "Content-Type": "application/json"},
      json={
          "unique_id": "your-bucket-id",
          "url": "https://example.com/video.mp4"
      }
  )
  ```

  ```python Text + Video URL theme={null}
  import requests

  response = requests.post(
      "https://memoryapi-production.up.railway.app/upload",
      headers={"X-API-Key": "xinobi", "Content-Type": "application/json"},
      json={
          "unique_id": "your-bucket-id",
          "text": "Family vacation highlights",
          "url": "https://example.com/video.mp4",
          "tags": ["vacation", "family"]
      }
  )
  ```
</RequestExample>

<ResponseExample>
  ```json Text Only theme={null}
  {
    "uploads": {
      "text": {
        "code": "0000",
        "msg": "success",
        "data": [
          { "id": "651750884146184192", "content": "Had coffee with Sarah..." }
        ]
      }
    }
  }
  ```

  ```json Video URL theme={null}
  {
    "uploads": {
      "video_url": {
        "code": "0000",
        "msg": "success",
        "data": { "videoNo": "VI651752673251721216", "videoName": "my_video" }
      }
    }
  }
  ```
</ResponseExample>