Grist templates API
The templates API from Grist — 2 operation(s) for templates.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/grist-templates-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: 'An API for manipulating Grist sites, workspaces, and documents.
# Authentication
<SecurityDefinitions />
'
version: 1.0.1
title: Grist attachments Templates API
servers:
- url: https://{gristhost}/api
variables:
subdomain:
description: The team name, or `docs` for personal areas
default: docs
security:
- ApiKey: []
tags:
- name: templates
paths:
/templates:
get:
operationId: listTemplates
tags:
- templates
summary: List available templates
description: 'Get all available templates. Templates are organized by workspace within
a template organization configured on the server.
**Note:** Requires a template organization to be configured on the server.
'
responses:
200:
description: List of workspaces containing templates
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/WorkspaceWithDocsAndDomain'
/templates/{templateId}:
get:
operationId: getTemplate
tags:
- templates
summary: Get template details
description: 'Get information about a specific template.
**Note:** Requires a template organization to be configured on the server.
'
parameters:
- name: templateId
in: path
required: true
schema:
type: string
description: ID of the template
responses:
200:
description: Template information
content:
application/json:
schema:
$ref: '#/components/schemas/DocWithWorkspace'
components:
schemas:
Workspace:
type: object
required:
- id
- name
- access
properties:
id:
type: integer
format: int64
example: 97
name:
type: string
example: Secret Plans
access:
type: string
$ref: '#/components/schemas/Access'
WorkspaceWithDocsAndDomain:
allOf:
- $ref: '#/components/schemas/WorkspaceWithDocs'
- type: object
properties:
orgDomain:
type: string
example: gristlabs
WorkspaceWithDocs:
allOf:
- $ref: '#/components/schemas/Workspace'
- type: object
required:
- docs
properties:
docs:
type: array
items:
$ref: '#/components/schemas/Doc'
User:
type: object
required:
- id
- name
- picture
properties:
id:
type: integer
format: int64
example: 101
name:
type: string
example: Helga Hufflepuff
picture:
type:
- string
- 'null'
example: null
Org:
type: object
required:
- id
- name
- domain
- owner
- createdAt
- updatedAt
- access
properties:
id:
type: integer
format: int64
example: 42
name:
type: string
example: Grist Labs
domain:
type:
- string
- 'null'
example: gristlabs
owner:
type:
- object
- 'null'
$ref: '#/components/schemas/User'
access:
type: string
$ref: '#/components/schemas/Access'
createdAt:
type: string
example: '2019-09-13T15:42:35.000Z'
updatedAt:
type: string
example: '2019-09-13T15:42:35.000Z'
DocWithWorkspace:
allOf:
- $ref: '#/components/schemas/Doc'
- type: object
required:
- workspace
properties:
workspace:
$ref: '#/components/schemas/WorkspaceWithOrg'
Access:
type: string
enum:
- owners
- editors
- viewers
Doc:
type: object
required:
- id
- name
- isPinned
- urlId
- access
properties:
id:
type: string
example: 145
name:
type: string
example: Project Lollipop
access:
type: string
$ref: '#/components/schemas/Access'
isPinned:
type: boolean
example: true
urlId:
type:
- string
- 'null'
example: null
WorkspaceWithOrg:
allOf:
- $ref: '#/components/schemas/Workspace'
- type: object
required:
- org
properties:
org:
$ref: '#/components/schemas/Org'
securitySchemes:
ApiKey:
type: http
scheme: bearer
bearerFormat: 'Authorization: Bearer XXXXXXXXXXX'
description: Access to the Grist API is controlled by an Authorization header, which should contain the word 'Bearer', followed by a space, followed by your API key.