Skip to main content
GET
/
public
/
workspace
/
{workspaceId}
/
recordings
/
{recordingId}
Get recording
curl --request GET \
  --url https://api.userplane.com/api/v1/public/workspace/{workspaceId}/recordings/{recordingId} \
  --header 'Authorization: Bearer <token>'
{
  "message": "<string>",
  "data": {
    "workspaceId": "<string>",
    "recording": {
      "recordingId": "<string>",
      "recordingDurationMs": 123,
      "recordingStartedAt": "2023-11-07T05:31:56Z",
      "meta": {
        "link": {
          "linkId": "<string>",
          "title": "<string>",
          "providerType": "intercom",
          "providerId": "<string>",
          "providerRef": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "providerData": "<unknown>"
        },
        "creator": {
          "workspaceMemberId": "<string>",
          "name": "<string>"
        },
        "project": {
          "projectId": "<string>",
          "title": "<string>"
        },
        "domain": {
          "domainId": "<string>",
          "url": "<string>"
        },
        "workspaceId": "<string>",
        "status": "pending",
        "systemMeta": {},
        "customMeta": {},
        "notes": "<string>",
        "expiresAt": "2023-11-07T05:31:56Z",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      }
    }
  }
}
Returns full details for a specific recording, including metadata about the link, creator, project, domain, and capture status.

Errors

Error codeStatusDescription
RECORDING_NOT_FOUND404Recording does not exist
RECORDING_GONE410Recording has already been deleted
Also returns common authentication errors.

Recording Resources

Download video, thumbnail, and log files

Delete Recording

Soft-delete this recording

List Recordings

View all recordings in the workspace

Get Link

Details for the link that captured this recording

Authorizations

Authorization
string
header
required

API key with uspl_ prefix. Create keys at dash.userplane.io/_/account?tab=developers

Path Parameters

workspaceId
string
required
Minimum string length: 1
recordingId
string
required
Minimum string length: 1

Response

OK

message
string
required
data
object
required