ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

ShortNotes.Read

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

Allows the app to read all the short notes a sign-in user has access to.

Permission data: May 21, 2026 at 4:34 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission User consent allowed

Read short notes of the signed-in user

Allows the app to read all the short notes a sign-in user has access to.

User sees: Allows the app to read your short notes.
Permission ID: 50f66e47-eb56-45b7-aaa2-75057d9afe08

Properties

Microsoft Graph beta endpoint-derived-docs

Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Property Type Description
body itemBody The content of the note. Supports text or html content types.
bodyPreview StringRead-onlyNullable Auto-generated preview of the note body content (first ~255 characters, plain text). Read-only.
categories String collection The categories associated with the note. Inherited from outlookItem.
changeKey StringNullable Version identifier used for optimistic concurrency control via the If-Match header. Read-only. Inherited from outlookItem.
createdDateTime DateTimeOffsetNullable The date and time when the note was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Supports $filter (eq, ge, le, gt, lt). Read-only. Inherited from outlookItem.
hasAttachments BooleanRead-onlyNullable Indicates whether the note has file attachments. Supports $filter (eq). Read-only.
id String The unique identifier for the note. Read-only. Inherited from outlookItem.
isDeleted BooleanRead-onlyNullable Indicates whether the note is soft-deleted. Read-only.
lastModifiedDateTime DateTimeOffsetNullable The date and time when the note was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Supports $filter (eq, ge, le, gt, lt) and $orderby. Read-only. Inherited from outlookItem.
subject StringNullable The title of the note. Supports $filter (eq, ne, startsWith) and $orderby.
attachments attachment collection The file attachments for the note. Only inline image attachments (image/png, image/jpeg, image/gif, or image/bmp) are supported, with a maximum size of 3 MB per attachment. Use $expand to retrieve attachments.
extensions extension collection The collection of open extensions defined for the note.
multiValueExtendedProperties multiValueLegacyExtendedProperty collection The collection of multi-value extended properties defined for the note.
singleValueExtendedProperties singleValueLegacyExtendedProperty collection The collection of single-value extended properties defined for the note.

JSON Representation

Microsoft Graph beta endpoint-derived-docs

JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

JSON representation 
{
  "@odata.type": "#microsoft.graph.note",
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "changeKey": "String",
  "categories": [
    "String"
  ],
  "subject": "String",
  "body": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "bodyPreview": "String",
  "isDeleted": "Boolean",
  "hasAttachments": "Boolean"
}

Relationships

Microsoft Graph beta endpoint-derived-docs

Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Relationship Type Description
attachments attachment collection The file attachments for the note. Only inline image attachments (image/png, image/jpeg, image/gif, or image/bmp) are supported, with a maximum size of 3 MB per attachment. Use $expand to retrieve attachments.
extensions extension collection The collection of open extensions defined for the note.
multiValueExtendedProperties multiValueLegacyExtendedProperty collection The collection of multi-value extended properties defined for the note.
singleValueExtendedProperties singleValueLegacyExtendedProperty collection The collection of single-value extended properties defined for the note.
categories string collection The categories associated with the item.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

No API methods available for this version.

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /me/notes
GET /me/notes/{note-id}
GET /me/notes/{note-id}/attachments
GET /me/notes/delta
GET /users/{id | userPrincipalName}/notes
GET /users/{id | userPrincipalName}/notes/{note-id}
GET /users/{id | userPrincipalName}/notes/{note-id}/attachments
GET /users/{id | userPrincipalName}/notes/delta
No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs
No Microsoft Learn PowerShell mapping available

Microsoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Code Examples

C# / .NET SDK 
using Azure.Identity;
using Microsoft.Graph;

var scopes = new[] { "ShortNotes.Read" };
var credential = new InteractiveBrowserCredential(
    new InteractiveBrowserCredentialOptions
    {
        ClientId = "YOUR_CLIENT_ID",
        TenantId = "YOUR_TENANT_ID",
        RedirectUri = new Uri("http://localhost")
    });

var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
    .WithUrl("https://graph.microsoft.com/v1.0/me/notes")
    .GetAsync();
JavaScript
Get note
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

let aAMkAGI2THVSAAA= = await client.api('/me/notes/AAMkAGI2THVSAAA=')
	.version('beta')
	.get();
PowerShell 
Connect-MgGraph -Scopes "ShortNotes.Read"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/me/notes"
Python 
from azure.identity import InteractiveBrowserCredential
import requests

credential = InteractiveBrowserCredential(
    client_id="YOUR_CLIENT_ID",
    tenant_id="YOUR_TENANT_ID"
)

token = credential.get_token("ShortNotes.Read")
response = requests.get(
    "https://graph.microsoft.com/v1.0/me/notes",
    headers={"Authorization": f"Bearer {token.token}"}
)

print(response.json())

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Delegated permissions and search for ShortNotes.Read

4

Grant Admin Consent

Users can consent to this permission during sign-in.