---
title: "Start Thread"
method: POST
path: "/v1/native/threads"
tags: ["native"]
---

# Start Thread

`POST /v1/native/threads`

## Request

- Base URL: `https://api.mundane.market` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mundane.market/v1/native/threads`
- Auth: none declared

Start a conversation about something new.

An existing thread with nothing said in it yet is handed back instead of
making another, so pressing "New task" twice -- or leaving one empty and
coming back -- does not leave a column of blank threads behind.

## Headers

- `authorization` string

## Cookies

- `mundane_principal_session` string, nullable

## Response `201`

Successful Response

- ThreadSummary
  - `conversation_id` string, required
  - `state` string, required
  - `title` string, required
  - `tasks` ThreadTaskOut[], required
    - `task_id` string, required
    - `title` string, required
    - `status` string, required
  - `last_activity_at` string, required
  - `unread` boolean, required
  - `has_messages` boolean
  - `brief` BriefOut
    - `lat` number, nullable, required
    - `lng` number, nullable, required
    - `radius_km` number, nullable, required
    - `location_skipped` boolean, required
    - `budget_minor` integer, nullable, required
    - `budget_skipped` boolean, required
    - `needs_files` boolean, nullable, required
  - `closes_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mundane/apis/mundane-api.md) · [All operations](https://skmtc.dev/mundane/apis/mundane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mundane/apis/mundane-api/revisions/f1cba6e69834?raw)