# Post a New Question

{% hint style="info" %}
Post a New Question for audio conversations.
{% endhint %}

## Post new Question

<img src="/files/l38w2vketXEkLZX7OYhz" alt="API: - https://matar.in.ngrok.io/api/v1//new_post?organization_id={{default_organization_id}}" class="gitbook-drawing">

### Params

**Query Parameter ⬇️**

<table data-full-width="false"><thead><tr><th width="234.33333333333331">Query Parameter</th><th width="129">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>organization_id </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td>Organization ID in which post has to be created</td></tr></tbody></table>

**Header Parameter ⬇️**

<table data-full-width="false"><thead><tr><th width="231.33333333333331">Header Parameter</th><th width="129">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>Bearer {{access_token}} </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td>Access tokens securely contain details for the user posting the question as an audio file.</td></tr></tbody></table>

**Body Parameter ⬇️**

<table data-full-width="false"><thead><tr><th width="229.33333333333331">Body Parameter</th><th width="129">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>file </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td>Audio file to post. Audio Format Supported types: flac single channel mono audio. Max audio duration: 120 seconds</td></tr><tr><td><strong>category_id </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td><p>A category ID in which an audio post has to be uploaded. Some categories are science, happiness, society, fitness, etc. </p><p></p><p>To see a list of known Categories with respect to Category ID mapping check Get all Categories API Endpoint.</p></td></tr></tbody></table>

***

**Sample Request ⬇️️**

```
curl --location 'https://matar.in.ngrok.io/api/v1/new_post?organization_id=129487316' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmcmVzaCI6dHJ1ZSwiaWF0IjoxNjkyODcyNDIxLCJqdGkiOiIyZmNiODJiYi0zMDYzLTQzNGUtOGM5OS00NTVjMDhhY2Y3MmMiLCJ0eXBlIjoiYWNjZXNzIiwic3ViIjoiMzk1MDFUIiwibmJmIjoxNjkyODcyNDIxLCJleHAiOjE2OTM3MzY0MjF9.ovz0ItiPsYG_rqT3vEYl42WZBonX52NXf-oWE4DuGmQ' \
--form 'file=@"YcyZ1KDNO/Sehat Question.flac"' \
--form 'category_id="TFTWNI"'
```

**Responses ⬇️**

Status Code: **🟢200** (200 denotes **'ok'**)

```200
{
    "message": "Post received.. generated transcription",
    "post": {
        "_id": "ACDM6HSQB3",
        "audio_data": null,
        "audio_text": "हमें अपनी अच्छी सेहत के लिए क्या करना चाहिए?",
        "audio_translation": null,
        "audio_url": "https://matar-audio.s3.ap-south-1.amazonaws.com/IT8WGDH8Z4v2Sehat_Question.flac",
        "category_ids": [
            "TFTWNI"
        ],
        "chatgpt_query_id": null,
        "created_at": "24/08/2023 , 10:36 AM",
        "data": {
            "duration": 4.56
        },
        "is_active": true,
        "is_chatgpt_enabled": false,
        "organization_id": "129487316",
        "parent_post_id": null,
        "sort_order": null,
        "text": "हमें अपनी अच्छी सेहत के लिए क्या करना चाहिए?",
        "user": {
            "_id": "39501T",
            "image_url": "https://listapp-images.s3.ap-south-1.amazonaws.com/matar_profile_05.png",
            "name": "Sri"
        },
        "user_id": "39501T",
        "whisper_id": null
    }
}
```

Status Code: 🔴**400** (400 denotes **'Bad request'**)

```
/// Response 1
{
    "error": "No file provided"
}
///// Response 2
{
    "message": "no such category"
}
```

***

**Response Parameters Description:**

<table><thead><tr><th width="232">Response Parameter</th><th>Description</th></tr></thead><tbody><tr><td>message</td><td>A response message displayed by servers when a question is successfully posted.</td></tr><tr><td>post_id</td><td>A unique identifier generated in map to posted question.</td></tr><tr><td>post_audio_text</td><td>Contains transcribed version of audio post.</td></tr><tr><td>post_audio_url</td><td>URL of where audio post is stored.</td></tr><tr><td>category_ids</td><td>A unique identifier containing the category in which question is posted.</td></tr><tr><td>chatgpt_query_id</td><td>A chatgpt unique identifier linked to audio question asked by users.</td></tr><tr><td>created_at</td><td>Post creation date</td></tr><tr><td>duration</td><td>Duration of audio post in minutes and seconds.</td></tr><tr><td>is_active</td><td>Is organization active or not.</td></tr><tr><td>is_chatgpt_enabled</td><td>Is chat gpt enabled to answer to post.</td></tr><tr><td>organization_id</td><td>Organization in which the question is posted.</td></tr><tr><td>parent_post_id</td><td>If question post has replies or child post then the question has a valid parent_post_id. parent_post_id is set to null when question post has no replies.</td></tr><tr><td>sort_order</td><td>When there are multiple posts to display they are sorted by sort order and has a number assigned to it. If there is a single post to display the sort_order will be set to null.</td></tr><tr><td>text</td><td>Contains post text transcribed from audio.</td></tr><tr><td>user_id</td><td>User ID of the account from which audio is posted.</td></tr><tr><td>user image_url</td><td>Image URL containing the user account image.</td></tr><tr><td>user_name</td><td>Name for the user account.</td></tr><tr><td>whisper_id</td><td>Used internally for speech-to-text tasks.</td></tr></tbody></table>

***

