Optimly Developer Documentation

Optimly MCP

Record Checklist Progress

In short

Record explicit checklist progress reported by the customer or independently evidenced. A human completion statement is not independent verification; include public evidence only when it exists.

record_checklist_progress · Partner Program · Authentication required

Record explicit checklist progress reported by the customer or independently evidenced. A human completion statement is not independent verification; include public evidence only when it exists.

When to use

Use to update a checklist item's state when the customer reports progress or public evidence confirms it.

Access

Approved agent access with agent-work write permission

Parameters

ParameterTypeRequiredDescription
checklist_item_iduuidYesChecklist item being updated.
statestringYesNew checklist state. Allowed values: not_started, in_progress, done, blocked, not_applicable.
notestringYesWhat was reported or observed.
actor{ type, id }YesActor identity; type is human, agent, or system.
blocked_reasonstringNoRequired when state is blocked.
evidence_referencestringNoPublic evidence reference when it exists.
brand_iduuidNoAuthorized brand ID. Required when more than one brand is available.

Example prompt

Mark the FAQ publication checklist item as done — the page is live.

Side effects and safety

Appends a progress record to the work item's checklist.