Skip to main content
GET
/
plaud
/
files
/
webhook-candidates
Poll new-recording candidates
curl --request GET \
  --url https://{deployment}/api/v1/plaud/files/webhook-candidates \
  --header 'X-API-KEY: <api-key>'
{
  "files": [
    {
      "id": "ceb63f88",
      "filename": "Team standup",
      "version_ms": 1719460000000,
      "edit_time": 1719460000000,
      "edit_from": "web"
    }
  ],
  "fetched_at": "2026-06-27T09:00:00Z"
}

Authorizations

​
X-API-KEY
string
header
required

Your deployment's API key (MMK_API_KEY). Your Plaud account credentials are stored server-side — you do not send them.

Query Parameters

​
limit
integer
default:5

Number of candidates (clamped to 1–20).

Required range: 1 <= x <= 20

Response

Ready-to-ship candidates

​
files
object[]
​
fetched_at
string<date-time>