Templafy Slides API
The Slides API from Templafy — 2 operation(s) for slides.
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-slides-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 Slides 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: Slides
paths:
/libraries/{spaceId}/slides/folders/{folderId}/assets:
get:
tags:
- Slides
summary: Lists all slide decks along with slides in the folder.
description: The result does not include slide decks or slides from subfolders. When {searchQuery} is used the result includes decks/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 slide deck/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/Slide'
- $ref: '#/components/schemas/SlideDeck'
'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:
- Slides
summary: Uploads the slide file.
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 asset
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 slide deck 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}/slides/assets/{assetId}:
get:
tags:
- Slides
summary: Returns the slide deck or 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 slide deck or slide to retrieve
required: true
schema:
type: integer
format: int64
responses:
'200':
description: OK
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/SlideDeckDetails'
- $ref: '#/components/schemas/SlideDetails'
'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:
- Slides
summary: Updates the slide asset.
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 slide deck 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 slide 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:
- Slides
summary: Deletes the slide deck by the identifier.
description: Slides can only be deleted along with the slide deck.
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 slide deck 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:
SlideDeckDetails:
required:
- assetType
- childrenAssetIds
- description
- downloadUrl
type: object
allOf:
- $ref: '#/components/schemas/SlideDetailsBase'
properties:
assetType:
minLength: 1
type: string
description: Type of the asset. It is always SlideDeck for this schema
childrenAssetIds:
type: array
items:
type: integer
format: int64
description: The array of the identifiers of slides included in the slide deck
description:
maxLength: 250
type: string
downloadUrl:
type: string
description: Generated temporary access URL for content downloading with 302 response code
format: uri
additionalProperties: false
SlideDetailsBase:
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 slide. E.g. "folder-a/folder-b/_my-slide" when the location is "Folder A > Folder B > My Slide"
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
SlideDeck:
required:
- assetType
- description
type: object
allOf:
- $ref: '#/components/schemas/SlideBase'
properties:
assetType:
minLength: 1
type: string
description: Type of the asset. It is always SlideDeck for this schema
description:
maxLength: 250
type: string
additionalProperties: false
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
Slide:
required:
- assetType
- slideDeckId
type: object
allOf:
- $ref: '#/components/schemas/SlideBase'
properties:
assetType:
minLength: 1
type: string
description: Type of the asset. It is always Slide for this schema
slideDeckId:
type: integer
description: The identifier of the slide deck to which a slide belongs
format: int64
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
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
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
AssetFileStateWithPreviews:
enum:
- ready
- processing
- processingFailed
- generatingPreviews
- generatingPreviewsFailed
- deleting
type: string
description: The current state of the asset
SlideBase:
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 slide. E.g. "folder-a/folder-b/_my-slide" when the location is "Folder A > Folder B > My Slide"
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
SlideDetails:
required:
- assetType
- slideDeckId
type: object
allOf:
- $ref: '#/components/schemas/SlideDetailsBase'
properties:
assetType:
minLength: 1
type: string
description: Type of the asset. It is always Slide for this schema
slideDeckId:
type: integer
description: The identifier of the slide deck to which a slide belongs
format: int64
additionalProperties: false
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API Key