How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Toolhouse SDK API API

The SDK API API from Toolhouse — 20 operation(s) for sdk api.

Toolhouse SDK API API is one of 8 APIs that Toolhouse publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include SDK API. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 30 operations across 20 paths, and defines 26 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against a single base URL, https://agents.toolhouse.ai.

30 operations 20 paths 26 schemas 3 DELETE16 GET1 PATCH7 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://agents.toolhouse.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Toolhouse SDK API API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 30

Across 20 paths, the API surfaces 30 operations — 3 DELETE, 16 GET, 1 PATCH, 7 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

SDK API 30
GET
/v1/agent-runs
Get All Agent Runs
get_all_agent_runs_v1_agent_runs_get → 200500
POST
/v1/agent-runs
Create Agent Run
create_agent_run_v1_agent_runs_post body → 200403500422
GET
/v1/agent-runs/{run_id}
Get Agent Run
get_agent_run_v1_agent_runs__run_id__get 1 param → 200403404500422
PUT
/v1/agent-runs/{run_id}
Put Agent Run
put_agent_run_v1_agent_runs__run_id__put 1 param body → 200403406500422
GET
/v1/agents/{agent_id}/files
Get Agent Files For Service
get_agent_files_for_service_v1_agents__agent_id__files_get 1 param → 200403404422
GET
/v1/agents
Get All Chats
get_all_chats_v1_agents_get → 200500
POST
/v1/agents
Upsert Agent
upsert_agent_v1_agents_post body → 200400403500422
GET
/v1/agents/{chat_id}
Get Chat
get_chat_v1_agents__chat_id__get 1 param → 200403404500422
PUT
/v1/agents/{chat_id}
Edit Chat
edit_chat_v1_agents__chat_id__put 1 param body → 200400403404409500422
PATCH
/v1/agents/{chat_id}
Patch Chat
patch_chat_v1_agents__chat_id__patch 1 param body → 200400403404500422
DELETE
/v1/agents/{chat_id}
Del Chat
del_chat_v1_agents__chat_id__delete 1 param → 200403404500422
GET
/v1/agents/{chat_id}/og
Get Chat Og Metadata
get_chat_og_metadata_v1_agents__chat_id__og_get 1 param → 200500422
POST
/v1/agents/{chat_id}/clone
Clone Chat
clone_chat_v1_agents__chat_id__clone_post 1 param → 200403500422
POST
/v1/agents/{chat_id}/feedback
Post Chat Feedback
post_chat_feedback_v1_agents__chat_id__feedback_post 1 param body → 200404500422
GET
/v1/cli/version
Cli
cli_v1_cli_version_get 1 param → 200422503
POST
/v1/cli-telemetry
Post Cli Telemetry
post_cli_telemetry_v1_cli_telemetry_post body → 200500422
GET
/v1/users
Get Users Endpoint
get_users_endpoint_v1_users_get → 200500
GET
/v1/kv
Get All Kv
get_all_kv_v1_kv_get → 200500
POST
/v1/kv
Upsert Kv
upsert_kv_v1_kv_post body → 200500422
DELETE
/v1/kv/{key}
Delete Kv
delete_kv_v1_kv__key__delete 1 param → 200500422
GET
/v1/schedules
Get Schedule List
get_schedule_list_v1_schedules_get → 200500
POST
/v1/schedules
Create Schedule
create_schedule_v1_schedules_post body → 200403500422
GET
/v1/schedules/text-to-cron
Text To Cron
text_to_cron_v1_schedules_text_to_cron_get 1 param → 200400500422
GET
/v1/schedules/{schedule_id}
Get Schedule By Id
get_schedule_by_id_v1_schedules__schedule_id__get 1 param → 200404500422
PUT
/v1/schedules/{schedule_id}
Edit Schedule
edit_schedule_v1_schedules__schedule_id__put 1 param body → 200500422
DELETE
/v1/schedules/{schedule_id}
Del Schedule
del_schedule_v1_schedules__schedule_id__delete 1 param → 200400500422
GET
/v1/th-file-schema
Get Th File Schema
get_th_file_schema_v1_th_file_schema_get → 200
GET
/v1/me
Get User
get_user_v1_me_get → 200
GET
/v1/vibe/services
Get Vibe Services
get_vibe_services_v1_vibe_services_get → 200
GET
/v1/agents/{agent_id}/vibe
Get Vibe Agent Prompt
get_vibe_agent_prompt_v1_agents__agent_id__vibe_get 2 params → 200422

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are AgentModel (22 properties), AgentRequestPartial (17 properties), AgentRequest (17 properties), Schedule (14 properties). Each schema is shown below with its type and property counts.

AgentFileListResponse
object
API response wrapper for multiple files
1 property 1 required
ScheduleUpdateRequest
object
6 properties 1 required
AgentRequest
object
17 properties 1 required
VibeCoderPromptResponse
object
Vibe Coder Response
2 properties 2 required
UpsellDescription
object
2 properties 2 required
AgentFileModel
object
Full model with database fields (ORM model)
10 properties 6 required
AgentRunUpdateRequest
object
1 property 1 required
UserFeedbackRequest
object
1 property 1 required
BaseKV
object
2 properties 1 required
ScheduleRequest
object
5 properties 2 required
VibeCoderListResponse
object
1 property 1 required
AgentRunAPIResponse
object
1 property 1 required
UserAuthenticated
object
User Authenticated
4 properties 4 required
AgentRunResponse
object
11 properties 2 required
Schedule
object
14 properties 3 required
ValidationError
object
3 properties 3 required
Service
object
2 properties 2 required
HTTPValidationError
object
1 property
AgentModel
object
22 properties 2 required
CliTelemetryEvents
object
2 properties 2 required
CliVersionResponse
object
3 properties 3 required
AgentRun
object
12 properties 3 required
AgentRunRequest
object
5 properties 1 required
AgentRunListResponse
object
1 property 1 required
AgentRequestPartial
object
17 properties
ScheduleListResponse
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

toolhouse-sdk-api-api-openapi.yml Raw ↑

Other APIs Toolhouse publishes across the network.

Toolhouse Workers API
Toolhouse Agent Runs API
Toolhouse API Keys API
Toolhouse Backoffice API
Toolhouse Logs API
Toolhouse Metrics API
Toolhouse User API API
Where this information came from

This is an independent, third-party profile of Toolhouse SDK API API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.