> ## Documentation Index
> Fetch the complete documentation index at: https://mako-docs.devinagiffy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Inquiries

> Create a private inquiry thread

<Note>This endpoint requires authentication.</Note>

## Request

<ParamField body="topic" type="string" required>
  Inquiry topic/subject (1-255 characters)
</ParamField>

<ParamField body="flagId" type="string">
  Optional flag UUID to link this inquiry to
</ParamField>

## Response

<ResponseField name="id" type="string">
  Inquiry thread UUID
</ResponseField>

<ResponseField name="topic" type="string">
  Inquiry topic
</ResponseField>

<ResponseField name="status" type="string">
  Thread status: `open` or `closed`
</ResponseField>

<ResponseField name="flagId" type="string">
  Linked flag ID (if any)
</ResponseField>

<ResponseField name="createdAt" type="string">
  Creation timestamp
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.hitler.app/api/flags/inquiries" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "topic": "Question about remote work policy"
    }'
  ```

  ```typescript TypeScript theme={null}
  const inquiry = await api.createInquiry({
    topic: "Question about remote work policy",
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "inquiry-uuid-123",
    "topic": "Question about remote work policy",
    "status": "open",
    "flagId": null,
    "userId": "user-uuid",
    "organizationId": "org-uuid",
    "createdAt": "2024-01-15T10:00:00.000Z"
  }
  ```
</ResponseExample>

***

## Add Message

<api>POST /api/flags/inquiries/{id}/messages</api>

Add a message to an inquiry thread.

### Request

<ParamField body="content" type="string" required>
  Message content (1-2000 characters)
</ParamField>

### Response

```json theme={null}
{
  "id": "message-uuid",
  "content": "Your message here",
  "senderId": "user-uuid",
  "senderType": "user",
  "createdAt": "2024-01-15T10:05:00.000Z"
}
```

***

## Close Inquiry

<api>PATCH /api/flags/inquiries/{id}/close</api>

Close an inquiry thread.

### Response

```json theme={null}
{
  "id": "inquiry-uuid-123",
  "status": "closed",
  "closedAt": "2024-01-15T12:00:00.000Z"
}
```