reflect
This API is for the note-taking app Reflect.
It supports appending data to your notes, returning a list of the links you've bookmarked, and a few other things.
We don't have any official bindings, w...read more
Authentication
OAuth2 Authentication
Reflect OAuth
Type
oauth2
Authorization URL:
https://reflect.app/oauthToken URL:
https://reflect.app/api/oauth/tokenRefresh URL:
Scopes:
read:graph
Read access to protected resources
write:graph
Write access to protected resources
Graphs
get/graphs
Returns all graphs
Response
JSON
[
  {
    "id": "string",
    "name": "string"
  }
]get/graphs/{graphId}/books
Returns all books
Path parameters
- Name
- graphId
- Type
- string
- Required
- Description
- Your graph identifier 
 
Response
JSON
[
  {
    "id": "string",
    "asin": "string",
    "title": "string",
    "authors": [
      "string"
    ],
    "notes": [
      {
        "type": "string",
        "page": 0,
        "location": 0,
        "value": "string"
      }
    ]
  }
]get/graphs/{graphId}/links
Returns all links
Path parameters
- Name
- graphId
- Type
- string
- Required
- Description
- Your graph identifier 
 
Response
JSON
[
  {
    "id": "string",
    "url": "string",
    "title": "string",
    "description": "string",
    "updated_at": "string",
    "highlights": [
      "string"
    ]
  }
]post/graphs/{graphId}/links
Create a new link
Path parameters
- Name
- graphId
- Type
- string
- Required
- Description
- Your graph identifier 
 
Body params
- Name
- id
- Type
- string
- Name
- url
- Type
- string
- Required
- Name
- title
- Type
- string
- Name
- description
- Type
- string
- Name
- updated_at
- Type
- string
- Name
- highlights
- Type
- array[string]
Response
JSON
{
  "id": "string",
  "url": "string",
  "title": "string",
  "description": "string",
  "updated_at": "string",
  "highlights": [
    "string"
  ]
}put/graphs/{graphId}/daily-notes
Appends to daily note
Path parameters
- Name
- graphId
- Type
- string
- Required
- Description
- Your graph identifier 
 
Body params
- Name
- date
- Type
- string
- Description
- Date of the daily note. ISO 8601 format. Defaults to today.
- Name
- text
- Type
- string
- Required
- Description
- Text to append to the daily note
- Name
- transform_type
- Type
- string
- Required
- Description
- Transform type to apply to the text. This will always be list-append for now.
- Name
- list_name
- Type
- string
- Description
- Name of the list to append to. To backlink, use the format [[List Name]].
Response
JSON
{
  "success": true
}post/graphs/{graphId}/notes
Creates a new note
Path parameters
- Name
- graphId
- Type
- string
- Required
- Description
- Your graph identifier 
 
Body params
- Name
- subject
- Type
- string
- Required
- Description
- The subject of the note
- Name
- content_markdown
- Type
- string
- Required
- Description
- The content of the note in markdown
- Name
- pinned
- Type
- boolean
- Description
- Whether the note should be pinned
Response
JSON
{
  "success": true
}Users
get/users/me
Returns current user
Response
JSON
{
  "uid": "string",
  "email": "string",
  "name": "string",
  "graph_ids": [
    "string"
  ]
}