# API docs Checkout API details in [Swagger API Documentation](https://gochat.hyppo.io/api) See [API limits](/docs/common-errors/platform-default-limits.md) ### Intro to APIs GoChat API is used to retrieve data from the flow you build. Here are some examples that you could do with GoChat API. * Pull the flow you have built from GoChat. * Create, delete or obtain data including flow tag, flow field. * Dealing with the data about the subscribers, involving getting the subsribers' information, editing their tag or field as well as the subflow sended to the subscribers. * Configure all the data used in e-commerce such as carts or products. If you need to deal with the data below, next sections will introduce the steps to use the GoChat API. ### Authorize Since the protection of the data is important to the API, it needs to use several attribute to authorize your identity. Therefore, the first step you must do is to enter the authorized information. You need to click the Authorize button, as the following figure shown.

Then, there are three attributes that you need to fill in the textbox.

Here are the ways to find these attributes in the following section. #### Generate API Key (http,Bearer) Step 1 After you login the account in GoChat, at the top right corner, it will show your account name and avatar. Click it and choose the Your Settings in the dropdown list.

Step 2 Go to the API Keys Section by clicking the button in the User Setting. Enter the key name you would like to set and click the Create button.

Step 3 Then you will get key in a pop-up window.

WARNING Here is your new API Key. This is the only time the key will ever be displayed, so be sure not to lose it! You may revoke the key at any time from your API settings. Close the window you will get the basic information about the key except the value of the key. ### Get the Curl and Request URL Curl is used in API requests. In GoChat API documentation, you need some operation before getting the curl in the GoChat api documentation. Here, we use Get Flow Tag as an example.

Step 1. Click the expand operation of category, the Flow Tag in this case. Then find the action and the feature, Get /flow/tags. Click the row and a page will dropdown shown as following.

Step 2. This logo means authorize. If you have done this before, this step is not required. Or, you just do the same as it was mentioned before in the Authorize section. Step 3. Click Try it out. Then you will see that the Parameters or Request body part could be inputted and the Exexute Button is shown at the bottom of this part.

Step 4. Enter the parameters or request body required and click the Exexute Button. Finally you will get the Curl and Request URL.

TIP Click the Clear button if you need reset the parameters. ### Responses This part display the Json result you will get from the GoChat API. Normally if the code is 200, it means that you get the response successfully. If the code is 400, it means that there is error in your response.

### Example Value / Schema

Apart from example value, you can click on "Schema" to view more details like which value is mandatory.

--- # 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://gochat.gitbook.io/docs/api.md?ask= ``` 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.