# APIs Reference

Welcome to IOH API. Here you'll find all the documentation you need to get up and running with the APIs for the [IoT Orchestration Hub](https://console.connectedyou.io).

You can find our APIs at [docs.api.connectedyou.io](https://docs.api.connectedyou.io/#intro).

Feel free to write in to our [support desk](https://connectedyou.atlassian.net/servicedesk/customer/portal/1/group/1/create/10) for any questions or suggestions.

There are 3 basic steps to follow to get quickly started using the IOH APIs:

* [Authenticate](#authenticate)
* [Get account ID](#get-account-id)
* [Use the APIs](#make-your-first-request)

## Authenticate

Use the Auth endpoint: [`https://api.connectedyou.io/`](https://api.connectedyou.io/) to authenticate and generate the access tokens.

As part of the response you will receive an `access_token` that you must use in authorization headers henceforth.

The access token typically lasts for 1 hour for security reasons. You will need to either use a `refresh_token` to generate a new access token or you can re-authenticate.

## Get account ID

Using the API endpoint: [`https://api.connectedyou.io/v1`](https://api.connectedyou.io/v1), you can now retrieve the account ID for your user. 

Select one of the account IDs that you have access to. 

{% hint style="info" %}
You can also find your account ID on your account settings page. 
{% endhint %}

<figure><img src="/files/BJFRKkOnN6DZ8pcd6JPZ" alt=""><figcaption></figcaption></figure>

## Make your first request

To make your first request in your account, send an authenticated request to the API endpoint: [`https://api.connectedyou.io/v1`](https://api.connectedyou.io/v1).&#x20;

Now you are well on your way to trying out the other APIs to automate your workflows.


---

# 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.connectedyou.io/knowledge-base/connectedyou-platform/api-docs/apis-reference.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.