H Company
H Company Computer-Use Agents API

Launch, steer, schedule, and observe autonomous computer-use agent sessions that drive browsers and desktops. Reusable agents, skills, environments, browser profiles, vaults, cron schedules, and signed webhooks. Bearer API-key auth, Idempotency-Key support, isolated EU and US regions, and an official MCP server.
Documentation GitHub OpenAPI
OpenAPI Specification

{"openapi":"3.1.0","info":{"title":"Computer-Use Agents","version":"1.0.0"},"servers":[{"url":"https://agp.eu.hcompany.ai","description":"Europe","x-fern-server-name":"Eu"},{"url":"https://agp.hcompany.ai","description":"United States","x-fern-server-name":"Us"}],"paths":{"/api/v2/sessions":{"post":{"tags":["Sessions"],"summary":"Create Session","description":"Create an agentic session.","operationId":"create_session_api_v2_sessions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Sessions"],"summary":"List Sessions","description":"List sessions visible to ``user``.","operationId":"list_sessions_api_v2_sessions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"owner","in":"query","required":false,"schema":{"enum":["me","me-in-organization","organization","me-or-organization"],"type":"string","default":"me-in-organization","title":"Owner"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/TrajectoryStatus"}},{"type":"null"}],"title":"Status"}},{"name":"agent","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Agent"}},{"name":"group_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id"}},{"name":"parent_session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Session Id"}},{"name":"schedule_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Only sessions created by this schedule.","title":"Schedule Id"},"description":"Only sessions created by this schedule."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive match on the session's first message or answer.","title":"Search"},"description":"Case-insensitive match on the session's first message or answer."},{"name":"created_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created Before"}},{"name":"created_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created After"}},{"name":"finished_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished Before"}},{"name":"finished_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished After"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Size"},"description":"Number of items per page"},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["created_at","-created_at"],"type":"string"}},{"type":"null"}],"description":"Sort by field","default":["-created_at"],"title":"Sort"},"description":"Sort by field"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_SessionSummary_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/quota":{"get":{"tags":["Sessions"],"summary":"Get Session Quota","description":"Concurrent-session quota for the authenticated user.","operationId":"get_session_quota_api_v2_sessions_quota_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v2/sessions/{id}":{"get":{"tags":["Sessions"],"summary":"Get Session","description":"Get a session.","operationId":"get_session_api_v2_sessions__id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Sessions"],"summary":"Cancel Session","description":"Cancel the session.","operationId":"cancel_session_api_v2_sessions__id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/status":{"get":{"tags":["Sessions"],"summary":"Get Session Status","description":"Get a session's live status.","operationId":"get_session_status_api_v2_sessions__id__status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/messages":{"post":{"tags":["Sessions"],"summary":"Send Session Messages","description":"Send a user message (single or batch).","operationId":"send_session_messages_api_v2_sessions__id__messages_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UserMessageEvent"},{"$ref":"#/components/schemas/UserMessageBatch"}],"discriminator":{"propertyName":"type","mapping":{"user_message":"#/components/schemas/UserMessageEvent","batch":"#/components/schemas/UserMessageBatch"}},"title":"Input"}}}},"responses":{"202":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/tool_results":{"post":{"tags":["Sessions"],"summary":"Send Session Tool Results","description":"Send results for custom tool calls (single or batch).","operationId":"send_session_tool_results_api_v2_sessions__id__tool_results_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ToolResultEvent"},{"$ref":"#/components/schemas/ErrorEvent"},{"$ref":"#/components/schemas/ToolResultBatch"}],"title":"Input"}}}},"responses":{"202":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/pause":{"post":{"tags":["Sessions"],"summary":"Pause Session","description":"Pause the session.","operationId":"pause_session_api_v2_sessions__id__pause_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"202":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/resume":{"post":{"tags":["Sessions"],"summary":"Resume Session","description":"Resume the session.","operationId":"resume_session_api_v2_sessions__id__resume_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"202":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/force_answer":{"post":{"tags":["Sessions"],"summary":"Force Session Answer","description":"Ask the agent to emit a final answer on its next step.","operationId":"force_session_answer_api_v2_sessions__id__force_answer_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"202":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/changes":{"get":{"tags":["Sessions"],"summary":"Get Session Changes","description":"Long-poll for new events since ``from_index``; 204 if none arrive within ``wait_for_seconds``.","operationId":"get_session_changes_api_v2_sessions__id__changes_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"from_index","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"From Index"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Limit"}},{"name":"include_events","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Events"}},{"name":"wait_for_seconds","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":0,"default":0,"title":"Wait For Seconds"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionChanges"}}}},"204":{"description":"No changes since the specified index"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/events":{"get":{"tags":["Sessions"],"summary":"List Session Events","description":"Paginated event history. Use ``/changes`` for live tailing.","operationId":"list_session_events_api_v2_sessions__id__events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Size"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["timestamp","-timestamp"],"type":"string"}},{"type":"null"}],"title":"Sort"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_SessionEvent_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/feedback":{"post":{"tags":["Sessions"],"summary":"Submit Session Feedback","description":"Record semantic-success feedback on the whole session.","operationId":"submit_session_feedback_api_v2_sessions__id__feedback_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/events/{event_index}/feedback":{"put":{"tags":["Sessions"],"summary":"Submit Event Feedback","description":"Record feedback on a single event in the session's history.","operationId":"submit_event_feedback_api_v2_sessions__id__events__event_index__feedback_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"event_index","in":"path","required":true,"schema":{"type":"integer","title":"Event Index"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/share":{"post":{"tags":["Sessions"],"summary":"Share Session","description":"Make the session publicly readable; returns the share URL path.","operationId":"share_session_api_v2_sessions__id__share_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareLink"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Sessions"],"summary":"Unshare Session","description":"Revoke public access to the session.","operationId":"unshare_session_api_v2_sessions__id__share_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/sessions/{id}/resources/{bucket}/{key}":{"get":{"tags":["Sessions"],"summary":"Get Session Resource","description":"Redirect to a presigned S3 URL for a session-owned resource.","operationId":"get_session_resource_api_v2_sessions__id__resources__bucket___key__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"bucket","in":"path","required":true,"schema":{"type":"string","title":"Bucket"}},{"name":"key","in":"path","required":true,"schema":{"type":"string","title":"Key"}}],"responses":{"302":{"description":"Redirect to a presigned URL for a session-owned resource."},"200":{"description":"Resource bytes. The API redirects to a presigned S3 URL; SDK clients follow the redirect and receive the raw object (e.g. screenshot image bytes).","content":{"application/octet-stream":{}}},"404":{"description":"Session or resource not found."},"4XX":{"description":"Client error."}}}},"/api/v2/skills":{"post":{"tags":["Skills"],"summary":"Create Skill","description":"Create a skill. The ``h/`` namespace is reserved for built-in skills.","operationId":"create_skill_api_v2_skills_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Skills"],"summary":"List Skills","description":"List reserved + caller's org skills. Unauthenticated callers see reserved ``h/`` skills only.","operationId":"list_skills_api_v2_skills_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring match on skill name.","title":"Name"},"description":"Case-insensitive substring match on skill name."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive match on skill name or description.","title":"Search"},"description":"Case-insensitive match on skill name or description."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of items per page","default":10,"title":"Size"},"description":"Number of items per page"},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["created_at","-created_at","name","-name"],"type":"string"}},{"type":"null"}],"description":"Sort by field","default":["-created_at"],"title":"Sort"},"description":"Sort by field"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Skill_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/skills/{name}":{"get":{"tags":["Skills"],"summary":"Get Skill","description":"Fetch by name; 404 if not visible. ``:path`` so slash-containing names round-trip.","operationId":"get_skill_api_v2_skills__name__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Skills"],"summary":"Update Skill","description":"Replace a skill's content. ``name`` must match the URL identifier; renames are not supported.","operationId":"update_skill_api_v2_skills__name__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Skills"],"summary":"Patch Skill","description":"Partially update a skill; only provided fields change.","operationId":"patch_skill_api_v2_skills__name__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchSkill"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Skill"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Skills"],"summary":"Delete Skill","description":"Delete by name. Reserved rows: H employee only.","operationId":"delete_skill_api_v2_skills__name__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/environments":{"post":{"tags":["Environments"],"summary":"Create Environment","description":"Create an environment.","operationId":"create_environment_api_v2_environments_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Browser"},{"$ref":"#/components/schemas/Desktop"}],"discriminator":{"propertyName":"kind","mapping":{"web":"#/components/schemas/Browser","desktop":"#/components/schemas/Desktop"}},"title":"Create"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Environment"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Environments"],"summary":"List Environments","description":"List reserved + caller's org environments. Unauthenticated callers see reserved ``h/`` environments only.","operationId":"list_environments_api_v2_environments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring match on environment id.","title":"Id"},"description":"Case-insensitive substring match on environment id."},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EnvironmentKind"},{"type":"null"}],"description":"Filter by environment kind.","title":"Kind"},"description":"Filter by environment kind."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive match on environment id or description.","title":"Search"},"description":"Case-insensitive match on environment id or description."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of items per page","default":10,"title":"Size"},"description":"Number of items per page"},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["created_at","-created_at","id","-id"],"type":"string"}},{"type":"null"}],"description":"Sort by field","default":["-created_at"],"title":"Sort"},"description":"Sort by field"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvironmentPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/environments/{id}":{"get":{"tags":["Environments"],"summary":"Get Environment","description":"Fetch by identifier; 404 if not visible. ``:path`` so slash-containing ids round-trip.","operationId":"get_environment_api_v2_environments__id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Environment"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Environments"],"summary":"Update Environment","description":"Replace the environment spec.","operationId":"update_environment_api_v2_environments__id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Browser"},{"$ref":"#/components/schemas/Desktop"}],"discriminator":{"propertyName":"kind","mapping":{"web":"#/components/schemas/Browser","desktop":"#/components/schemas/Desktop"}},"title":"Update"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Environment"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Environments"],"summary":"Patch Environment","description":"Partially update an environment spec; only provided fields change.","operationId":"patch_environment_api_v2_environments__id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchEnvironment"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Environment"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Environments"],"summary":"Delete Environment","description":"Delete by identifier. Reserved rows: H employee only.","operationId":"delete_environment_api_v2_environments__id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/agents":{"post":{"tags":["Agents"],"summary":"Create Agent","description":"Create an agent..","operationId":"create_agent_api_v2_agents_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Agents"],"summary":"List Agents","description":"List reserved + caller's org agents. Unauthenticated callers see reserved ``h/`` agents only.","operationId":"list_agents_api_v2_agents_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring match on agent name.","title":"Agent Name"},"description":"Case-insensitive substring match on agent name."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive match on agent name or description.","title":"Search"},"description":"Case-insensitive match on agent name or description."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of items per page","default":10,"title":"Size"},"description":"Number of items per page"},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["created_at","-created_at","agent_name","-agent_name"],"type":"string"}},{"type":"null"}],"description":"Sort by field","default":["-created_at"],"title":"Sort"},"description":"Sort by field"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Agent_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/agents/{agent_name}":{"get":{"tags":["Agents"],"summary":"Get Agent","description":"Fetch by identifier; 404 if not visible. ``resolve=true`` materialises spec leaves.","operationId":"get_agent_api_v2_agents__agent_name__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_name","in":"path","required":true,"schema":{"type":"string","title":"Agent Name"}},{"name":"resolve","in":"query","required":false,"schema":{"type":"boolean","description":"Materialise string environment/skill/subagent leaves into full specs.","default":false,"title":"Resolve"},"description":"Materialise string environment/skill/subagent leaves into full specs."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Agents"],"summary":"Update Agent","description":"Replace ``spec``. ``spec.name`` must match the URL identifier; renames are not supported.","operationId":"update_agent_api_v2_agents__agent_name__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_name","in":"path","required":true,"schema":{"type":"string","title":"Agent Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Agents"],"summary":"Patch Agent","description":"Partially update an agent spec; only provided fields change.","operationId":"patch_agent_api_v2_agents__agent_name__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_name","in":"path","required":true,"schema":{"type":"string","title":"Agent Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchAgent"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Agents"],"summary":"Delete Agent","description":"Delete by identifier. Reserved rows: H employee only.","operationId":"delete_agent_api_v2_agents__agent_name__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"agent_name","in":"path","required":true,"schema":{"type":"string","title":"Agent Name"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v2/webhooks":{"post":{"tags":["Webhooks"],"summary":"Create Webhook","description":"Register a webhook. The signing secret is only returned here; store it securely.","operationId":"create_webhook_api_v2_webhooks_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhook"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookWithSecret"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Webhooks"],"summary":"List Webhooks","description":"List the organization's webhooks.","operationId":"list_webhooks_api_v2_webhooks_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based)","default":1,"title":"Page"},"description":"Page number (1-based)"},{"name":"size","in":"query","r

# --- truncated at 32 KB (113 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/h-company/refs/heads/main/openapi/h-company-computer-use-agents-openapi-original.json
H Company Computer-Use Agents API

Documentation

Specifications

Other Resources

OpenAPI Specification
