Skip to main content
POST
Reserve Note GUID

인증

Authorization
string
header
필수

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.

본문

application/json

Optional parameters for the note reservation

title
string

If provided, sets the title for the note to be created.

Maximum string length: 100
예시:

"Weekly Team Standup"

응답

Note GUID successfully reserved

guid
string
필수

Reserved note GUID that can be used for note creation

예시:

"x6DjzdpXqkEcU"

expiresAt
string<date-time>
필수

ISO-8601 timestamp when the reservation expires (1 hour from creation)

예시:

"2024-01-15T11:30:00Z"

createdAt
string<date-time>
필수

ISO-8601 timestamp when the reservation was created

예시:

"2024-01-15T10:30:00Z"

title
string | null

Title of the note if provided during reservation

예시:

"Weekly Team Standup"