Granite

Granite Me API

The signed-in user.

GitHub OpenAPI

Operations 28

GET /v1/me The signed-in user #
PATCH /v1/me Change your profile #
DELETE /v1/me Delete the account #
GET /v1/me/export Download everything in the account #
PUT /v1/me/avatar Upload a profile photo #
DELETE /v1/me/avatar Remove the profile photo #
GET /v1/avatars/{avatar_id} A profile photo #
GET /v1/me/notification-settings Which notifications reach you by email and on your phones #
PUT /v1/me/notification-settings Save which notifications reach you #
GET /v1/me/preferences Your appearance preferences #
PUT /v1/me/preferences Save your appearance preferences #
POST /v1/me/password Change your password #
GET /v1/me/devices Your signed-in devices #
POST /v1/me/devices/sign-out-others Sign out every other device #
PATCH /v1/me/devices/{device_id} Rename a device #
DELETE /v1/me/devices/{device_id} Sign a device out #
GET /v1/me/tokens Your personal API tokens #
POST /v1/me/tokens Create a personal API token #
DELETE /v1/me/tokens/{token_id} Revoke a personal API token #
GET /v1/plans Every plan and its limits #
GET /v1/me/entitlements Plan, limits, and usage #
GET /v1/me/flags Feature flags #
DELETE /v1/me/2fa Turn off two-factor authentication #
POST /v1/me/2fa/totp Start authenticator app setup #
POST /v1/me/2fa/totp/confirm Finish authenticator app setup #
POST /v1/me/2fa/recovery-codes Replace recovery codes #
PUT /v1/me/push-token Receive push notifications on this device #
DELETE /v1/me/push-token Stop push notifications on this device #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/granite-md/openapi/granite-md-me-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/granite-md:granite-md-me-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

granite-md-me-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Granite Me API
  version: 1.0.0
  summary: REST API for Granite clients, bots, and integrations.
  description: 'Conventions (apply to every operation; see PLAN.md 3.2 and 3.6):


    - **Base URL** `https://api.granite.md`. All public operations live under `/v1`.

    After Phase 6 ships, `/v1` changes are additive only.

    - **Errors** use RFC 9457 problem details (`application/problem+json`, schema `Problem`).

    The `type` URI is `https://granite.md/problems/`; `code` refines it for programmatic handling.

    Every response carries `X-Request-ID`, also echoed as `request_id` in problems.

    - **Pagination** is cursor based. List operations accept `cursor` and `limit` and return

    `{ "items": [...], "next_cursor": "..." }`. `next_cursor` is absent on the last page.

    Cursors are opaque; clients must not parse or build them.

    - **Idempotency**: non-idempotent `POST` operations accept an `Idempotency-Key` header

    (1-255 printable ASCII). Repeating a request with the same key and body within 24 hours

    returns the original response; the same key with a different body returns `409` with

    code `idempotency_key_reused`.

    - **IDs** are UUIDv7 strings. **Timestamps** are RFC 3339 in UTC.

    - **Authentication**: `Authorization: Bearer ` with a session access token,

    a personal API token (`gr_pat_...`), or an OAuth access token. Scopes are listed per operation.

    - **Rate limits**: each personal API token may make 600 requests a minute. Over the limit

    the API answers `429` with code `token_rate_limited` and a `Retry-After` header (seconds).'
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
- url: https://api.granite.md
  description: Production
- url: http://localhost:8080
  description: Local development
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://artifacts.apis.io/granite-md/openapi/granite-md-me-api-openapi.yml