## Upsert Batch Pipeline Documents

`pipelines.documents.upsert(strpipeline_id, DocumentUpsertParams**kwargs)  -> DocumentUpsertResponse`

**put** `/api/v1/pipelines/{pipeline_id}/documents`

Batch create or update a document for a pipeline.

### Parameters

- `pipeline_id: str`

- `body: Iterable[CloudDocumentCreateParam]`

  - `metadata: Dict[str, object]`

  - `text: str`

  - `id: Optional[str]`

  - `excluded_embed_metadata_keys: Optional[List[str]]`

  - `excluded_llm_metadata_keys: Optional[List[str]]`

  - `page_positions: Optional[List[int]]`

    indices in the CloudDocument.text where a new page begins. e.g. Second page starts at index specified by page_positions[1].

### Returns

- `List[CloudDocument]`

  - `id: str`

  - `metadata: Dict[str, object]`

  - `text: str`

  - `excluded_embed_metadata_keys: Optional[List[str]]`

  - `excluded_llm_metadata_keys: Optional[List[str]]`

  - `page_positions: Optional[List[int]]`

    indices in the CloudDocument.text where a new page begins. e.g. Second page starts at index specified by page_positions[1].

  - `status_metadata: Optional[Dict[str, object]]`

### Example

```python
import os
from llama_cloud import LlamaCloud

client = LlamaCloud(
    api_key=os.environ.get("LLAMA_CLOUD_API_KEY"),  # This is the default and can be omitted
)
cloud_documents = client.pipelines.documents.upsert(
    pipeline_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    body=[{
        "metadata": {
            "foo": "bar"
        },
        "text": "text",
    }],
)
print(cloud_documents)
```

#### Response

```json
[
  {
    "id": "id",
    "metadata": {
      "foo": "bar"
    },
    "text": "text",
    "excluded_embed_metadata_keys": [
      "string"
    ],
    "excluded_llm_metadata_keys": [
      "string"
    ],
    "page_positions": [
      0
    ],
    "status_metadata": {
      "foo": "bar"
    }
  }
]
```