---
title: "Notes"
description: "Documentation and guidance for building tools and integrations with the Disguise platform."
url: https://developer.disguise.one/api/session/notes/
---

# NOTES API

-   [GET note](#get-note)
-   [POST note](#post-note)
-   [GET notes](#get-notes)

## GET note

### Summary

Returns a single note

### URL

GET    /api/session/note

### Query Params

uid    uint64    

name    string    

### Response

```json
{
  "status": {
    "code": 0,
    "message": "",
    "details": [
      {
        "type_url": "",
        "value": ""
      }
    ]
  },
  "result": {
    "note": {
      "uid": "",
      "name": ""
    },
    "text": ""
  }
}
```

## POST note

### Summary

Create/Update a Note

### URL

POST    /api/session/note

### Request

```json
{
  "note": {
    "uid": "",
    "name": ""
  },
  "text": ""
}
```

### Response

```json
{
  "status": {
    "code": 0,
    "message": "",
    "details": [
      {
        "type_url": "",
        "value": ""
      }
    ]
  },
  "result": {
    "note": {
      "uid": "",
      "name": ""
    },
    "text": ""
  }
}
```

## GET notes

### Summary

Returns all named notes

### URL

GET    /api/session/notes

### Query Params

start    uint64    

count    uint64    

### Response

```json
{
  "status": {
    "code": 0,
    "message": "",
    "details": [
      {
        "type_url": "",
        "value": ""
      }
    ]
  },
  "result": [
    {
      "note": {
        "uid": "",
        "name": ""
      },
      "text": ""
    }
  ]
}
```