If you have a large collection of text rather than a single file, bulk embedding may be more efficient for you. This endpoint returns a JSONL file of text embeddings with their respective text. The JSONL will be available for 2 months and downloadable via the download\_file().

## Example Requests

### Create A Bulk Embed

#### Request

```python PYTHON
# Request
co.bulk_embed(
    model="string",
    url="string",  # (url to gcp file)
    file_id="string",  # (id to uploaded file)
    text_field="string",  # (column to get text from)
    truncate="string",  # {LEFT:DEFAULT,RIGHT}
)
```

#### Response

```python PYTHON
{job_id: "string"}
```

### Retrieve A Bulk Embed

#### Request

```python PYTHON
co.get_bulk_embed(job_id="string")
```

#### Response

```python PYTHON
# Response of co.get_bulk_embed():
{
    job_id: "string",
    status: "string",  # (COMPLETE, QUEUED, FAILED or RUNNING)
    created_at: "string",  # (timestamp)
    updated_at: "string",  # (timestamp)
    input_url: "string",
    input_file_id: "string",
    output_file_id: "string",
    model: "string",
    truncate: "string",  # (LEFT or RIGHT)
    percent_complete: float,
}
```

### List a Bulk Embed

#### Request

```python PYTHON
co.list_bulk_embed()
```

#### Response

```python PYTHON
# Response of co.list_bulk_embeds():
{
    bulk_embed: [
        {
            job_id: "string",
            status: "string",  # (COMPLETE, QUEUED, FAILED or RUNNING)
            created_at: "string",  # (timestamp)
            updated_at: "string",  # (timestamp)
            input_url: "string",
            input_file_id: "string",
            output_file_id: "string",
            model: "string",
            truncate: "string",  # (LEFT or RIGHT)
            percent_complete: float,
        },
        ...,
    ]
}
```

## Next Steps

## Related pages

- [Changelog](../changelog.md)
- [Cohere](../index.md)
- [Cohere API](./cohere-api-index.md)
- [Cohere Labs](./cohere-labs-index.md)
- [Cohere Platform](./cohere-platform-index.md)
- [Cookbooks](./cookbooks-index.md)
- [Deployment Options](./deployment-options-index.md)
- [Embeddings (Vectors, Search, Retrieval)](./embeddings-vectors-search-retrieval-index.md)
- [Get Started](./get-started-index.md)
- [Going to Production](./going-to-production-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.