Optimly Developer Documentation

Optimly MCP

Save Draft

In short

Save one copy-pasteable, evidence-backed draft to the same Optimly Actions workflow. The draft may contain portable website copy, profile copy, structured data, or an outreach pitch, but must not contain invented facts or credentials.

save_draft · Partner Program · Authentication required

Save one copy-pasteable, evidence-backed draft to the same Optimly Actions workflow. The draft may contain portable website copy, profile copy, structured data, or an outreach pitch, but must not contain invented facts or credentials.

When to use

Use when the deliverable is ready-to-paste content rather than a recommendation to act on.

Access

Approved agent access with agent-work write permission

Parameters

ParameterTypeRequiredDescription
titlestringYesShort draft title.
bodystringYesDraft summary body.
implementation_packagestringYesThe paste-ready draft content.
domainstringYesWork domain. Allowed values: onsite, third_party_presence, media_outreach, earned_media_strategy.
action_typestringYesConcrete action type. Allowed values: owned_page, metadata_schema, internal_linking, site_file, third_party_profile, media_pitch, earned_media_plan.
target{ url, kind, label }YesTarget of the draft.
target_descriptionstringYesHuman-readable target description.
evidenceobject[]YesSupporting evidence items.
rationalestringYesWhy this draft matters.
expected_outcomestringYesWhat success looks like.
prioritynumberYesQueue priority.
readinessstringYesExecution readiness. Allowed values: ready, needs_customer_input, blocked_by_prerequisite, needs_technical_validation, needs_internal_clarification.
confidencestringYesEvidence confidence. Allowed values: high, medium, low.
estimated_effortstringYesEstimated effort. Allowed values: small, medium, large.
canonical_keystringYesStable deduplication key for this draft.
producer{ id, type, sourceCreatedAt, sourceReference }YesProducing agent identity and source reference.
actor{ type, id }YesActor identity; type is human, agent, or system.
parent_work_item_iduuidNoParent work item when this extends existing work.
brand_iduuidNoAuthorized brand ID. Required when more than one brand is available.

Example prompt

Save this paste-ready FAQ copy as a draft in our Optimly Actions workflow.

Side effects and safety

Creates a draft work item in the brand's shared Optimly Actions workflow.