# Firebase Cloud Firestore Action

This provides a way to perform queries on Firebase Cloud Firestore. Before adding Firebase Cloud Firestore Action, user has to define a [**Firebase Connection**.](/connections/firebase-connection.md) User need to provide following parameters to perform Firebase Cloud Firestore related queries.

#### Action

User need to select Cloud Firestore Operation e.g. Set, Get, Update, Delete

#### Function

* User can write JavaScript code to create dynamic query.
* "payload" object, collection, where, orderby, doc objects are available in this code which are directly used in Cloud Firestore operations.

```
//Example 1

payload["time"] = Date.now(); // Modify Payload

collection = "cities"; //Override collection here

orderby = { "name":"desc"} ; // Use orderby for Get Operation 

doc = ""; // If doc value is not required.

where.push({ // If where conditions are used in Get Query
key:"state",
condition:"==",
value:"CA"
})

```

#### Collection

User need to provide collection name for Firestore operation.

#### Doc

User need to provide Doc name for Firestore operation. if not required, override to "" in Function.

#### Limit

User can set Limit No. of Responses in case of Get Query.

#### Connection ID

User need to provide a Connection ID of Firebase database connection.

![Add Firebase Cloud Firestore Action](/files/dHChTH3EBTIuWOEZ18u7)

Please note the following points:

{% hint style="info" %}

* Get more details at [Google Cloud Firestore.](https://firebase.google.com/docs/firestore/quickstart)
* "payload" object is supplied from Action Trigger like Rules, Action Command etc.
* Data Response of operation will be available as Action Response.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thingsup.io/actions/firebase-cloud-firestore-action.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
