Notes

Resources and actions to manage notes on organization entities

Endpoints

List notes

GET https://api.upcoach.com/notes

Returns a list of notes

Query Parameters

Name	Type	Description
filter[id]	String	Note ID
filter[user]	String	User ID

200: OK A paginated list of User Note Resource objects

{
  "data": [
    {
      "id": "...",
      "text": "...",
      "user": {
        "avatar": "...",
        "email": "...",
        "id": "...",
        "name": "...",
        "timezone": "..."
      },
      "author": {
        "avatar": "...",
        "email": "...",
        "id": "...",
        "name": "...",
        "timezone": "..."
      },
      "created_at": ...
    },
    ...
    ],
  "links": {
    "first": "...",
    "last": "...",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": ...,
    "from": ...,
    "last_page": ...,
    "path": "...",
    "per_page": ...,
    "to": ...,
    "total": ...
  }
}

Add a note

POST https://api.upcoach.com/notes

Adds a note to a user

Request Body

Name	Type	Description
user*	String	User ID
text*	String	Note text

200: OK Note Resource object

{
  "note": {
    "id": "...",
    "text": "...",
    "user": {
      "avatar": "...",
      "email": "...",
      "id": "...",
      "name": "...",
      "timezone": "..."
    },
    "author": {
      "avatar": "...",
      "email": "...",
      "id": "...",
      "name": "...",
      "timezone": "..."
    },
    "created_at": ...
  }
}

Resource Objects

Note

id	string	Note ID
text	string	Note text
user	User	The user note added to
author	User	The note author
created_at	integer	Note created date and time (Unix timestamp)