LogoLogo
HomepageSign Up
Version 2.0.0
  • Product Docs
  • API Docs
  • Changelog
Version 2.0.0
  • Overview
  • Screendesk API
    • Overview
    • Authentication
    • Errors
    • Pagination
    • API Reference
      • Recordings
      • Users
  • SCIM / Autoprovisioning
    • Overview
    • Authentication
    • API Reference
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. Screendesk API
  2. API Reference

Recordings

PreviousAPI ReferenceNextUsers

Last updated 3 months ago

Was this helpful?

PATCH Update a recording

patch

Update a recording's title, summary, or description. Only admins can perform this action.

Authorizations
Path parameters
uuidstringRequired

UUID of the recording

Body
Responses
200
Successfully updated recording
application/json
401
Unauthorized
403
Forbidden - User is not an admin or API access is disabled
application/json
404
Recording not found
application/json
422
Validation failed
application/json
patch
curl -X PATCH 'https://app.screendesk.io/api/v2/recordings/696cfd3b-b579-45a7-b58a-88ba0984a42b' \
-H 'Authorization: Bearer YOUR_BEARER_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
  "recording": {
    "title": "Updated Title",
    "summary": "New summary",
    "description": "Updated description"
  }
}'
{
  "uuid": "text",
  "title": "text",
  "summary": "text",
  "description": "text",
  "metadata": {
    "created_at": "2025-05-09T04:42:14.568Z",
    "updated_at": "2025-05-09T04:42:14.568Z",
    "duration": 1,
    "impressions_count": 1,
    "recording_type": "text",
    "recording_source": "text",
    "url": "text",
    "helpdesk_info": {}
  },
  "technical_details": {
    "vendor": "text",
    "ip_address": "text",
    "timezone": "text",
    "network_type": "text",
    "isp": "text"
  },
  "console_logs": "text",
  "customer": {
    "email": "text"
  },
  "user": {
    "email": "text",
    "name": "text"
  }
}
  • GETGET List recordings
  • GETGET Get a specific recording
  • PATCHPATCH Update a recording

GET List recordings

get

Retrieve a paginated list of recordings for the authenticated user's account

Authorizations
Query parameters
pageintegerOptional

Page number for pagination

Responses
200
Successful response
application/json
401
Unauthorized
get

GET Get a specific recording

get

Retrieve details of a specific recording by its UUID

Authorizations
Path parameters
uuidstringRequired

UUID of the recording

Responses
200
Successful response
application/json
401
Unauthorized
404
Recording not found
application/json
get
curl -X GET 'https://app.screendesk.io/api/v2/recordings?page=1' \
-H 'Authorization: Bearer YOUR_BEARER_TOKEN' \
-H 'Content-Type: application/json'
{
  "pagination": {
    "next_page": null,
    "prev_page": null,
    "last_page": 1,
    "page": 1,
    "items": 1,
    "pages": 1,
    "from": 1,
    "to": 1,
    "count": 1
  },
  "records": [
    {
      "uuid": "text",
      "title": "text",
      "summary": "text",
      "description": "text",
      "metadata": {
        "created_at": "2025-05-09T04:42:14.568Z",
        "updated_at": "2025-05-09T04:42:14.568Z",
        "duration": 1,
        "impressions_count": 1,
        "recording_type": "text",
        "recording_source": "text",
        "url": "text",
        "helpdesk_info": {}
      },
      "technical_details": {
        "vendor": "text",
        "ip_address": "text",
        "timezone": "text",
        "network_type": "text",
        "isp": "text"
      },
      "console_logs": "text",
      "customer": {
        "email": "text"
      },
      "user": {
        "email": "text",
        "name": "text"
      }
    }
  ]
}
curl -X GET 'https://app.screendesk.io/api/v2/recordings/696cfd3b-b579-45a7-b58a-88ba0984a42b' \
-H 'Authorization: Bearer YOUR_BEARER_TOKEN' \
-H 'Content-Type: application/json'
{
  "uuid": "text",
  "title": "text",
  "summary": "text",
  "description": "text",
  "metadata": {
    "created_at": "2025-05-09T04:42:14.568Z",
    "updated_at": "2025-05-09T04:42:14.568Z",
    "duration": 1,
    "impressions_count": 1,
    "recording_type": "text",
    "recording_source": "text",
    "url": "text",
    "helpdesk_info": {}
  },
  "technical_details": {
    "vendor": "text",
    "ip_address": "text",
    "timezone": "text",
    "network_type": "text",
    "isp": "text"
  },
  "console_logs": "text",
  "customer": {
    "email": "text"
  },
  "user": {
    "email": "text",
    "name": "text"
  }
}