Sync agent API spec

[warpmachineuser]

Syncs the public Agent API OpenAPI spec from warp-server.

Source ref: da84cf5c5c7f142abf7ede5f582584d1bf70132d
Source commit: da84cf5c5c7f142abf7ede5f582584d1bf70132d

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 19, 2026 9:43pm UTC

[warp-for-oss]

@warpmachineuser

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[warp-for-oss]

Overview

This PR syncs the public Agent API OpenAPI spec, adding Factory Branch endpoints, a block snapshot download endpoint, OpenAPI 3.2 nullability conversions, and several schema updates.

Concerns

• One newly added schema property still uses the OpenAPI 3.0 nullable: true keyword after the document version is changed to OpenAPI 3.2, which can make the property invalid or misrepresented for 3.2 tooling.

Verdict

Found: 0 critical, 1 important, 0 suggestions

Request changes

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[warp-for-oss]

⚠️ [IMPORTANT] This document now declares OpenAPI 3.2, but this new property still uses the OpenAPI 3.0 nullable keyword while the rest of the diff converts nullability to JSON Schema unions; use the same union form here so 3.2 tooling preserves the null value.

Suggested change

	type: string
	nullable: true
	type:
	- string
	- 'null'