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/mepmail-dev:mepmail-dev-templates-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. 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:
title: Mepmail Dev Templates API
version: 1.0.0
description: 'Operations tagged Templates across 2 of this provider''s published API definitions: docs.json, mepmail-dev-docs-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
security:
- apiKey: []
tags:
- name: Templates
description: Reusable email content.
paths:
/templates:
post:
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateTemplateRequest'
example:
name: Order shipped
alias: order-shipped
subject: Your order has shipped
html: <p>Your order is on its way.</p>
text: Your order is on its way.
responses:
'200':
description: 'Template created. Templates have no draft/publish cycle: every save is live, so status is always published.'
content:
application/json:
schema:
$ref: '#/components/schemas/TemplateIdResponse'
example:
object: template
id: ae2014de-c168-4c61-8267-70d2662a1ce1
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'409':
description: Alias already in use
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation error, including from/reply_to/variables (not supported yet)
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: createTemplate
summary: Create a template
tags:
- Templates
description: Creates a reusable email template; every save is live.
get:
parameters:
- schema:
type: integer
minimum: 1
maximum: 100
description: Page size, 1-100 (default 20)
required: false
description: Page size, 1-100 (default 20)
name: limit
in: query
- schema:
type: string
format: uuid
description: 'Cursor: id of the last item of the previous page. Must be an id this list returned; there is no sentinel value.'
required: false
description: 'Cursor: id of the last item of the previous page. Must be an id this list returned; there is no sentinel value.'
name: after
in: query
- schema:
type: string
format: uuid
description: 'Cursor: id of the first item of the next page (page backwards); same rule as after.'
required: false
description: 'Cursor: id of the first item of the next page (page backwards); same rule as after.'
name: before
in: query
responses:
'200':
description: Templates
content:
application/json:
schema:
$ref: '#/components/schemas/ListTemplatesResponse'
example:
object: list
data:
- id: 4ef9a417-02e9-4d39-ad75-9611e0fcc33c
name: Order updates
alias: alias
status: published
published_at: '2026-10-19T12:00:00.000Z'
created_at: '2026-10-19T12:00:00.000Z'
updated_at: '2026-10-19T12:00:00.000Z'
has_more: false
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: listTemplates
summary: List templates
tags:
- Templates
description: Lists the team's templates.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
/templates/{id}:
get:
parameters:
- schema:
type: string
minLength: 1
description: Template id or alias
required: true
description: Template id or alias
name: id
in: path
responses:
'200':
description: 'Template by id or alias. Templates have no draft/publish cycle: every save is live, so status is always published. from, reply_to and variables are not supported yet and read as null, null and [].'
content:
application/json:
schema:
$ref: '#/components/schemas/GetTemplateResponse'
example:
id: ae2014de-c168-4c61-8267-70d2662a1ce1
name: Order updates
alias: alias
status: published
published_at: '2026-10-19T12:00:00.000Z'
created_at: '2026-10-19T12:00:00.000Z'
updated_at: '2026-10-19T12:00:00.000Z'
object: template
current_version_id: ae2014de-c168-4c61-8267-70d2662a1ce1
from: null
subject: Your order has shipped
reply_to: null
html: <p>Your order is on its way.</p>
text: Your order is on its way.
variables: []
has_unpublished_versions: false
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: getTemplate
summary: Retrieve a template
tags:
- Templates
description: Returns one template by id or alias.
patch:
parameters:
- schema:
type: string
minLength: 1
description: Template id or alias
required: true
description: Template id or alias
name: id
in: path
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateTemplateRequest'
example:
subject: Your order is on its way
responses:
'200':
description: Template updated (live immediately)
content:
application/json:
schema:
$ref: '#/components/schemas/TemplateIdResponse'
example:
object: template
id: ae2014de-c168-4c61-8267-70d2662a1ce1
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'409':
description: Alias already in use
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation error, including from/reply_to/variables (not supported yet)
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: updateTemplate
summary: Update a template
tags:
- Templates
description: Changes a template; the change is live immediately.
delete:
parameters:
- schema:
type: string
minLength: 1
description: Template id or alias
required: true
description: Template id or alias
name: id
in: path
responses:
'200':
description: Template deleted. Broadcasts keep their own copy of the content.
content:
application/json:
schema:
$ref: '#/components/schemas/RemoveTemplateResponse'
example:
object: template
id: ae2014de-c168-4c61-8267-70d2662a1ce1
deleted: true
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: deleteTemplate
summary: Delete a template
tags:
- Templates
description: Deletes a template; broadcasts keep their own copy.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
/templates/{id}/publish:
post:
parameters:
- schema:
type: string
minLength: 1
description: Template id or alias
required: true
description: Template id or alias
name: id
in: path
responses:
'200':
description: 'No-op kept for SDK compatibility. Templates have no draft/publish cycle: every save is live, so status is always published.'
content:
application/json:
schema:
$ref: '#/components/schemas/TemplateIdResponse'
example:
object: template
id: ae2014de-c168-4c61-8267-70d2662a1ce1
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: publishTemplate
summary: Publish a template
tags:
- Templates
description: 'Kept for SDK compatibility: templates are always published.'
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
/templates/{id}/duplicate:
post:
parameters:
- schema:
type: string
minLength: 1
description: Template id or alias
required: true
description: Template id or alias
name: id
in: path
responses:
'200':
description: Copy named "<name> (copy)" with no alias; returns the new template id
content:
application/json:
schema:
$ref: '#/components/schemas/TemplateIdResponse'
example:
object: template
id: ae2014de-c168-4c61-8267-70d2662a1ce1
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: duplicateTemplate
summary: Duplicate a template
tags:
- Templates
description: Copies a template under a new id.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
components:
schemas:
GetTemplateResponse:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
alias:
type:
- string
- 'null'
status:
type: string
enum:
- published
published_at:
type: string
created_at:
type: string
updated_at:
type: string
object:
type: string
enum:
- template
current_version_id:
type: string
format: uuid
from:
type: 'null'
subject:
type:
- string
- 'null'
reply_to:
type: 'null'
html:
type: string
text:
type:
- string
- 'null'
variables:
type: array
items: {}
description: Always empty
has_unpublished_versions:
type: boolean
enum:
- false
required:
- id
- name
- alias
- status
- published_at
- created_at
- updated_at
- object
- current_version_id
- from
- subject
- reply_to
- html
- text
- variables
- has_unpublished_versions
ErrorResponse:
type: object
properties:
statusCode:
type: number
name:
type: string
message:
type: string
required:
- statusCode
- name
- message
CreateTemplateRequest:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 200
subject:
type:
- string
- 'null'
maxLength: 998
description: '"" or null clears the subject'
html:
type: string
minLength: 1
maxLength: 500000
description: Stored as sent; the dashboard sanitizes at render
text:
type:
- string
- 'null'
maxLength: 500000
description: '"" or null clears the text part'
alias:
type:
- string
- 'null'
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$
description: Case-sensitive handle, unique per team; GET /templates/{alias} resolves it
from:
type:
- string
- 'null'
description: 'Not supported yet: any value is a 422'
reply_to:
anyOf:
- type: string
- type: array
items:
type: string
- type: 'null'
description: 'Not supported yet: any value is a 422'
variables:
type: array
items: {}
description: 'Not supported yet: a non-empty list is a 422'
required:
- name
- html
UpdateTemplateRequest:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 200
subject:
type:
- string
- 'null'
maxLength: 998
description: '"" or null clears the subject'
html:
type: string
minLength: 1
maxLength: 500000
text:
type:
- string
- 'null'
maxLength: 500000
alias:
type:
- string
- 'null'
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$
description: null clears the alias
from:
type:
- string
- 'null'
description: 'Not supported yet: any value is a 422'
reply_to:
anyOf:
- type: string
- type: array
items:
type: string
- type: 'null'
description: 'Not supported yet: any value is a 422'
variables:
type: array
items: {}
description: 'Not supported yet: a non-empty list is a 422'
TemplateIdResponse:
type: object
properties:
object:
type: string
enum:
- template
id:
type: string
format: uuid
required:
- object
- id
ListTemplatesResponse:
type: object
properties:
object:
type: string
enum:
- list
data:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
alias:
type:
- string
- 'null'
status:
type: string
enum:
- published
published_at:
type: string
created_at:
type: string
updated_at:
type: string
required:
- id
- name
- alias
- status
- published_at
- created_at
- updated_at
has_more:
type: boolean
required:
- object
- data
- has_more
RemoveTemplateResponse:
type: object
properties:
object:
type: string
enum:
- template
id:
type: string
format: uuid
deleted:
type: boolean
enum:
- true
required:
- object
- id
- deleted
securitySchemes:
apiKey:
type: http
scheme: bearer
description: 'An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.'
x-refined-from:
- docs.json
- mepmail-dev-docs-openapi.json
x-provenance:
method: harvested
publisher: MepMail
source: https://docs.mepmail.dev/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)