# Analytics

{{% notice style="note" title="Limited access" icon="lock" %}}
{{% include file="include/restricted_access.md" hidefirstheading="true"  %}}
{{% /notice %}}

## Analytic tasks

An **analytic task** is a JSON document that describes an analysis over your stored data. The platform turns
that document into the query it runs against the data store, so the task is a declaration of what to compute
rather than code you write. Some of its fields are mandatory.

## Where analytics actually happens

Analytics in OpenGate spans more than this API, and the working documentation lives elsewhere:

| To | Go to |
|---|---|
| Write and run analysis interactively, in Jupyter Lab | [Analytics and Datalab](/2-howtos/10-analytics-and-datalab/) |
| Read and write platform data from Python | The `opengate-data` library, in [OpenGate Libraries](/libs/) |
| Run a notebook unattended, once or on a schedule | [Notebook scheduler](../opengate_data_notebook_scheduler/) |
| Query stored data directly over REST | [What you can query](../what_you_can_query/) |
| Configure the platform's AI settings | The [Analytics section](/ux/analytics/) of the web console |

If you are looking for *how to analyse your data*, the Datalab how-to and the notebook scheduler are the
practical route. This page covers only the analytic task API object.

{{% notice style="note" title="Specification not currently published" icon="circle-info" %}}
The API specification for analytic tasks is not shipped with the documentation at the moment, so the endpoint
reference is unavailable here. Ask your platform contact for the endpoint details in the meantime.
{{% /notice %}}