---
title: "Reserve Note GUID"
method: POST
path: "/v1/external/notes/guids"
tags: ["Note"]
---

# Reserve Note GUID

`POST /v1/external/notes/guids`

Reserve a note GUID for later use in note creation. This allows you to:
- Get a GUID before actually creating the note
- Use the reserved GUID when creating a note with POST /v1/notes (internal API)
- Reservation expires after 1 hour if not used

**Use case**: When you need to know the note GUID before the note content is ready,
such as setting up webhooks or references in advance.

## Request body

- NoteReservationRequest
  - `title` string — If provided, sets the title for the note to be created.

## Response `201`

Note GUID successfully reserved

- NoteReservationResponse
  - `guid` string, required — Reserved note GUID that can be used for note creation
  - `title` string, nullable — Title of the note if provided during reservation
  - `expiresAt` string, date-time, required — ISO-8601 timestamp when the reservation expires (1 hour from creation)
  - `createdAt` string, date-time, required — ISO-8601 timestamp when the reservation was created

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `500` — Internal server error

---

[API](https://skmtc.net/tiro/apis/tiro-api.md) · [All operations](https://skmtc.net/tiro/apis/tiro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiro/tiro-api/revisions/ae18d7961aa4/schema)