Semestra

Sticky note plugin

GET
/sticky/notes

Use to read the notes of one board ("what is in my note for this course"). Returns each note's instance_id and Markdown text. To find a note without knowing its board use layouts.card.list.

Authorization

cookiesemestra_session<token>

Set by the sign-in endpoints for the web app. Requests other than GET, HEAD and OPTIONS also need the X-Semestra-CSRF header set to the semestra_csrf cookie.

Query Parameters

scope_type*Scope Type

Kind of board the note sits on; 'today' is the Program's Today page

Value in"program""term""course""today"
scope_id*Scope Id

Id of that Program, term or course

Response Body

Successful Response

application/json
  1. response
items*array<>
Example Request
curl -X GET 'https://example.com/sticky/notes?scope_type=program&scope_id=string'
Example Response
{  "items": [    {      "instance_id": "string",      "content": "string",      "color": "string"    }  ]}
PUT
/sticky/notes/{instance_id}

Use when the user asks to jot something down in a note ("note the midterm scope in this course's sticky"): by default (mode append) the lines go after the note's text, so the same call made twice adds them twice. To rewrite or delete text, read the note first and send the whole new text with mode replace. At most 10 000 characters.

Authorization

cookiesemestra_session<token>

Set by the sign-in endpoints for the web app. Requests other than GET, HEAD and OPTIONS also need the X-Semestra-CSRF header set to the semestra_csrf cookie.

Path Parameters

instance_id*Instance Id

Sticky note card instance id

Request Body

application/json
  1. body
content*Content

Markdown text: the lines to add, or the whole new note with mode replace

Lengthlength <= 10000
mode?Mode

append adds the text on a new line after the note; replace overwrites it

Default"append"
Value in"append""replace"

Response Body

Successful Response

application/json
  1. response
instance_id*Instance Id
content*Content
color?string|null
Example Request
curl -X PUT 'https://example.com/sticky/notes/string' \  -H 'Content-Type: application/json' \  -d '{  "content": "string"}'
Example Response
{  "instance_id": "string",  "content": "string",  "color": "string"}