Skip to content
calternal docs

Read a stable Note identity through a live grant. Guessing and revocation return the same 404 as a missing Note. Private references are redacted for read-only recipients before any Markdown reaches the browser (#1034, §54).

GET
/api/v1/files/shared-notes/{id}
curl --request GET \
  --url https://example.com/api/v1/files/shared-notes/example \
  --header 'Authorization: Bearer <token>'

Route: /api/v1/files/shared-notes/{id}. Inputs: id. Safe reads can use bounded retries.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json

Notes → Shared projection (#1034, DESIGN §54). Content uses the existing Notes reader; authority always uses the immutable Files grant identity.

object
access
required
string
body
string | null
edited
string | null
etag
string | null
id
required
string
owner_id
required
string
path
required
string
properties
required
title
required
string
Examplegenerated
{
  "access": "example",
  "body": "example",
  "edited": "example",
  "etag": "example",
  "id": "example",
  "owner_id": "example",
  "path": "example",
  "properties": "example",
  "title": "example"
}

404

Section titled “404”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}