Mark evidence collected
POST
/workspaces/{workspace}/evidence/items/{evidenceItem}/collectRecords that someone checked the evidence today and it still holds. The next review moves out by the item’s cadence and any reminder is cleared.
Authentication
Send an API token as a bearer token. This endpoint needs a read and write token, made by an editor, admin or owner. Create one in My account → API tokens; see scopes and roles.
Authorization: Bearer 42|bynh_pat_•••••••HeaderPath parameters
workspacestringRequiredYour workspace slug, e.g. dokan.
evidenceItemintegerRequiredEvidence item id.
Request body
application/jsonnotestring, nullablemax 200Shown in the history and the audit log.
Response
200 OKThe full item.
idintegerEvidence item id.titlestringName.categorystringOne of the categories listed on create.statusenumpending: never collected. due: next review within 14 days. overdue: past next_review_at. One ofcurrent,due,overdue,pending.status_labelstringLocalized (Current, Review due, Overdue, Not collected yet).owner{id, name}|nullOwner.review_every_daysenumCadence. One of30,90,180,365.last_collected_atstring|nullISO 8601.next_review_atstring|nullYYYY-MM-DD.is_publicbooleanListed on the trust center.requirements_countintegerMapped requirements.files_countintegerAttached files.descriptionstring|nullLonger description.methodstring|nullHow it’s collected.public_labelstring|nullLabel shown publicly.reminded_atstring|nullLast reminder.created_atstringISO 8601.requirements[]objectid, code, title, framework {slug, short_name}; on GET show alsomet.files[]objectid, filename, mime, size, uploaded_by, uploaded_at, download_path.timelineobjectdays (90 strings, oldest first: current | overdue | none), current_share (percent of tracked days current, 1 decimal, or null), collections (count in the last 90 days), lapse (most recent overdue run: from, to, days, ongoing, resolved_by, note; or null).history[]objectLast 40 audit events on the item: id, kind (action without the evidence. prefix), who, text (localized), at.
Rate limits
This endpoint counts toward your general limit of 120 requests a minute and its own limit of 60 a minute. Its own limit answers 429 without Retry-After; wait and try again.
Errors
401The token is missing, wrong, revoked or expired.
403The token is read-only (message: “This token is read-only. Create a read and write token to make changes.”). Or: The token’s owner is a viewer (“Viewers can read everything but can’t change it.”), or the workspace’s editing is paused (a billing message, e.g. “Your trial has ended, so editing is paused. …”).
404The token belongs to another workspace, or its owner is no longer a member.
422note over 200 characters.
429evidence-writes limit (60/min).
Every error is JSON with a message. See Errors.