WeCareRemote meeting recordings API

The WeCareRemote recordings API provides access to meeting recordings captured during video sessions. Recordings are stored in secure cloud storage and are accessible to authorized users. The API handles the full recording lifecycle — from storage through to expiry and deletion. Common use cases for this API:

Building an internal dashboard that lists recent meetings for NGO staff
Pulling recordings into a transcription or summarisation pipeline
Archiving recordings to long-term storage before they expire
Auditing meeting activity for compliance reporting

How recordings are stored

When a meeting ends, the recording is automatically uploaded to secure cloud storage. Access, metadata, and retention are managed by the platform. After the configured retention period, recordings are automatically removed.

Recordings are automatically deleted after the retention period expires. Download any important recordings before they are removed — deleted recordings cannot be recovered.

Accessing recordings

All recordings endpoints require authentication. Include your Bearer token in the Authorization header on every request.

Authorization: Bearer your-token

Access to recordings is restricted to users with org_admin permissions. Requests from users without this permission will be rejected with a 403 Forbidden response.

Listing recordings

Retrieve a list of all available recordings for your organization. Endpoint: GET /recordings Authentication: Bearer token required — see Authentication.

Response

{
  "recordings": [
    {
      "id": "rec_001",
      "meeting_id": "wcr-meeting-xyz",
      "created_at": "2025-01-15T10:30:00Z",
      "duration_seconds": 3600,
      "url": "https://storage.wcr.is/recordings/rec_001.mp4"
    }
  ]
}

array

An array of recording objects.

Show recording properties

string

The unique identifier for this recording.

string

The Jitsi meeting ID that produced this recording.

string

ISO 8601 timestamp of when the recording was created.

integer

The length of the recording in seconds.

string

The direct URL to download or stream the recording file.

Example

curl https://your-records-backend/recordings \
  -H "Authorization: Bearer your-token"

Downloading a recording

Use the url field from the listing response to download a recording. The download URL also requires authentication.

curl -L "https://storage.wcr.is/recordings/rec_001.mp4" \
  -H "Authorization: Bearer your-token" \
  -o meeting-recording.mp4

import httpx

client = httpx.Client(headers={"Authorization": "Bearer your-token"})

# First, get the list of recordings
recordings = client.get("https://your-records-backend/recordings").json()

# Download the first recording
url = recordings["recordings"][0]["url"]
with client.stream("GET", url) as response:
    with open("recording.mp4", "wb") as f:
        for chunk in response.iter_bytes():
            f.write(chunk)

Error responses

Status code	Cause
`401 Unauthorized`	The Bearer token is missing or invalid.
`403 Forbidden`	The token is valid but the user does not have `org_admin` permissions.
`404 Not Found`	The requested recording does not exist or has been deleted.
`500 Internal Server Error`	An unexpected error occurred in the recordings backend.

Overview

Endpoints

WeCareRemote meeting recordings API

How recordings are stored

Accessing recordings

Listing recordings

Response

Example

Downloading a recording

Error responses

​How recordings are stored

​Accessing recordings

​Listing recordings

​Response

​Example

​Downloading a recording

​Error responses

How recordings are stored

Accessing recordings

Listing recordings

Response

Example

Downloading a recording

Error responses