K

reflect

Latest version
Domain
OpenAPI file
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

Versions

Authentication

OAuth2 Authentication

Reflect OAuth

Type
oauth2
Authorization URL:
https://reflect.app/oauth
Token URL:
https://reflect.app/api/oauth/token
Refresh 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"
  ]
}