| create (default) |
Creates a new document. Fails if a document with the same id already exists |
| upsert |
Creates a new document or updates an existing document if a document with the same id already exists. |
| update |
Updates an existing document. Fails if a document with the given id does not exist. |
### Import a JSONL file
You can feed the output of a Typesense export operation directly as import to the import end-point since both use JSONL.
Here's an example file:
```json
{"id": "1", "company_name": "Stark Industries", "num_employees": 5215, "country": "USA"}
{"id": "2", "company_name": "Orbit Inc.", "num_employees": 256, "country": "UK"}
```
You can import the above `documents.jsonl` file like this.
```js
const documentsInJsonl = await fs.readFile("documents.jsonl");
client.collections('companies').documents().import(documentsInJsonl, {action: 'create'});
```
```php
$documentsInJsonl = file_get_contents('documents.jsonl');
client.collections['companies'].documents.import($documentsInJsonl, ['action' => 'create']);
```
```py
with open('documents.jsonl') as jsonl_file:
client.collections['companies'].documents.import_jsonl(jsonl_file.read(), {'action': 'create'})
```
```rb
documents_jsonl = File.read('documents.jsonl')
collections['companies'].documents.import(documents_jsonl, action: 'create')
```
```dart
final file = File('documents.jsonl');
await client.collection('companies').documents.importJSONL(file.readAsStringSync());
```
```bash
curl -H "X-TYPESENSE-API-KEY: ${TYPESENSE_API_KEY}" -X POST --data-binary @documents.jsonl \
"http://localhost:8108/collections/companies/documents/import?action=create"
```