Reserve Note GUID
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.
인증
API key in format {id}.{secret}.
The notes an endpoint returns depend on the key type. A user key reaches the notes that user can see in the app, including notes in their own private folders. A system key (workspace or organization, no user identity) reaches only notes that sit in a folder shared with all workspace members. Notes in a private folder, in a folder shared with only some members, or in no folder at all fall outside a system key's read scope, and scopes do not widen that boundary.
List and search endpoints drop out-of-scope notes from the response without an
error. Single-note reads and their sub-resources return 404, the same response
as a deleted note. See What notes a system key reads.
본문
Optional parameters for the note reservation
If provided, sets the title for the note to be created.
100"Weekly Team Standup"
응답
Note GUID successfully reserved
Reserved note GUID that can be used for note creation
"x6DjzdpXqkEcU"
ISO-8601 timestamp when the reservation expires (1 hour from creation)
"2024-01-15T11:30:00Z"
ISO-8601 timestamp when the reservation was created
"2024-01-15T10:30:00Z"
Title of the note if provided during reservation
"Weekly Team Standup"