---
title: "Log a decision"
method: POST
path: "/api/sync/{mapId}/decisions"
tags: ["Sync"]
---

# Log a decision

`POST /api/sync/{mapId}/decisions`

## Request

- Base URL: `https://intentdocs.com`
- URL: `https://intentdocs.com/api/sync/{mapId}/decisions`
- Auth: none declared

Record an architectural or product decision.

## Path parameters

- `mapId` string, required

## Request body

- object
  - `title` string, required
  - `description` string, required
  - `category` 'architecture' | 'product' | 'technical' | 'trade-off'
  - `story_id` string

## Response `201`

Decision logged successfully

- object
  - `id` string
  - `title` string

## Other responses

- `400`: Missing required fields
- `401`: No CLI bearer, or the bearer's holder has no standing on the map's project

---

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