# Getting started

## :closed\_lock\_with\_key: Generate a JWT token from Google credentials

{% file src="/files/-MMPqHLj\_iOmdwtbCl8v" %}
Google JWT generator
{% endfile %}

To generate a Google JWT token:

1. Download and unzip the ZIP file above.\
   You get a Python file named "google-jwt-generator.py".
2. Generate a Google JSON credentials file (see [Generate JSON credentials](/getting-started/set-up-google-cloud-platform.md#generate-json-credentials)).
3. Run the following script using Python:

   ```
   python3 google-jwt-generator.py your-credentials.json
   ```
4. You can save the token in a shell variable:

   ```
   TAILER_API_JWT=`python3 google-jwt-generator.py your-credentials.json`
   ```

## :digit\_one: Send a first request to the Tailer API

To communicate with the Tailer API, you can use the cURL CLI.

Here is an example of request allowing you to check the status of a Tables to Tables data operation run:

```bash
TAILER_API_JWT=`python3 google-jwt-generator.py your-credentials.json` \
&& curl --request POST \
--http2 \
--header "content-type:application/json" \
--header "Authorization: Bearer ${TAILER_API_JWT}" \
--data '{"action": "check_run_status",
         "account": "000099",
         "environment": "DEV",
         "configuration_type": "table-to-table",
         "configuration_id": "000099_iowa_liquor_prepare_pda_DEV",
         "job_id": "gbq-to-gbq|000099_iowa_liquor_prepare_pda_DEV",
         "run_id": "20201230-112837-0a795c70-2557-4a60-ba16-788aa2bea179"}' \
"https://tailer-api-nqonovswsq-ew.a.run.app/v1/dag/status"
```

### Use your Tailer identity instead

You can use the identity provided when you installed your tailer-sdk:

```bash
tailer auth get-token | awk '/User token :/ {print $4}'
```

You can use this to get your JWT token:

```bash
TAILER_API_JWT=`tailer auth get-token | awk '/User token :/ {print $4}'` \
&& curl --request POST \
--http2 \
--header "content-type:application/json" \
--header "Authorization: Bearer ${TAILER_API_JWT}" \
--data '{"action": "check_run_status",
         "account": "000099",
         "environment": "DEV",
         "configuration_type": "table-to-table",
         "configuration_id": "000099_iowa_liquor_prepare_pda_DEV",
         "job_id": "gbq-to-gbq|000099_iowa_liquor_prepare_pda_DEV",
         "run_id": "20201230-112837-0a795c70-2557-4a60-ba16-788aa2bea179"}' \
"https://tailer-api-nqonovswsq-ew.a.run.app/v1/dag/status"
```


---

# 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.tailer.ai/tailer-api/getting-started-1.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.