## Create a Child Post.

<img src="/files/l38w2vketXEkLZX7OYhz" alt="API: - https://matar.in.ngrok.io/api/v1//new_post?organization_id={{default_organization_id}}" class="gitbook-drawing">

### Params

**Query Parameter ⬇️**

<table data-full-width="false"><thead><tr><th width="234.33333333333331">Body Parameter</th><th width="129">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>organization_id </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td>Organization ID in which post has to be created</td></tr></tbody></table>

**Header Parameter ⬇️**

<table data-full-width="false"><thead><tr><th width="231.33333333333331">Header Parameter</th><th width="129">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>Bearer {{access_token}} </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td>Access tokens securely contain details for the user posting the question as an audio file.</td></tr></tbody></table>

**Body Parameter ⬇️**

<table data-full-width="false"><thead><tr><th width="229.33333333333331">Header Parameter</th><th width="129">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>file </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td>Audio file containing the answer. Audio Format Supported types: flac single channel mono audio. Max audio duration: 120 seconds</td></tr><tr><td><strong>category_id </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td><p>A category ID in which a post is uploaded. Some categories are science, happiness, society, fitness, etc. </p><p>To see a list of known Categories with respect to Category ID mapping check Get all Categories API Endpoint.</p></td></tr><tr><td><strong>parent_post_id </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td>Parent Post ID is the Post ID of the posted Question to link child/answer post.</td></tr></tbody></table>

***

**Sample Request ⬇️️**&#x20;

```
curl --location 'https://matar.in.ngrok.io/api/v1/new_post?organization_id=K7QUEV' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmcmVzaCI6dHJ1ZSwiaWF0IjoxNjkzMjk4NDEwLCJqdGkiOiJiYmE3NzdhYy05MTA5LTQyOTQtYjhkNy04NmQ1NDZiNTVmOGEiLCJ0eXBlIjoiYWNjZXNzIiwic3ViIjoiRUE5UzZaIiwibmJmIjoxNjkzMjk4NDEwLCJleHAiOjE2OTQxNjI0MTB9.qn7dyTb9ws4lrGdAoh6rAzu24gos-EIY3lbloFJTrH4' \
--form 'file=@"xglbaJXSR/Sehat Question.flac"' \
--form 'parent_post_id="9TX90RLDR4"' \
--form 'category_id="TFTWNI"'
```

**Responses ⬇️**

Status Code: **🟢200** (200 denotes **'ok'**)

```200
{
    "message": "Post received.. generated transcription",
    "post": {
        "_id": "K74Q9PXAXG",
        "audio_data": null,
        "audio_text": null,
        "audio_translation": null,
        "audio_url": "https://matar-audio.s3.ap-south-1.amazonaws.com/L89W2SSZRBv2Sehat_Question.flac",
        "category_ids": [
            "TFTWNI"
        ],
        "chatgpt_query_id": null,
        "created_at": "29/08/2023 , 12:02 PM",
        "data": {
            "duration": 4.56
        },
        "is_active": true,
        "is_chatgpt_enabled": false,
        "organization_id": "K7QUEV",
        "parent_post_id": "9TX90RLDR4",
        "sort_order": null,
        "text": null,
        "user": {
            "_id": "EA9S6Z",
            "image_url": "https://listapp-images.s3.ap-south-1.amazonaws.com/matar_profile_05.png",
            "name": "shantanu"
        },
        "user_id": "EA9S6Z",
        "whisper_id": null
    }
}
```

Status Code: 🔴**400** (400 denotes **'Bad request'**)

```
/// Response 1
{
    "error": "No file provided"
}
///// Response 2
{
    "message": "no such category"
}
```

***

**Response Parameters Description:**

<table><thead><tr><th width="252">Response Parameter</th><th>Description</th></tr></thead><tbody><tr><td>message</td><td>A response message displayed by servers when a question is successfully posted.</td></tr><tr><td>post_id</td><td>A unique identifier generated in map to posted question.</td></tr><tr><td>post_audio_text</td><td>Contains transcribed version of audio post.</td></tr><tr><td>post_audio_url</td><td>URL of where audio post is stored.</td></tr><tr><td>category_ids</td><td>A unique identifier containing the category in which question is posted.</td></tr><tr><td>chatgpt_query_id</td><td></td></tr><tr><td>created_at</td><td>Post creation date</td></tr><tr><td>duration</td><td>Duration of audio post in minutes and seconds.</td></tr><tr><td>is_active</td><td></td></tr><tr><td>is_chatgpt_enabled</td><td>Is chat gpt enabled to answer to post.</td></tr><tr><td>organization_id</td><td>Organization in which the question is posted.</td></tr><tr><td>parent_post_id</td><td>If question post has replies or child post then the question has a valid parent_post_id. parent_post_id is set to null when question post has no replies.</td></tr><tr><td>sort_order</td><td>When there are multiple posts to display they are sorted by sort order and has a number assigned to it. If there is a single post to display the sort_order will be set to null.</td></tr><tr><td>text</td><td>Contains post text transcribed from audio.</td></tr><tr><td>user_id</td><td>User ID of the account from which audio is posted.</td></tr><tr><td>user image_url</td><td>Image URL containing the user account image.</td></tr><tr><td>user_name</td><td>Name for the user account.</td></tr><tr><td>whisper_id</td><td>Used internally for speech-to-text tasks.</td></tr></tbody></table>


---

# 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://gramhal.gitbook.io/matar/developer-reference/api/posts/post-a-new-question.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.