Skip to content

docs: document missing version parameter in Durable Functions HTTP API - #128741

Open
Teos (teofanis) wants to merge 2 commits into
MicrosoftDocs:mainfrom
teofanis:patch-1
Open

docs: document missing version parameter in Durable Functions HTTP API#128741
Teos (teofanis) wants to merge 2 commits into
MicrosoftDocs:mainfrom
teofanis:patch-1

Conversation

@teofanis

Copy link
Copy Markdown

The official Microsoft docs for the Durable Functions management HTTP API don't document the version query parameter on the Start Orchestration endpoint. This parameter controls which version is assigned to the new instance (available as context.df.version in the orchestration body).

The official Microsoft docs for the Durable Functions management HTTP API don't document the `version` query parameter on the Start Orchestration
endpoint. This parameter controls which version is assigned to the new
instance (available as `context.df.version` in the orchestration body).
@prmerger-automator

Copy link
Copy Markdown
Contributor

Teos (@teofanis) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@prmerger-automator

Copy link
Copy Markdown
Contributor

Teos (@teofanis) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 4603883:

✅ Validation status: passed

File Status Preview URL Details
articles/durable-task/durable-functions/durable-functions-http-api.md ✅Succeeded

For more details, please refer to the build report.

Comment thread articles/durable-task/durable-functions/durable-functions-http-api.md Outdated
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 3871df3:

✅ Validation status: passed

File Status Preview URL Details
articles/durable-task/durable-functions/durable-functions-http-api.md ✅Succeeded

For more details, please refer to the build report.

@v-regandowner

Copy link
Copy Markdown
Contributor

Chris Gillum (@cgillum)

Can you review the proposed changes?

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator Bot added the aq-pr-triaged tracking label for the PR review team label Aug 31, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Documents the previously undocumented version query parameter on the Durable Functions “Start Orchestration” management HTTP API so users can explicitly set the instance version (surfaced as context.df.version).

Changes:

  • Adds &version={version} to the Start Orchestration request URL examples for both runtime endpoints.
  • Adds a request-parameter table entry documenting purpose, default behavior, and constraints of version.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants