List notes
Returns notes and their messages for a specific project and environment, sorted by id in descending order (most recent first).
Use the createdAt filters for pagination.
GET /v1/project/{projectName}/environment/{environmentName}/notes
Authentication
All requests require a Bearer token in the Authorization header. Generate one from your account settings.
Authorization: Bearer YOUR_APPLICATION_TOKEN
The token must be generated by a user with an Admin role on the project. Tokens generated by non-admin users will not have access to this endpoint.
If your project uses SSO, the application token must be generated while logged in with SSO.
Path parameters
| Parameter | Type | Description |
|---|
projectName | string | The case sensitive project name |
environmentName | string | The case sensitive environment name |
Query parameters
| Parameter | Type | Description |
|---|
limit | integer | Maximum number of notes to return. Between 1 and 100. Default is 10. |
userEmail | string | Filter by the email of the user who created the note. |
userId | integer | Filter by the id of the user who created the note. |
teamName | string | Filter by team name. |
collectionName | string | Filter by collection name (as defined in your schema). |
recordId | string | Filter by the id of the record the note is attached to. |
createdAt.eq / .lt / .lte / .gt / .gte | string (ISO 8601) | Filter by creation date. Use .lt/.lte/.gt/.gte for range queries and pagination. |
updatedAt.eq / .lt / .lte / .gt / .gte | string (ISO 8601) | Filter by last update date. |
archivedAt.eq / .lt / .lte / .gt / .gte | string (ISO 8601) | Filter by archive date. |
Response
{
"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": "alice@somewhere.com"
},
"environment": {
"object": "environment",
"name": "Production"
},
"team": {
"object": "team",
"name": "Operations"
},
"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": "alice@somewhere.com",
"id": 1,
"username": "alice"
}
},
{
"object": "note-message",
"content": "<p>Ok</p>",
"createdAt": "2024-02-20T11:15:32.461Z",
"user": {
"object": "user",
"email": "bob@somewhere.com",
"id": 1,
"username": "bob"
}
}
]
}
]
}
Response fields
| Field | Type | Description |
|---|
hasMore | boolean | Whether more notes are available after this set. |
data[].id | integer | The note id. |
data[].title | string | The note title. |
data[].recordId | string | The id of the record the note is attached to. |
data[].createdAt | string (ISO 8601) | When the note was created. |
data[].updatedAt | string (ISO 8601) | When the note (or one of its messages) was last updated. |
data[].archivedAt | string (ISO 8601) | When the note was archived, if applicable. |
data[].user | object | The user who created the note (id, username, email). |
data[].environment | object | The environment the note is attached to. |
data[].team | object | The team the note is attached to. |
data[].collection | object | The collection the note is attached to. Notes created on collections deleted before 2024-06-11 may be missing this field. |
data[].messages | array | Messages within the note thread. Each has content (HTML), createdAt, and user. |
Errors
| Status | Meaning |
|---|
429 | Too many requests. The response includes a Retry-After header indicating the number of seconds to wait. |
4XX | Client error. Response body contains code and message. |
5XX | Server error. Response body contains code and message. |
