Notes

This API is not available for self-service at the moment, and you will need to contact us if you are interested in using it.

List notes

This endpoint allows to list notes and its messages on a particular project and environment.

Records are returned sorted by id primary key, in descending order (from most recent to least recent).

Pagination can be achieved by filtering on createdAt date.

get

/v1/project/{projectName}/environment/{environmentName}/notes

Authorizations

Path parameters

environmentNamestring · min: 1required

The case sensitive environment name

projectNamestring · min: 1required

The case sensitive project name

Query parameters

limitinteger · min: 1 · max: 100 · default: 10

This specifies a limit on the number of objects to return, ranging between 1 and 100. Limit is set to 10 by default

userEmailstring · email

The user email

userIdinteger · min: 1

The user id

teamNamestring · min: 1

The team name

collectionNamestring · min: 1

The collection name (same as in the schema).

recordIdstring · min: 1

The record id

createdAt.eqstring · date-time

Value to filter by

createdAt.ltstring · date-time

Maximum value to filter by (exclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

createdAt.ltestring · date-time

Minimum value to filter by (inclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

createdAt.gtstring · date-time

Minimum value to filter by (exclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

createdAt.gtestring · date-time

Maximum value to filter by (inclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

updatedAt.eqstring · date-time

Value to filter by

updatedAt.ltstring · date-time

Maximum value to filter by (exclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

updatedAt.ltestring · date-time

Minimum value to filter by (inclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

updatedAt.gtstring · date-time

Minimum value to filter by (exclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

updatedAt.gtestring · date-time

Maximum value to filter by (inclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

archivedAt.eqstring · date-time

Value to filter by

archivedAt.ltstring · date-time

Maximum value to filter by (exclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

archivedAt.ltestring · date-time

Minimum value to filter by (inclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

archivedAt.gtstring · date-time

Minimum value to filter by (exclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

archivedAt.gtestring · date-time

Maximum value to filter by (inclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://public-api.forestadmin.com/v1/project/{projectName}/environment/{environmentName}/notes' \
  --header 'Authorization: Bearer JWT'

200

429

4XX

5XX

200

{
  "hasMore": false,
  "parameters": {
    "projectName": "Forest",
    "environmentName": "Production",
    "limit": 10
  },
  "data": [
    {
      "object": "note",
      "id": 42,
      "title": "THE TITLE",
      "recordId": "10",
      "createdAt": "2024-02-20T10:35:54.685Z",
      "updatedAt": "2024-03-10T10:36:54.685Z",
      "archivedAt": "2024-05-22T14:01:23.015Z",
      "user": {
        "object": "user",
        "id": 1,
        "username": "alice1",
        "email": "[e-mail]"
      },
      "environment": {
        "object": "environment",
        "name": "aName"
      },
      "team": {
        "object": "team",
        "name": "aName"
      },
      "collection": {
        "object": "collection",
        "name": "client"
      },
      "messages": [
        {
          "object": "note-message",
          "content": "<p>Needs to be verified</p>",
          "createdAt": "2024-02-20T10:35:54.685Z",
          "user": {
            "object": "user",
            "email": "[e-mail]",
            "id": 1,
            "username": "alice"
          }
        },
        {
          "object": "note-message",
          "content": "<p>Ok</p>",
          "createdAt": "2024-02-20T11:15:32.461Z",
          "user": {
            "object": "user",
            "email": "[e-mail]",
            "id": 1,
            "username": "bob"
          }
        }
      ]
    }
  ]
}

List of notes