# Granite Drive API

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

Granite Drive 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 Drives. The published artifact set on APIs.io includes an OpenAPI specification.

Google Drive references (PLAN.md Phase 11). A person connects their Google account (only the files they pick are visible to Granite), picks files, and each becomes a reference in a vault and a Markdown link in a note. Content is fetched from Google when read, converted in memory, and never stored. Everyone who can read the vault can read a referenced file through the connection of the person who added it.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/drive/connection` | Your Google Drive connection |
| DELETE | `/v1/drive/connection` | Disconnect Google Drive |
| POST | `/v1/drive/connect` | Start connecting Google Drive |
| POST | `/v1/drive/connect/finish` | Finish connecting Google Drive |
| GET | `/v1/drive/picker` | A session for Google's file picker |
| GET | `/v1/vaults/{vault_id}/drive-refs` | The vault's Drive references |
| POST | `/v1/vaults/{vault_id}/drive-refs` | Reference a Drive file you picked |
| DELETE | `/v1/vaults/{vault_id}/drive-refs/{ref_id}` | Remove a reference |
| GET | `/v1/vaults/{vault_id}/drive-refs/{ref_id}/content` | Read a referenced file's text |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/granite-md/openapi/granite-md-drive-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 Comments API](https://apis.io/apis/granite-md/granite-md-comments-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

Drives

---

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