# Introduction

{% hint style="info" %}
This feature is in Beta.
{% endhint %}

## About the API

The Erathos API is designed to enable seamless programmatic interaction with our platform, allowing you to customize workflows to suit your architecture and specific requirements.

<figure><img src="/files/8LttLbaHvZzGvLwvKmfy" alt=""><figcaption></figcaption></figure>

There are two main use cases that guided the development of the Erathos API:

* [**Trigger Jobs Outside Erathos**](/api/introduction/trigger-jobs-outside-erathos.md): At the end of a job execution, the Erathos platform makes a request to a specified endpoint, allowing external systems to receive updates or act on the results.
* [**Trigger Jobs in Erathos**](/api/introduction/trigger-jobs-in-erathos.md): Job executions can be initiated by external agents, such as orchestration tools like Airflow or other third-party systems, ensuring seamless integration with your existing workflows.

## Quickstart

Access our quick-start examples for a faster and more streamlined implementation.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Airflow</td><td><a href="/pages/mla7iPIFlMUSTMUKZ40e">/pages/mla7iPIFlMUSTMUKZ40e</a></td></tr><tr><td>Dbt Cloud</td><td><a href="/pages/joD1YKTeUUREnlNtU7xA">/pages/joD1YKTeUUREnlNtU7xA</a></td></tr><tr><td>Erathos</td><td><a href="/pages/8XXrINIDHy1KutJ6DoGh">/pages/8XXrINIDHy1KutJ6DoGh</a></td></tr><tr><td>Prefect</td><td><a href="/pages/v1cFjvTDIXeBvXpRiQGm">/pages/v1cFjvTDIXeBvXpRiQGm</a></td></tr></tbody></table>

## Concepts

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Authentication</td><td><a href="/pages/cbM54PBjp0IsvsYp8MvY">/pages/cbM54PBjp0IsvsYp8MvY</a></td></tr><tr><td>Metadata</td><td><a href="/pages/A7yiasVdnqtEt0qGyAFQ">/pages/A7yiasVdnqtEt0qGyAFQ</a></td></tr><tr><td>Rules</td><td><a href="/pages/OcyNFfmaDKJnww8g3ex5">/pages/OcyNFfmaDKJnww8g3ex5</a></td></tr><tr><td>Variables and Secrets</td><td><a href="/pages/iEn4PUSTrb7mHyrmbhEN">/pages/iEn4PUSTrb7mHyrmbhEN</a></td></tr></tbody></table>

## API Reference

To view details about the available endpoints, visit the following pages:

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Jobs</td><td><a href="/pages/NdxOxxNl5RUXeqNR9vFy">/pages/NdxOxxNl5RUXeqNR9vFy</a></td></tr><tr><td>Orchestration</td><td><a href="/pages/D5CbopsPBCAOFm6nEnBo">/pages/D5CbopsPBCAOFm6nEnBo</a></td></tr><tr><td>Secrets</td><td><a href="/pages/uLWn4idPjgxS4sZElLmy">/pages/uLWn4idPjgxS4sZElLmy</a></td></tr><tr><td>Variables</td><td><a href="/pages/2oW3itgZy2N75w3Volw5">/pages/2oW3itgZy2N75w3Volw5</a></td></tr><tr><td>Workspaces</td><td><a href="/pages/7xz107c5wLguU4ZWUrcI">/pages/7xz107c5wLguU4ZWUrcI</a></td></tr></tbody></table>

## Limitations

This section outlines the constraints and boundaries of the **Orchestration** feature to help you better understand its current capabilities. Being aware of these limitations ensures optimal usage while avoiding unexpected behavior or errors in your workflows.

### Job Dependencies

For API connectors, dependent jobs may exist, meaning certain endpoints require data from the primary endpoint. For instance, a primary endpoint that lists users might have a dependent endpoint that provides detailed information about each user based on their identifier.

These dependent jobs cannot run independently. To execute a dependent job, the primary job must be executed first. When the primary job runs, all its dependent jobs are automatically executed afterward.

### Block Window

Programmatic use of the [**Run**](/api/api-reference/jobs.md#developers-workspaces-workspace_id-jobs-_id-run) endpoint is treated as a manual execution, equivalent to initiating a new manual execution directly through the platform. Similarly, if a [Block Window](/platform/connections/block-window.md) is configured for the same time as the **Run** orchestration and the *Allow manual executions* indicator is disabled, new executions will be blocked, and the API will return a 400 response, preventing the execution from starting.


---

# 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.erathos.com/api/introduction.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.