# Basic workflow

There are essentially three basic steps to be followed to run a calculation using the cloud API(s)

1. Login request to the OLI Cloud authentication endpoint using user credentials. The JWT(JSON Web Token obtained in this step will be passed in the authorization header in all subsequent calls to the API)
2. Upload a chemistry model file (.dbs) to the upload endpoint and receive the file id.
3. Send a request to a specific calculation endpoint with required JSON input in body payload. The chemistry model file will be part of calculation endpoint URL
4. Poll on the results link obtained from step 2 until calculation is processed and result is obtained in JSON format

{% hint style="info" %}
Once a chemistry file is uploaded and a file id is obtained, it is not necessary to reupload the file again for subsequent calculations. Only the file id is needed
{% endhint %}

A basic block diagram of this calculation workflow is given below. Click on image to expand

![](/files/-MXxyYxJUuwk0mHbeULo)


---

# 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://devdocs.olisystems.com/basic-workflow.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.