Skip to content

Add Hosted Agents /v2/agents OpenAPI (full harness surface) - #1233

Open
SSharma-10 wants to merge 9 commits into
mainfrom
ohs-v2-agents-openapi
Open

SSharma-10 wants to merge 9 commits into
mainfrom
ohs-v2-agents-openapi

Conversation

@SSharma-10

Copy link
Copy Markdown
Contributor

Summary

  • Add the full Hosted Agents (OHS) public OpenAPI surface under /v2/agents/*, mirrored from harness-api harness.swagger.json (38 operations).
  • Covers Agent Configs (list/create/get/delete/clone + list sessions by config), Sessions (CRUD-ish lifecycle, HITL, input, pause/resume, sandbox exec, policy validate, sandbox sizes, workspace upload/download/transfers), Checkpoints (+ rollback), Fork, and Templates (+ builds).
  • Replaces the incomplete draft PRs #1207 and #1213 (those can be closed). Branched from current main.

Test plan

  • Path/method parity vs harness.swagger.json: 38/38
  • make bundle succeeds
  • npm run lint -- specification/DigitalOcean-public.v2.yaml → 0 errors
  • Spec CI green on this PR
  • Follow-up: godo / doctl / pydo clientgen after merge

Made with Cursor

SSharma-10 and others added 7 commits September 24, 2026 12:06
Document all 38 OHS public endpoints (configs, sessions, checkpoints, fork, workspace transfers, and templates) for client generation and docs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Expose a single requestBody media type so Autorest can generate agents_create_session, while documenting YAML/JSON dual forms via description and x-content-schemas to match harness swagger.

Co-authored-by: Cursor <cursoragent@cursor.com>
Comment thread specification/DigitalOcean-public.v2.yaml
Comment thread specification/resources/agents/models/definitions.yml
Comment thread specification/resources/agents/agents_commit_session_workspace_transfer.yml Outdated
Comment thread specification/resources/agents/agents_create_config.yml Outdated
Comment thread specification/resources/agents/models/definitions.yml
anup-deka
anup-deka previously approved these changes Sep 25, 2026

@anup-deka anup-deka 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.

LGTM, left few comments

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants