OpenAPI Specification
openapi: 3.1.0
info:
title: Camtasia Asset Library Assets Recordings API
description: API for accessing and managing media assets, templates, and libraries within TechSmith Camtasia. Provides programmatic access to browse, search, download, and manage video assets, audio tracks, images, templates, themes, and other media resources used in Camtasia projects.
version: '1.0'
contact:
name: TechSmith Support
url: https://support.techsmith.com
email: support@techsmith.com
termsOfService: https://www.techsmith.com/terms.html
servers:
- url: https://api.techsmith.com/camtasia/v1
description: TechSmith Camtasia API Production
security:
- bearerAuth: []
tags:
- name: Recordings
description: Manage screen recordings
paths:
/recordings:
get:
operationId: listRecordings
summary: Camtasia List recordings
description: Retrieve a list of screen recordings available for use in projects.
tags:
- Recordings
parameters:
- $ref: '#/components/parameters/pageOffset'
- $ref: '#/components/parameters/pageLimit'
responses:
'200':
description: List of recordings
content:
application/json:
schema:
$ref: '#/components/schemas/RecordingListResponse'
'401':
description: Unauthorized
post:
operationId: uploadRecording
summary: Camtasia Upload a recording
description: Upload a screen recording file for use in Camtasia projects.
tags:
- Recordings
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- file
- name
properties:
file:
type: string
format: binary
description: The recording file (.trec or video format)
name:
type: string
description: Display name for the recording
description:
type: string
description: Description of the recording
responses:
'201':
description: Recording uploaded
content:
application/json:
schema:
$ref: '#/components/schemas/Recording'
'400':
description: Invalid file
'401':
description: Unauthorized
/recordings/{recordingId}:
get:
operationId: getRecording
summary: Camtasia Get a recording
description: Retrieve details of a specific screen recording.
tags:
- Recordings
parameters:
- $ref: '#/components/parameters/recordingId'
responses:
'200':
description: Recording details
content:
application/json:
schema:
$ref: '#/components/schemas/Recording'
'401':
description: Unauthorized
'404':
description: Recording not found
delete:
operationId: deleteRecording
summary: Camtasia Delete a recording
description: Delete a screen recording.
tags:
- Recordings
parameters:
- $ref: '#/components/parameters/recordingId'
responses:
'204':
description: Recording deleted
'401':
description: Unauthorized
'404':
description: Recording not found
components:
parameters:
pageOffset:
name: offset
in: query
description: Pagination offset
schema:
type: integer
default: 0
minimum: 0
pageLimit:
name: limit
in: query
description: Number of results per page
schema:
type: integer
default: 25
minimum: 1
maximum: 100
recordingId:
name: recordingId
in: path
required: true
description: Unique identifier for the recording
schema:
type: string
schemas:
Recording:
type: object
properties:
id:
type: string
description: Unique identifier for the recording
name:
type: string
description: Recording name
description:
type: string
description: Recording description
format:
type: string
description: Recording file format (e.g., trec, mp4)
duration:
type: number
description: Recording duration in seconds
resolution:
type: object
properties:
width:
type: integer
description: Recording width in pixels
height:
type: integer
description: Recording height in pixels
fileSize:
type: integer
description: Recording file size in bytes
hasWebcam:
type: boolean
description: Whether the recording includes webcam footage
hasAudio:
type: boolean
description: Whether the recording includes audio
hasCursorData:
type: boolean
description: Whether the recording includes cursor tracking data
createdAt:
type: string
format: date-time
description: When the recording was created
RecordingListResponse:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/Recording'
total:
type: integer
description: Total number of recordings
offset:
type: integer
description: Current pagination offset
limit:
type: integer
description: Number of results per page
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: OAuth 2.0 bearer token from TechSmith account authentication
externalDocs:
description: Camtasia Support Documentation
url: https://support.techsmith.com/hc/en-us/categories/camtasia-api