# H Company

> Run and monitor H agents, manage reusable skills, and read the environments the agents use.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/h-company

## Actions

### Cancel Session

Cancel Session in H Company.

**Inputs**

- Session (`session_id`, text, required): Session ID.

**Outputs**

- `data` (object): The H Company response.

**Example output**

```json
{
  "data": {}
}
```

### Create Session

Create Session in H Company.

**Inputs**

- Agent (`agent`, text, required): Agent.
- Task (`prompt`, text, required): What the agent should do.
- Max steps (`max_steps`, number): Max steps. At least 1.0.
- Max time s (`max_time_s`, number): Max time s.
- Queue (`queue`, true/false): Queue. Default: `true`.

**Outputs**

- `data` (object): Session

**Example output**

```json
{
  "data": {
    "agent_revision": 1,
    "agent_view_url": "example",
    "created_at": "example",
    "dependency_revisions": {
      "environments": [],
      "skills": []
    },
    "finished_at": "example",
    "id": "example",
    "latest_answer": {},
    "request": {
      "agent": {},
      "delete_after_min": 1,
      "delete_screenshot_after_min": 1,
      "group_id": "example",
      "idle_timeout_s": 1,
      "max_steps": 1,
      "max_time_s": 1.0,
      "messages": [],
      "overrides": {},
      "parent_session_id": "example",
      "queue": false,
      "timezone": "example"
    },
    "started_at": "example",
    "status": {
      "error": "example",
      "error_code": "environment_error",
      "outcome": "success",
      "pending_approvals": [],
      "pending_tool_calls": [],
      "status": "queued",
      "steps": 1,
      "subagent_session_ids": [],
      "usage_per_model": []
    }
  }
}
```

### Create Skill

Create Skill in H Company.

**Inputs**

- Message (`message`, text): Message.
- Skill name (`skill_name`, text, required): Use lowercase letters, numbers, and hyphens.
- Description (`description`, text, required): Description.
- Instructions (`instructions`, text, required): Instructions.

**Outputs**

- `data` (object): Skill

**Example output**

```json
{
  "data": {
    "body": "example",
    "compatibility": "example",
    "description": "example",
    "executable_files": [],
    "files": {},
    "name": "example",
    "source": "example",
    "url_pattern": "example"
  }
}
```

### Delete Skill

Delete Skill in H Company.

**Inputs**

- Skill (`skill_name`, text, required): Skill name.

**Outputs**

- `data` (object): The H Company response.

**Example output**

```json
{
  "data": {}
}
```

### Get Agent

Get Agent in H Company.

**Inputs**

- Agent (`agent_name`, text, required): Agent name.
- Revision (`revision`, number): Revision. At least 1.
- Resolve (`resolve`, true/false): Resolve. Default: `false`.

**Outputs**

- `data` (object): Agent

**Example output**

```json
{
  "data": {
    "answer_format": {},
    "description": "example",
    "environments": [],
    "instructions": "example",
    "model": "example",
    "name": "example",
    "reasoning_effort": "disabled",
    "skills": [],
    "subagents": [],
    "tools": []
  }
}
```

### Get Environment

Get Environment in H Company.

**Inputs**

- Environment (`environment_id`, text, required): Environment ID.
- Revision (`revision`, number): Revision. At least 1.

**Outputs**

- `data` (object): Browser

**Example output**

```json
{
  "data": {
    "browser_profile_id": "example",
    "headless": false,
    "host": "user_device",
    "id": "example",
    "kind": "web",
    "lazy": false,
    "mode": {
      "height": 1,
      "markdown": false,
      "type": "visual",
      "width": 1
    },
    "network": {
      "managed_proxy": {
        "country": "example",
        "pool": "residential",
        "sticky": false
      },
      "proxy_url": "example"
    },
    "persist_browser_profile": false,
    "session_id": "example",
    "settle_s": 1.0,
    "start_url": "example",
    "use_default_browser_profile": false,
    "vault_id": "example"
  }
}
```

### Get Session

Get Session in H Company.

