H Company Sessions API is one of 10 APIs that H Company publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Sessions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.
This API exposes
18 operations
across 15 paths,
and defines 63 schemas.
It is described by OpenAPI 3.2.0, at version 1.0.0.
Requests are made against 2 base URLs: https://agp.eu.hcompany.ai, https://agp.hcompany.ai.
The identity and technical contract details declared by the specification.
AnswerOutcome
string
Agent's self-assessment of how the task concluded, reported with the final answer.
Session
object
Full session envelope: original request + live status.
8 properties
4 required
ErrorEvent
object
Recoverable error raised while running the agent loop.
4 properties
2 required
FlowEvent
object
Run-loop control transition (pause, resume, stop, ...).
3 properties
2 required
ToolResultBatch
object
Batch of custom tool results.
2 properties
1 required
Agent
object
Declarative agent definition.
9 properties
3 required
Page_SessionEvent_
object
3 properties
3 required
ManagedProxySelection
object
Request for an H-managed proxy, provisioned per session. Describes intent only — pool, country, stickiness — never credentials; H resolves and injects those wh…
3 properties
ToolRequest
object
Tool invocation proposed by the policy.
3 properties
1 required
SessionStatus
object
GET /api/v2/sessions/{id}/status response.
7 properties
1 required
BrowserVisualMode
object
Act on screenshots by viewport coordinates.
4 properties
Skill
object
A named, reusable instruction an agent can draw on during a session.
5 properties
3 required
LiveViewUrlData
object
1 property
1 required
PolicyEvent
object
One policy (LLM) step: the model output plus the tool requests extracted from it.
5 properties
ShareLink
object
Public share URL for a session.
1 property
1 required
AgentStartedData
object
Empty payload.
RequestStartData
object
Empty payload.
RequestStartDispatchedData
object
1 property
1 required
MetricsUpdateEvent
object
Rolled-up usage and cost metrics for the session.
3 properties
3 required
Metrics
object
Rolled-up usage and cost for a session.
6 properties
ModelCost
object
Token usage and cost for a single model.
8 properties
4 required
BrowserNetwork
object
Network egress settings for a remote browser session.
2 properties
MetricsUpdateData
object
1 property
1 required
ValidationError
object
5 properties
3 required
QuotaStatus
object
Quota status.
4 properties
4 required
ActiveStateChangeEvent
object
The agent switched between running, idle and awaiting custom tool results.
3 properties
3 required
AgentCompletionEvent
object
The agent run completed.
3 properties
3 required
AgentStartedEvent
object
The agent process started.
3 properties
3 required
Browser
object
A web browser the agent navigates and acts on.
12 properties
1 required
ObservationEvent
object
What the agent perceived this step: optional text, screenshot and environment metadata.
5 properties
LiveViewUrlEvent
object
A live view URL became available.
3 properties
3 required
AgentCompletionData
object
1 property
1 required
AgentRunStatusChangeData
object
1 property
1 required
Desktop
object
A desktop the agent controls via mouse, keyboard, and screenshots.
4 properties
2 required
AgentErrorEvent
object
The agent run failed.
3 properties
3 required
AnswerEvent
object
Agent's final answer for the current task.
3 properties
1 required
HTTPValidationError
object
1 property
AgentRunStatusChangeEvent
object
The run status changed.
3 properties
3 required
UserMessageBatch
object
Batch of user messages.
2 properties
1 required
SessionChanges
object
Typed view of TrajectoryChanges for Agent API session endpoints.
9 properties
1 required
TrajectoryEvent
object
Event from a trajectory. Unified from agpclient and agentplatform. Uses the richer agentplatform version with screenshot serialization. Events represent indivi…
3 properties
3 required
SessionSummary
object
Flat projection for session listings, including child rosters via ?parentsessionid=.
9 properties
3 required
SessionErrorCode
string
Machine-readable category of a terminal session failure.
RequestStartDispatchedEvent
object
The start request was dispatched to a runner.
3 properties
3 required
Feedback
object
Feedback on the semantic success of the trajectory.
2 properties
1 required
ToolResultEvent
object
Result of executing one tool request.
3 properties
1 required
MessageEvent
object
Message exchanged with the agent (user, system or subagent).
3 properties
1 required
UserMessageEvent
object
The user is sending a message to an active agent.
4 properties
1 required
RequestStartEvent
object
The platform requested the agent to start.
3 properties
3 required
Page_SessionSummary_
object
3 properties
3 required
SessionRequest
object
POST /api/v2/sessions body.
11 properties
1 required
ActiveStateChangeData
object
2 properties
1 required
TrajectoryStatus
string
State of a session/trajectory. Lifecycle:: QUEUED → PENDING → RUNNING → {COMPLETED, FAILED, TIMEDOUT, INTERRUPTED} | | ↑ ↑ ↑ | | | | └───→ IDLE (interactive: a…
ProxyPool
string
The kind of upstream IPs a managed proxy draws from.
ModelUsage
object
Per-model token usage.
4 properties
4 required
BrowserTextMode
object
Read-only markdown with URL navigation, no screenshots.
2 properties
ImageContent
object
Image payload: url for platform-served screenshots, base64 for inline images.
3 properties
2 required
ToolDefinition
object
Contract for a tool executed by the API client, not by the agent runtime. The agent emits a tool call matching inputschema, pauses, and resumes once the client…
3 properties
2 required
AgentErrorData
object
3 properties
1 required
AgentEvent
object
Event emitted by the agent loop itself; data is discriminated by kind.
3 properties
3 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs H Company publishes across the network.
