---
title: "Create Structure Log"
method: POST
path: "/v1/structures/{structure_id}/logs"
tags: ["structure-logs"]
---

# Create Structure Log

`POST /v1/structures/{structure_id}/logs`

## Request

- Base URL: `https://api.shapemaker.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shapemaker.io/v1/structures/{structure_id}/logs`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

## Path parameters

- `structure_id` string, required

## Request body

- CreateStructureLogInput
  - `content` string, required
  - `type` 'note' | 'analysis' | 'site-created' | 'draft-created' | 'draft-published'
  - `parentLogUuid` string, uuid4, nullable

## Response `201`

Successful Response

- StructureLogView
  - `uuid` string, uuid4, required
  - `type` 'note' | 'analysis' | 'site-created' | 'draft-created' | 'draft-published', required
  - `content` string, required
  - `createdBy` string, required
  - `createdAtUtc` string, date-time, required
  - `updatedAtUtc` string, date-time, required
  - `analysisRunId` string, uuid4, nullable
  - `parentLogUuid` string, uuid4, nullable
  - `versionUuid` string, uuid4, nullable
  - `scope` 'inherited' | 'future', nullable

## Other responses

- `422`: Validation Error

---

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