# Granite Comments API

**Canonical:** https://apis.io/apis/granite-md/granite-md-comments-api/  
**Provider:** Granite — https://apis.io/providers/granite-md/  
**Base URL:** https://api.granite.md  
**Documentation:** https://docs.granite.md/

Granite Comments API is one of 19 APIs that [Granite](https://apis.io/providers/granite-md/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Comments. The published artifact set on APIs.io includes an OpenAPI specification.

Comments on notes, kept outside the Markdown file. A thread's first comment is anchored to a quote of the text with a little context before and after; clients find the quote again after edits. Mentioned people who can read the note are notified.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/vaults/{vault_id}/files/{file_id}/comments` | A note's comments |
| POST | `/v1/vaults/{vault_id}/files/{file_id}/comments` | Comment on a note |
| PATCH | `/v1/vaults/{vault_id}/comments/{comment_id}` | Edit or resolve a comment |
| DELETE | `/v1/vaults/{vault_id}/comments/{comment_id}` | Delete a comment |
| GET | `/v1/me/notifications` | Your notifications |
| POST | `/v1/me/notifications/read` | Mark notifications read |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/granite-md/openapi/granite-md-comments-api-openapi.yml

## Other Granite APIs (12)

- [Granite Auth API](https://apis.io/apis/granite-md/granite-md-auth-api/)
- [Granite Billing API](https://apis.io/apis/granite-md/granite-md-billing-api/)
- [Granite Drive API](https://apis.io/apis/granite-md/granite-md-drive-api/)
- [Granite Folders API](https://apis.io/apis/granite-md/granite-md-folders-api/)
- [Granite knowledge base API](https://apis.io/apis/granite-md/granite-md-knowledge-base-api/)
- [Granite Me API](https://apis.io/apis/granite-md/granite-md-me-api/)
- [Granite Meta API](https://apis.io/apis/granite-md/granite-md-meta-api/)
- [Granite Note Shares API](https://apis.io/apis/granite-md/granite-md-note-shares-api/)
- [Granite Notes API](https://apis.io/apis/granite-md/granite-md-notes-api/)
- [Granite OAuth API](https://apis.io/apis/granite-md/granite-md-oauth-api/)
- [Granite Publish API](https://apis.io/apis/granite-md/granite-md-publish-api/)
- [Granite Search API](https://apis.io/apis/granite-md/granite-md-search-api/)

## Tags

Comments

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/granite-md/granite-md-comments-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/granite-md/.