**Inputs**

- Session (`session_id`, text, required): Session ID.

**Outputs**

- `data` (object): Session

**Example output**

```json
{
  "data": {
    "agent_revision": 1,
    "agent_view_url": "example",
    "created_at": "example",
    "dependency_revisions": {
      "environments": [],
      "skills": []
    },
    "finished_at": "example",
    "id": "example",
    "latest_answer": {},
    "request": {
      "agent": {},
      "delete_after_min": 1,
      "delete_screenshot_after_min": 1,
      "group_id": "example",
      "idle_timeout_s": 1,
      "max_steps": 1,
      "max_time_s": 1.0,
      "messages": [],
      "overrides": {},
      "parent_session_id": "example",
      "queue": false,
      "timezone": "example"
    },
    "started_at": "example",
    "status": {
      "error": "example",
      "error_code": "environment_error",
      "outcome": "success",
      "pending_approvals": [],
      "pending_tool_calls": [],
      "status": "queued",
      "steps": 1,
      "subagent_session_ids": [],
      "usage_per_model": []
    }
  }
}
```

### Get Session Changes

Get Session Changes in H Company.

**Inputs**

- Session (`session_id`, text, required): Session ID.
- From index (`from_index`, number): From index. Default: `0`.
- Limit (`limit`, number): Limit. At least 0.
- Include events (`include_events`, true/false): Include events. Default: `true`.

**Outputs**

- `data` (object): SessionChanges

**Example output**

```json
{
  "data": {
    "answer": {},
    "error": "example",
    "error_code": "environment_error",
    "finished_at": "example",
    "first_index": 1,
    "metrics": {
      "cost_per_model": [],
      "input_cost": 1.0,
      "output_cost": 1.0,
      "reasoning_cost": 1.0,
      "steps": 1,
      "total_cost": 1.0
    },
    "new_events": [],
    "outcome": "success",
    "pending_approvals": [],
    "pending_tool_calls": [],
    "started_at": "example",
    "status": "queued"
  }
}
```

### Get Session Quota

Get Session Quota in H Company.

**Inputs**: None.

**Outputs**

- `data` (object): QuotaStatus

**Example output**

```json
{
  "data": {
    "active": 1,
    "available": 1,
    "limit": 1,
    "scope": "user"
  }
}
```

### Get Session Status

Get Session Status in H Company.

**Inputs**

- Session (`session_id`, text, required): Session ID.

**Outputs**

- `data` (object): SessionStatus

**Example output**

```json
{
  "data": {
    "error": "example",
    "error_code": "environment_error",
    "outcome": "success",
    "pending_approvals": [],
    "pending_tool_calls": [],
    "status": "queued",
    "steps": 1,
    "subagent_session_ids": [],
    "usage_per_model": []
  }
}
```

### Get Skill

Get Skill in H Company.

**Inputs**

- Skill (`skill_name`, text, required): Skill name.
- Revision (`revision`, number): Revision. At least 1.

**Outputs**

- `data` (object): Skill

**Example output**

```json
{
  "data": {
    "body": "example",
    "compatibility": "example",
    "description": "example",
    "executable_files": [],
    "files": {},
    "name": "example",
    "source": "example",
    "url_pattern": "example"
  }
}
```

### Get Token Quota

Get Token Quota in H Company.

**Inputs**: None.

**Outputs**

- `data` (object): TokenQuotaStatus

**Example output**

```json
{
  "data": {
    "limit": 1,
    "remaining": 1,
    "used": 1,
    "window_end": "example",
    "window_start": "example"
  }
}
```

### List Agent Revisions

List Agent Revisions in H Company.

**Inputs**

- Agent (`agent_name`, text, required): Agent name.
- Page (`page`, number): Page. At least 1. Default: `1`.
- Size (`size`, number): Size. From 1 to 1000. Default: `10`.

**Outputs**

- `data` (object): Page[AgentRevisionRecord]

**Example output**

```json
{
  "data": {
    "items": [],
    "page": 1,
    "total": 1
  }
}
```

