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.
openapi: 3.2.0
info:
title: Gnosem Keys API
version: 0.1.0
summary: Cross-vendor AI memory over MCP.
description: Gnosem is a hosted Model Context Protocol server providing one persistent semantic memory store per user, accessible from every MCP-capable AI client. This spec covers the REST surface. The MCP JSON-RPC endpoint (POST /mcp) exposes 6 tools — memory_write, memory_search, memory_list, memory_forget, memory_supersede, memory_write_bulk — documented in /llms.txt and /.well-known/mcp/server-card.json.
contact:
name: CUETV LLC
url: https://cuetv.us
license:
name: MIT
identifier: MIT
servers:
- url: https://gnosem.dev
description: Production
security:
- bearerAuth: []
tags:
- name: Keys
paths:
/keys/rotate:
post:
summary: Revoke the current API key and issue a new one
description: All prior keys under the account are revoked. Update every MCP client with the new key before signing out.
responses:
'200':
description: New key issued.
content:
application/json:
schema:
$ref: '#/components/schemas/RotateResponse'
'401':
description: Missing or invalid Bearer token.
tags:
- Keys
operationId: postKeysRotate
x-operation-id-source: derived
components:
schemas:
RotateResponse:
type: object
required:
- api_key
properties:
api_key:
type: string
pattern: ^gn_[a-f0-9]{32}$
note:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: gn_[a-f0-9]{32}
description: 'Every user gets an API key on signup formatted as `gn_` + 32 hex characters. Pass as `Authorization: Bearer <key>` on every authenticated request.'