---
title: "Log an activity event"
method: POST
path: "/api/sync/{mapId}/activity"
tags: ["Sync"]
---

# Log an activity event

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

## Request

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

Record a custom event from CLI or external tools.

## Path parameters

- `mapId` string, required

## Request body

- object
  - `event_type` string, required
  - `summary` string, required
  - `metadata` object
  - `source` string

## Response `201`

Activity logged successfully

- object
  - `id` 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)