Templafy Presentations API
The Presentations API from Templafy — 3 operation(s) for presentations.
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/templafy-presentations-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:
contact:
url: https://support.templafy.com/hc/en-us/requests/new
name: Submit support ticket
description: Please refer to our [documentation](https://support.templafy.com/hc/en-us/articles/4411351240081-Public-API-Hive-) for guidelines and examples.
title: Templafy Public DataSourceFields Presentations API
version: v3
termsOfService: https://www.templafy.com/templafy-saas-agreement/
servers:
- variables:
tenantId:
default: ''
description: Your Templafy subdomain, i.e., https://{TenantId}.api.templafy.com
url: https://{tenantId}.api.templafy.com/v3
tags:
- name: Presentations
paths:
/libraries/{spaceId}/presentations/assets/{assetId}/generate:
post:
tags:
- Presentations
summary: Generates a presentation from a template and returns information about the file, which includes the download url.
description: Creates a file from the template in a pptx format. The file will have bindings replaced using various data sources. The url will only be valid for a short amount of time. When a PDF is included in the response, its download URL may briefly be unavailable on receipt; clients should retry the download with a short backoff before treating an initial failure as final.
parameters:
- name: spaceId
in: path
description: The identifier of the space
required: true
schema:
type: integer
format: int64
- name: assetId
in: path
description: The identifier of the presentation template
required: true
schema:
type: integer
format: int64
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateFileRequest'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GeneratedFile'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationProblemDetails'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundProblemDetails'
security:
- bearerAuth:
- library.generate
/libraries/{spaceId}/presentations/folders/{folderId}/assets:
get:
tags:
- Presentations
summary: Lists all presentation templates along with their slides in the folder.
description: The result does not include presentation templates or slides from subfolders. When {searchQuery} is used the result includes presentation templates/slides from subfolders. The search mode enables pagination with 1000 page size maximum.
parameters:
- name: spaceId
in: path
description: The identifier of the space
required: true
schema:
type: integer
format: int64
- name: folderId
in: path
description: The identifier of the folder
required: true
schema:
type: integer
format: int64
- name: searchQuery
in: query
description: Filter on presentation template/slide name, description and tags
schema:
type: string
- name: pageNumber
in: query
description: Page number from the result set. Page number is set to 1 by default if {searchQuery} is passed. A value passed only for the page number and not for the page size is ignored.
schema:
maximum: 65535
minimum: 1
type: integer
format: int32
- name: pageSize
in: query
description: Size of the returned page. If {searchQuery} is not set, not passing page size or having it 0 returns all the assets from the folder. Acceptable values are 0 to 1000, inclusive.
schema:
maximum: 1000
minimum: 0
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
oneOf:
- $ref: '#/components/schemas/Presentation'
- $ref: '#/components/schemas/PresentationSlide'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationProblemDetails'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundProblemDetails'
security:
- bearerAuth:
- library.read
- library.readwrite
post:
tags:
- Presentations
summary: Uploads the presentation template.
description: Only one file can be attached to the request body. The supported file format is .PPTX
parameters:
- name: spaceId
in: path
description: The identifier of the space
required: true
schema:
type: integer
format: int64
- name: folderId
in: path
description: The identifier of the folder
required: true
schema:
type: integer
format: int64
requestBody:
content:
multipart/form-data:
schema:
required:
- File
type: object
properties:
File:
type: string
description: A file to be uploaded. The maximum file size is 50 mb
format: binary
Name:
type: string
description: The name is inferred from the file name by default. It can be overriden by providing a different value with this field
Description:
type: string
description: Description is used to specify the intended usage of the asset
Tags:
type: array
items:
type: string
description: Tags should describe the content of the asset making it easier for a user to locate it
ExternalData:
type: string
description: External data which can be attached for future reference
encoding:
File:
style: form
Name:
style: form
Description:
style: form
Tags:
style: form
ExternalData:
style: form
responses:
'201':
description: The identifier of the created template
content:
application/json:
schema:
type: integer
format: int64
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationProblemDetails'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundProblemDetails'
'409':
description: The upload cannot proceed due to a conflict with the current state of the target location. This may occur if a presentation with the same name already exists in this location, or if the folder intended for the upload is in the process of being deleted.
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictProblemDetails'
security:
- bearerAuth:
- library.readwrite
/libraries/{spaceId}/presentations/assets/{assetId}:
get:
tags:
- Presentations
summary: Returns the presentation template or presentation slide by the identifier.
parameters:
- name: spaceId
in: path
description: The identifier of the space
required: true
schema:
type: integer
format: int64
- name: assetId
in: path
description: The identifier of the presentation template or slide to retrieve
required: true
schema:
type: integer
format: int64
responses:
'200':
description: OK
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/PresentationDetails'
- $ref: '#/components/schemas/PresentationSlideDetails'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundProblemDetails'
security:
- bearerAuth:
- library.read
- library.readwrite
patch:
tags:
- Presentations
summary: Updates the presentation template.
description: 'Only one file can be attached to the request body. The supported file format is .PPTX. Slides are limited to the following properties that can be updated: Name, Tags, ExternalData'
parameters:
- name: spaceId
in: path
description: The identifier of the space
required: true
schema:
type: integer
format: int64
- name: assetId
in: path
description: The identifier of the presentation template or slide
required: true
schema:
type: integer
format: int64
requestBody:
content:
multipart/form-data:
schema:
type: object
properties:
FolderId:
type: integer
description: The identifier of the destination folder
format: int64
Name:
type: string
description: A new display name of the asset
Description:
type: string
description: Description is used to specify the intended usage of the asset
Tags:
type: array
items:
type: string
description: Tags should describe the content of the asset making it easier for a user to locate it
ExternalData:
type: string
description: External data which can be attached for future reference
File:
type: string
description: A file to be uploaded. The maximum file size is 50 mb
format: binary
encoding:
FolderId:
style: form
Name:
style: form
Description:
style: form
Tags:
style: form
ExternalData:
style: form
File:
style: form
responses:
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationProblemDetails'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundProblemDetails'
'409':
description: The update operation cannot be completed due to a conflict with the current state of the target location. This may occur if a presentation with the same name already exists in the destination, or if the destination folder is in the process of being deleted.
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictProblemDetails'
security:
- bearerAuth:
- library.readwrite
delete:
tags:
- Presentations
summary: Deletes the presentation template by the identifier.
description: Slides can only be deleted along with the presentation.
parameters:
- name: spaceId
in: path
description: The identifier of the space
required: true
schema:
type: integer
format: int64
- name: assetId
in: path
description: The identifier of the presentation to delete
required: true
schema:
type: integer
format: int64
responses:
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationProblemDetails'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundProblemDetails'
security:
- bearerAuth:
- library.readwrite
components:
schemas:
PresentationSlide:
required:
- assetType
- presentationId
type: object
allOf:
- $ref: '#/components/schemas/PresentationBase'
properties:
assetType:
minLength: 1
type: string
description: Type of the asset. It is always Slide for this schema
presentationId:
type: integer
description: The identifier of the presentation to which a slide belongs
format: int64
additionalProperties: false
PresentationBase:
required:
- assetState
- assetType
- checksum
- dimensions
- fileExtension
- fileSize
- folderId
- id
- modifiedAt
- name
- navigationPath
- tags
type: object
properties:
assetType:
minLength: 1
type: string
assetState:
$ref: '#/components/schemas/AssetFileStateWithPreviews'
dimensions:
$ref: '#/components/schemas/Dimensions'
id:
type: integer
description: Unique asset identifier
format: int64
folderId:
type: integer
description: Unique folder identifier
format: int64
name:
maxLength: 100
minLength: 1
type: string
description: Display name
tags:
type: array
items:
type: string
fileSize:
type: integer
description: File size in bytes
format: int64
checksum:
minLength: 1
type: string
description: MD5 checksum of the bytes
fileExtension:
minLength: 1
type: string
description: Suffix to the name of the file
navigationPath:
maxLength: 700
minLength: 1
type: string
description: Hierarchical path in lowercase based on the location of a presentation. E.g. "folder-a/folder-b/_my-presentation" when the location is "Folder A > Folder B > My Presentation"
externalData:
maxLength: 100
type:
- string
- 'null'
description: External data which can be attached for future reference
modifiedAt:
minLength: 1
type: string
description: Date and time in ISO 8601 format of when the asset was last modified
smallPreviewLink:
type:
- string
- 'null'
description: Link to the asset with the maximum width 400px
largePreviewLink:
type:
- string
- 'null'
description: Link to the asset with the maximum width 1500px
additionalProperties: false
PresentationDetailsBase:
required:
- assetState
- assetType
- checksum
- dimensions
- fileExtension
- fileSize
- folderId
- id
- modifiedAt
- name
- navigationPath
- tags
type: object
properties:
assetType:
minLength: 1
type: string
assetState:
$ref: '#/components/schemas/AssetFileStateWithPreviews'
dimensions:
$ref: '#/components/schemas/Dimensions'
id:
type: integer
description: Unique asset identifier
format: int64
folderId:
type: integer
description: Unique folder identifier
format: int64
name:
maxLength: 100
minLength: 1
type: string
description: Display name
tags:
type: array
items:
type: string
fileSize:
type: integer
description: File size in bytes
format: int64
checksum:
minLength: 1
type: string
description: MD5 checksum of the bytes
fileExtension:
minLength: 1
type: string
description: Suffix to the name of the file
navigationPath:
maxLength: 700
minLength: 1
type: string
description: Hierarchical path in lowercase based on the location of a presentation. E.g. "folder-a/folder-b/_my-presentation" when the location is "Folder A > Folder B > My Presentation"
externalData:
maxLength: 100
type:
- string
- 'null'
description: External data which can be attached for future reference
modifiedAt:
minLength: 1
type: string
description: Date and time in ISO 8601 format of when the asset was last modified
smallPreviewLink:
type:
- string
- 'null'
description: Link to the asset with the maximum width 400px
largePreviewLink:
type:
- string
- 'null'
description: Link to the asset with the maximum width 1500px
additionalProperties: false
GeneratedFile:
required:
- checksum
- downloadUrl
- fileExtension
- fileSize
- mimeType
type: object
properties:
downloadUrl:
minLength: 1
type: string
description: Temporary access URL for generated file.
format: uri
fileSize:
type: integer
description: File size in bytes.
format: int64
checksum:
minLength: 1
type: string
description: MD5 checksum of the bytes.
mimeType:
minLength: 1
type: string
description: Mime type of the generated file.
fileExtension:
minLength: 1
type: string
description: Suffix to the name of the file.
pdfDownloadUrl:
type:
- string
- 'null'
description: 'Temporary access URL for generated PDF file. Only available if the file was converted to PDF. The URL is short-lived and may not be immediately fetchable on receipt; clients should retry the download with a short backoff before treating an initial failure as final. '
additionalProperties: false
description: The generated file response model.
Dimensions:
required:
- height
- width
type: object
properties:
height:
type: integer
description: Height of the asset in pixels
format: int32
width:
type: integer
description: Width of the asset in pixels
format: int32
aspectRatio:
type:
- string
- 'null'
additionalProperties: false
description: Asset dimensions
Presentation:
required:
- assetType
- description
type: object
allOf:
- $ref: '#/components/schemas/PresentationBase'
properties:
assetType:
minLength: 1
type: string
description: Type of the asset. It is always Presentation for this schema
description:
maxLength: 250
type: string
additionalProperties: false
PresentationDetails:
required:
- assetType
- childrenAssetIds
- description
- downloadUrl
type: object
allOf:
- $ref: '#/components/schemas/PresentationDetailsBase'
properties:
assetType:
minLength: 1
type: string
description: Type of the asset. It is always Presentation for this schema
childrenAssetIds:
type: array
items:
type: integer
format: int64
description: The array of the identifiers of slides included in the presentation
description:
maxLength: 250
type: string
downloadUrl:
type: string
description: Generated temporary access URL for content downloading with 302 response code
format: uri
additionalProperties: false
NotFoundProblemDetails:
type: object
properties:
type:
type:
- string
- 'null'
title:
type:
- string
- 'null'
status:
type:
- integer
- 'null'
format: int32
detail:
type:
- string
- 'null'
instance:
type:
- string
- 'null'
traceId:
type:
- string
- 'null'
additionalProperties: false
example:
title: NotFound
detail: The server can not find the requested resource.
status: 404
traceId: d61f7ce-cccb-4e5b-8727-3b68a61a0559
AssetFileStateWithPreviews:
enum:
- ready
- processing
- processingFailed
- generatingPreviews
- generatingPreviewsFailed
- deleting
type: string
description: The current state of the asset
ConflictProblemDetails:
type: object
properties:
type:
type:
- string
- 'null'
title:
type:
- string
- 'null'
status:
type:
- integer
- 'null'
format: int32
detail:
type:
- string
- 'null'
instance:
type:
- string
- 'null'
traceId:
type:
- string
- 'null'
additionalProperties: false
example:
title: Conflict
detail: The request could not be completed due to a conflict with the current state of the resource.
status: 409
traceId: d61f7ce-cccb-4e5b-8727-3b68a61a0559
GenerateFileRequest:
required:
- email
type: object
properties:
email:
minLength: 1
type: string
description: Email to be used for identification.
format: email
data:
description: Data to be used during the file generation.
includePdf:
type: boolean
description: Specifies whether a PDF export of the file should be included in the response.
additionalProperties: false
description: The request model to generate a file.
example:
email: templafy@templafy.com
data:
Language: en-us
includePdf: true
PresentationSlideDetails:
required:
- assetType
- presentationId
type: object
allOf:
- $ref: '#/components/schemas/PresentationDetailsBase'
properties:
assetType:
minLength: 1
type: string
description: Type of the asset. It is always Slide for this schema
presentationId:
type: integer
description: The identifier of the presentation to which a slide belongs
format: int64
additionalProperties: false
ValidationProblemDetails:
type: object
properties:
errors:
type:
- object
- 'null'
additionalProperties:
type: array
items:
type: string
type:
type:
- string
- 'null'
title:
type:
- string
- 'null'
status:
type:
- integer
- 'null'
format: int32
detail:
type:
- string
- 'null'
instance:
type:
- string
- 'null'
traceId:
type:
- string
- 'null'
additionalProperties: false
example:
errors:
- name: The name field is required
- data: The input was invalid
title: One or more validation errors occurred.
status: 400
traceId: d61f7ce-cccb-4e5b-8727-3b68a61a0559
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API Key