### List Agents

List Agents in H Company.

**Inputs**

- Search (`search`, text): Search.
- Reserved (`reserved`, true/false): Reserved.
- Include (`include`, text): Include. One of: `revision`.
- Page (`page`, number): Page. At least 1. Default: `1`.
- Size (`size`, number): Size. From 1 to 1000. Default: `10`.

**Outputs**

- `data` (object): Page[Agent]

**Example output**

```json
{
  "data": {
    "items": [],
    "page": 1,
    "total": 1
  }
}
```

### List Environments

List Environments in H Company.

**Inputs**

- Kind (`target_kind`, text): Kind. One of: `web`, `desktop`, `android`, `workstation`.
- Search (`search`, text): Search.
- Page (`page`, number): Page. At least 1. Default: `1`.
- Size (`size`, number): Size. From 1 to 1000. Default: `10`.

**Outputs**

- `data` (object): EnvironmentPage

**Example output**

```json
{
  "data": {
    "items": [],
    "page": 1,
    "total": 1
  }
}
```

### List Session Events

List Session Events in H Company.

**Inputs**

- Session (`session_id`, text, required): Session ID.
- Page (`page`, number): Page. At least 1. Default: `1`.
- Size (`size`, number): Size. From 1 to 200. Default: `50`.
- Type (`type`, text): Type.

**Outputs**

- `data` (object): Page[SessionEvent]

**Example output**

```json
{
  "data": {
    "items": [],
    "page": 1,
    "total": 1
  }
}
```

### List Sessions

List Sessions in H Company.

**Inputs**

- Owner (`owner`, text): Owner. One of: `me`, `me-in-organization`, `organization`, `me-or-organization`. Default: `me-in-organization`.
- Status (`status`, list): Status. One or more of: `queued`, `pending`, `running`, `paused`, `idle`, `awaiting_tool_results` (Awaiting tool results), `completed`, `failed`, `timed_out` (Timed out), `interrupted`.
- Agent (`agent`, list): Agent.
- Search (`search`, text): Search.
- Created before (`created_before`, date and time): Created before.
- Created after (`created_after`, date and time): Created after.
- Finished before (`finished_before`, date and time): Finished before.
- Finished after (`finished_after`, date and time): Finished after.
- Page (`page`, number): Page. At least 1. Default: `1`.
- Size (`size`, number): Size. From 1 to 100. Default: `10`.

**Outputs**

- `data` (object): Page[SessionSummary]

**Example output**

```json
{
  "data": {
    "items": [],
    "page": 1,
    "total": 1
  }
}
```

### List Skill Revisions

List Skill Revisions in H Company.

**Inputs**

- Skill (`skill_name`, text, required): Skill name.
- Page (`page`, number): Page. At least 1. Default: `1`.
- Size (`size`, number): Size. From 1 to 1000. Default: `10`.

**Outputs**

- `data` (object): Page[SkillRevisionRecord]

**Example output**

```json
{
  "data": {
    "items": [],
    "page": 1,
    "total": 1
  }
}
```

### List Skills

List Skills in H Company.

**Inputs**

- Skill name (`skill_name`, text): Skill name.
- Search (`search`, text): Search.
- Page (`page`, number): Page. At least 1. Default: `1`.
- Size (`size`, number): Size. From 1 to 1000. Default: `10`.

**Outputs**

- `data` (object): Page[Skill]

**Example output**

```json
{
  "data": {
    "items": [],
    "page": 1,
    "total": 1
  }
}
```

### Patch Skill

Patch Skill in H Company.

**Inputs**

- Skill (`skill_name`, text, required): Skill name.
- Message (`message`, text): Message.
- Description (`description`, text): Description.
- Instructions (`instructions`, text): Instructions.

**Outputs**

- `data` (object): Skill

**Example output**

```json
{
  "data": {
    "body": "example",
    "compatibility": "example",
    "description": "example",
    "executable_files": [],
    "files": {},
    "name": "example",
    "source": "example",
    "url_pattern": "example"
  }
}
```
