API reference
The Grepticon /v1 REST surface. Workspaces, files, tokens, audit, and the four agent read tools, with parameters and responses for every endpoint.
Everything under /v1, generated from the same OpenAPI document the server
validates against, so the reference cannot drift from the implementation. The
spec itself is downloadable at /openapi.json.
The surface splits in two. The management plane is driven with a grp_sk_
key from your backend; the read plane is what an agent calls, with either
the key or a scoped grp_at_ token. See
Authentication for which credential belongs where.
Management plane
Workspaces
Create, list, and delete the isolated workspaces your agents read from.
Files
Upload, delete, and list files. Ingestion is asynchronous, so every file carries a status.
Tokens
Mint and revoke the scoped, read-only tokens an agent reads with.
Audit
Export the append-only log of every read made against a workspace.
Read plane
Prefer a typed client?
The SDK reference covers @grepticon/sdk, which wraps this surface and
carries the retry and error handling you would otherwise write yourself.