# HTTP API (Call an Osmos API) \*\*DEPRECATED\*\*

## Overview

There are two modes of operation for this connector. Either Osmos will call your API, or Osmos can generate an API for you to call. Put another way, either you have an API endpoint created, or you want Osmos to create an API endpoint for you. These two modes will be referred to as *Osmos Calls Your API* and *Call an Osmos API* respectively. This page is for the latter. To see documentation on the former, see [HTTP API (*Osmos Calls Your API*).](https://docs.osmos.io/destination-connectors/http-api-osmos-calls-your-api)

This Destination Connector creates a secure API endpoint that you can send data to within Osmos. After sending data to this connector, you can retrieve (GET) data from the API endpoint outside of Osmos using the provided URL.

## Creating an HTTP API Destination Connector

**Step 1:** After selecting **+ New Connector**, under the **System** prompt, click HTTP AP&#x49;**.**

![](https://353417064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYrsDW6vGBTygB1qqSE%2Fuploads%2FhvtMtdhz8EMFOUifJObD%2FHTTP%20API.png?alt=media\&token=6b0fa5f9-b3aa-4c18-8af4-aec8e10ebbab)

**Step 2:** Provide a **Connector Name.**

**Step 3:** Select **Destination Connector.**

**Step 4:** Select **Call an Osmos API**

### **Step 5: Building the Schema for the API Endpoint**

![](https://353417064-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYrsDW6vGBTygB1qqSE%2F-MYzModXo7qYLoVm0Fuv%2F-MZAhLIR_rAexEPvI1Y4%2Fimage.png?alt=media\&token=2d9f9118-0b5e-488f-9792-4772ef069931)

| Parameter  | Description                                                                                                                                                 |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Field Name | Provide a field name for the output fields. These names will be used as the column names for the source data you send to this API.                          |
| Type       | Define the type of each field. The field types will be used to enforce rules when you send data to this API.                                                |
| Nullable   | Check this box if the field is nullable. If the field is not nullable, you will be required to provide values for this field when sending data to this API. |
| Delete     | Deletes the Field                                                                                                                                           |

\
**1.** Click **Add Field** for each additional field required in the schema.\
\
**2.** Select **Create Schema** once you have built the schema.&#x20;

### API Endpoint&#x20;

An API endpoint has been created based on the schema built in the previous step.

You can send data to this API endpoint from a Source Connector within Osmos using an Osmos Pipeline. Following this, you can retrieve (GET) data from this API endpoint using the provided URL.

![](https://353417064-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYrsDW6vGBTygB1qqSE%2F-Ma5_KxNzQiIN5DNt0gN%2F-Ma5hxVRA_TKBxW6QurK%2Fimage.png?alt=media\&token=81544d1a-0b08-4540-808f-b63c9f524766)

{% hint style="info" %}
**Note:** Performing a retrieval (GET) from the Osmos API endpoint bypasses the standard Osmos batch write process, and so no record counts will be displayed in the Pipeline or Uploader management page.&#x20;
{% endhint %}

<figure><img src="https://353417064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYrsDW6vGBTygB1qqSE%2Fuploads%2FbRq4RDJSCXbqpAUYMIe0%2FScreen%20Shot%202022-08-29%20at%201.41.15%20PM.png?alt=media&#x26;token=a0bbf557-f8e3-471c-9fa5-69ad8e17ef5c" alt=""><figcaption></figcaption></figure>

## Connector Options

The connector can be deleted, edited and duplicated.

Duplication

To save time, the connector can be duplicated.  This new connector needs to be named and can be edited, as needed.

<figure><img src="https://353417064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYrsDW6vGBTygB1qqSE%2Fuploads%2FcqHEMJsu15tuc9tGv1xz%2FCleanShot%202024-01-04%20at%2020.53.21%402x.png?alt=media&#x26;token=4acb0589-a751-404e-858a-983b57a6a69b" alt="" width="563"><figcaption></figcaption></figure>
