dots.v2.agents.sessions.bySession_id().hitl.byRequest_id().post()

Generated on 13 Nov 2026 from DoTs version v1.24.0

Usage

client.v2.agents.sessions.bySession_id(session_id).hitl.byRequest_id(request_id).post(body: Resolve_hitl_request, requestConfiguration?: RequestConfiguration<object>): Promise<void>

Description

harness-api forwards the decision into the owning microVM via the inbound runtime.v1.OHR.ResolveHITL RPC (dialed through the guest-fronting proxy), which unblocks the gated agent action. The resolution is also echoed to all attached clients as a HITLResolved event on StreamSession. Returns 204 No Content on success.

Parameters

Path Parameters

session_id string required

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

The session UUID.

request_id string required

Example: hitl_example

The HITL request identifier.

Headers

X-Device-UUID string optional

Example: device-uuid-example

Optional hardware device id forwarded by doctl. Recorded on the resulting HITL decision.

Request Body

outcome string required

HITLOutcome is the user's decision on a HITL request. DEFER backs off this attempt without treating it as a rejection.

One of: HITL_OUTCOME_UNSPECIFIED, HITL_OUTCOME_APPROVE, HITL_OUTCOME_REJECT, HITL_OUTCOME_DEFER

Default: HITL_OUTCOME_UNSPECIFIED

reason string optional

Example: example

Optional free-text reason. Captured in the audit trail; not interpreted.

source string optional

How a HITL resolution was triggered. Defaults to RESOLUTION_SOURCE_OUT_OF_BAND when omitted.

One of: RESOLUTION_SOURCE_UNSPECIFIED, RESOLUTION_SOURCE_INLINE_KEYSTROKE, RESOLUTION_SOURCE_OUT_OF_BAND

Default: RESOLUTION_SOURCE_UNSPECIFIED

Request Sample

Show Request Sample
import { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

await client.v2.agents.sessions
    .bySession_id("a1b2c3d4-e5f6-7890-abcd-ef1234567890").hitl
    .byRequest_id("hitl_example").post({
    outcome: "HITL_OUTCOME_UNSPECIFIED",
    reason: "example",
    source: "RESOLUTION_SOURCE_UNSPECIFIED",
});

More Information

See /v2/agents/sessions/{session_id}/hitl/{request_id} in the API reference for additional detail on responses, headers, parameters, and more.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.