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

# Reserve Note GUID

`POST /v1/external/notes/guids`

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/notes/guids`
- Auth: HTTP bearer

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.dev/tiro/apis/tiro-api-2.md) · [All operations](https://skmtc.dev/tiro/apis/tiro-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tiro/apis/tiro-api-2/revisions/dc1a260c6771?raw)