MongoDB.DeleteOne
-----------------

Deletes one record.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [MongoDB](component_MongoDB.md) | [12.3](newinversion123.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "MongoDB.DeleteOne"; MongoDBRef; selectorJSON { ; OptionsJSON } ) 

**MBS**( **"MongoDB.DeleteOne";** /\* Deletes one record. \*/  
**$MongoDBRef**; /\* The reference number for the mongo connection.e.g. $MongoDB \*/   
**$selectorJSON**; /\* A JSON containing the query to match documents for deleting. \*/   
**$OptionsJSON**) /\* Optional; Options as JSON. \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| MongoDBRef | The reference number for the mongo connection. | $MongoDB |  |
| selectorJSON | A JSON containing the query to match documents for deleting. |  |  |
| OptionsJSON | Options as JSON. |  | Optional |

### Result

Returns JSON or error.

### Description

Deletes one record.  
This function removes at most one document in the given collection that matches selector.  
If there are multiple documents (records), the others are ignored.  
  
To delete all matching documents, use [MongoDB.DeleteMany](MongoDBDeleteMany.md).  
Returns string with JSON about errors on server.  
  
### Examples

Delete one record machting:

 Set Variable \[ $r ; Value: MBS ( "MongoDB.DeleteOne"; $Mongo ; "{\\"Hello\\": \\"World\\"}") \]  
### See also

- [MongoDB.DeleteMany](MongoDBDeleteMany.md)
- [MongoDB.InsertOne](MongoDBInsertOne.md)
- [MongoDB.ReplaceOne](MongoDBReplaceOne.md)
- [MongoDB.UpdateOne](MongoDBUpdateOne.md)

### Example Databases

- [MongoDB/MongoDB Blog](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/MongoDB/MongoDB%20Blog.shtml#19ScriptAnchor_)

This function checks for a license.

Created 27th May 2022 , last changed 20th June 2022

  
[MongoDB.DeleteMany](MongoDBDeleteMany.md) - [MongoDB.EstimatedDocumentCount](MongoDBEstimatedDocumentCount.md)

[HTML Version](MongoDBDeleteOne.shtml)