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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Toolhouse

Toolhouse User API API

The User API API from Toolhouse — 58 operation(s) for user api.

Documentation Provider Profile APIs.io OpenAPI GitHub

Toolhouse User 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 User API. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 78 operations across 58 paths, and defines 72 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.

78 operations 58 paths 72 schemas 5 DELETE44 GET3 PATCH20 POST6 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 User API API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 78

Across 58 paths, the API surfaces 78 operations — 5 DELETE, 44 GET, 3 PATCH, 20 POST, 6 PUT. Each is listed below with its method, path, parameters, and response codes.

User API 78
GET
/me/agent-runs
Get User Agent Runs
get_user_agent_runs_me_agent_runs_get 2 params → 200500422
GET
/me/agent-runs/{run_id}
Get User Agent Run
get_user_agent_run_me_agent_runs__run_id__get 1 param → 200404500422
GET
/me/agent-runs/{run_id}/mcp-server-logs
Get User Agent Run Mcp Server Logs
get_user_agent_run_mcp_server_logs_me_agent_runs__run_id__mcp_server_logs_get 1 param → 200500422
GET
/me/agent-runs/{run_id}/logs
Get User Agent Run Logs
get_user_agent_run_logs_me_agent_runs__run_id__logs_get 1 param → 200500422
POST
/me/agents/{agent_id}/subscribe
Subscribe To Agent
subscribe_to_agent_me_agents__agent_id__subscribe_post 1 param body → 200400402404422
POST
/me/agents/{agent_id}/unsubscribe
Unsubscribe From Agent
unsubscribe_from_agent_me_agents__agent_id__unsubscribe_post 1 param → 200400404422
GET
/me/subscriptions
List Agent Subscriptions
list_agent_subscriptions_me_subscriptions_get → 200
GET
/me/subscriptions/{agent_id}
Get Agent Subscription
get_agent_subscription_me_subscriptions__agent_id__get 1 param → 200404422
GET
/me/agent-studio-chats
Get Agent Studio Chats
get_agent_studio_chats_me_agent_studio_chats_get → 200
POST
/me/agent-studio-chats
Create Agent Studio Chat
create_agent_studio_chat_me_agent_studio_chats_post body → 200400409422
GET
/me/agent-studio-chats/{run_id}
Get Agent Studio Chat
get_agent_studio_chat_me_agent_studio_chats__run_id__get 1 param → 200403404422
PUT
/me/agent-studio-chats/{run_id}
Update Agent Studio Chat
update_agent_studio_chat_me_agent_studio_chats__run_id__put 1 param body → 200400403404422
PATCH
/me/agent-studio-chats/{run_id}
Patch Agent Studio Chat
patch_agent_studio_chat_me_agent_studio_chats__run_id__patch 1 param body → 200400403404422
DELETE
/me/agent-studio-chats/{run_id}
Delete Agent Studio Chat
delete_agent_studio_chat_me_agent_studio_chats__run_id__delete 1 param → 200400403404422
POST
/me/agent-studio-chats/{run_id}/clone
Clone Agent Studio Chat
clone_agent_studio_chat_me_agent_studio_chats__run_id__clone_post 1 param → 201400404422
GET
/me/agents/{agent_id}/customizations/theme
Get Agent Theme Preference
get_agent_theme_preference_me_agents__agent_id__customizations_theme_get 1 param → 200403404422
PUT
/me/agents/{agent_id}/customizations/theme
Upsert Agent Theme Preference
upsert_agent_theme_preference_me_agents__agent_id__customizations_theme_put 1 param body → 200400403404422
GET
/me/agents/{agent_id}/files
List Agent Files
list_agent_files_me_agents__agent_id__files_get 1 param → 200403404422
POST
/me/agents/{agent_id}/files
Create Agent File
create_agent_file_me_agents__agent_id__files_post 1 param body → 201400403404422
GET
/me/agents/{agent_id}/files/{file_id}
Get Agent File
get_agent_file_me_agents__agent_id__files__file_id__get 2 params → 200403404422
PATCH
/me/agents/{agent_id}/files/{file_id}
Update Agent File
update_agent_file_me_agents__agent_id__files__file_id__patch 2 params body → 200403404422
DELETE
/me/agents/{agent_id}/files/{file_id}
Delete Agent File
delete_agent_file_me_agents__agent_id__files__file_id__delete 2 params → 204403404422
PUT
/me/agents/{agent_id}/files/positions
Update File Positions
update_file_positions_me_agents__agent_id__files_positions_put 1 param body → 200403404422
GET
/me/agents
Get All Agents
get_all_agents_me_agents_get → 200
POST
/me/agents
Upsert Agent
upsert_agent_me_agents_post body → 200400403404422
GET
/me/agents/list
Get Agents List
get_agents_list_me_agents_list_get 3 params → 200400422
GET
/me/agents/{agent_id}
Get Agent
get_agent_me_agents__agent_id__get 1 param → 200403404422
POST
/me/agents/{agent_id}/upsell-description
Generate Agent Upsell Description
generate_agent_upsell_description_me_agents__agent_id__upsell_description_post 1 param → 200404500422
POST
/me/agents/vanity/slug
Generate Slug
generate_slug_me_agents_vanity_slug_post body → 200500422
GET
/me/agents/vanity/slug
Check Slug Availability
check_slug_availability_me_agents_vanity_slug_get 1 param → 200422
POST
/me/agents/{agent_id}/transfer
Transfer Agent
transfer_agent_me_agents__agent_id__transfer_post 1 param body → 200403404422
GET
/me/api-keys
Get Api Keys
get_api_keys_me_api_keys_get → 200500
POST
/me/api-keys
Post Create Api Key
post_create_api_key_me_api_keys_post body → 200500422
GET
/me/api-keys/default
Get Default Api Key
get_default_api_key_me_api_keys_default_get → 200500
GET
/me/api-keys/{api_key_id}
Get Api Key
get_api_key_me_api_keys__api_key_id__get 1 param → 200404500422
DELETE
/me/api-keys/{api_key_id}
Delete Api Key
delete_api_key_me_api_keys__api_key_id__delete 1 param → 200404500422
GET
/me/billing
Billing Information
billing_information_me_billing_get → 200500
GET
/me/chats
Get All Chats
get_all_chats_me_chats_get → 200
POST
/me/chatsdeprecated
Create Chat
create_chat_me_chats_post body → 200400422
GET
/me/chats/{chat_id}
Get Chat
get_chat_me_chats__chat_id__get 1 param → 200403404422
PUT
/me/chats/{chat_id}
Edit Chat
edit_chat_me_chats__chat_id__put 1 param body → 200400403404422
PATCH
/me/chats/{chat_id}
Patch Chat
patch_chat_me_chats__chat_id__patch 1 param body → 200400403404422
DELETE
/me/chats/{chat_id}
Del Chat
del_chat_me_chats__chat_id__delete 1 param → 200403404422
GET
/me/chats/{chat_id}/og
Get Chat Og Metadata
get_chat_og_metadata_me_chats__chat_id__og_get 1 param → 200422
POST
/me/chats/{chat_id}/clone
Clone Chat
clone_chat_me_chats__chat_id__clone_post 1 param body → 200403404422
POST
/me/chats/{chat_id}/feedback
Post Chat Feedback
post_chat_feedback_me_chats__chat_id__feedback_post 1 param body → 200404422
POST
/me/chats/{chat_id}/runs
Post Agent Run Log
post_agent_run_log_me_chats__chat_id__runs_post 1 param → 200403404500422
POST
/me/cli-auth
Create Cli Auth
create_cli_auth_me_cli_auth_post → 200503
PUT
/me/cli-auth/{cli_auth_id}
Update Cli Auth
update_cli_auth_me_cli_auth__cli_auth_id__put 1 param body → 200403404503422
GET
/me/cli-auth/{auth_id}
Get Cli Auth
get_cli_auth_me_cli_auth__auth_id__get 1 param → 200404503422
GET
/me/credits
Get User Credits
get_user_credits_me_credits_get → 200404500
POST
/me/credits/use
Use User Credits
use_user_credits_me_credits_use_post → 200404500
GET
/me/executions
Get User Logs
get_user_logs_me_executions_get 2 params → 200500422
GET
/me/executions/{log_id}
Get User Log By Id
get_user_log_by_id_me_executions__log_id__get 1 param → 200404500422
GET
/me/metrics/agent-runs
Get Agent Run Metrics
get_agent_run_metrics_me_metrics_agent_runs_get 2 params → 200500422
GET
/me/metrics/agent-runs/summary
Get Agent Run Metrics Summary
get_agent_run_metrics_summary_me_metrics_agent_runs_summary_get 2 params → 200500422
GET
/me/metrics/agent-runs/volume
Get Agent Run Metrics Volume
get_agent_run_metrics_volume_me_metrics_agent_runs_volume_get 2 params → 200500422
GET
/me/metrics/agent-runs/agents
Get Agent Run Metrics Agents
get_agent_run_metrics_agents_me_metrics_agent_runs_agents_get 2 params → 200500422
GET
/me/monetization/summary
Get Monetization Summary
get_monetization_summary_me_monetization_summary_get 1 param → 200422
GET
/me/monetization/subscribers
Get Monetization Subscribers
get_monetization_subscribers_me_monetization_subscribers_get 1 param → 200422
GET
/me/monetization/earnings
Get Monetization Earnings
get_monetization_earnings_me_monetization_earnings_get 1 param → 200422
POST
/me/stripe/webhook
Stripe Webhook
stripe_webhook_me_stripe_webhook_post → 200400
POST
/me/stripe/sessions
Get Stripe Sessions
get_stripe_sessions_me_stripe_sessions_post body → 200422
GET
/me/schedules
Get Schedule List
get_schedule_list_me_schedules_get → 200500
POST
/me/schedules
Create Schedule
create_schedule_me_schedules_post body → 200403500422
GET
/me/schedules/onboarding
Get Onboarding Schedule
get_onboarding_schedule_me_schedules_onboarding_get → 200500
GET
/me/schedules/text-to-cron
Text To Cron
text_to_cron_me_schedules_text_to_cron_get 1 param → 200400500422
GET
/me/schedules/{schedule_id}
Get Schedule By Id
get_schedule_by_id_me_schedules__schedule_id__get 1 param → 200404500422
PUT
/me/schedules/{schedule_id}
Edit Schedule
edit_schedule_me_schedules__schedule_id__put 1 param body → 200500422
DELETE
/me/schedules/{schedule_id}
Del Schedule
del_schedule_me_schedules__schedule_id__delete 1 param → 200500422
GET
/me/
Get User
get_user_me__get → 200
GET
/me/vibe/services
Get Vibe Services
get_vibe_services_me_vibe_services_get → 200
GET
/me/agents/{agent_id}/vibe
Get Vibe Agent Prompt
get_vibe_agent_prompt_me_agents__agent_id__vibe_get 2 params → 200422
GET
/me/vip
Fetch Redemption Count
fetch_redemption_count_me_vip_get → 200400
POST
/me/vip
Redeem Code
redeem_code_me_vip_post body → 200400422
GET
/me/mcp-registry/servers
Search Mcp Servers
search_mcp_servers_me_mcp_registry_servers_get 1 param → 200502422
GET
/me/mcp-servers
Get Mcp Servers
get_mcp_servers_me_mcp_servers_get → 200500
GET
/me/mcp-servers/details
Get Smithery Mcp Server Details
get_smithery_mcp_server_details_me_mcp_servers_details_get 1 param → 200400404500422

Schemas 72

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

DailyEarnings
object
2 properties 2 required
AgentThemePreferenceUpsertRequest
object
1 property 1 required
AgentStudioChatCreate
object
5 properties 3 required
AgentFileListResponse
object
API response wrapper for multiple files
1 property 1 required
UserWithTier
object
User with tier
5 properties 3 required
AgentSubscriptionListResponse
object
1 property 1 required
ScheduleUpdateRequest
object
6 properties 1 required
VipCodeRedeemed
object
1 property 1 required
VipCodeRedemptionCount
object
2 properties 2 required
AgentRequest
object
17 properties 1 required
StripeSession
object
Stripe Session
2 properties 2 required
AgentStudioChat
object
10 properties 7 required
TransferAgentRequest
object
1 property 1 required
MCPServerConnection
object
3 properties 1 required
RunVolumeRow
object
7 properties 7 required
VibeCoderPromptResponse
object
Vibe Coder Response
2 properties 2 required
AgentRunBreakdownRow
object
9 properties 9 required
UpsellDescription
object
2 properties 2 required
ToolExecutionLogsResponse
object
Tool Execution Log Response
2 properties 2 required
AgentFileModel
object
Full model with database fields (ORM model)
10 properties 6 required
VipCodeRequest
object
1 property 1 required
ApiKeyCreate
object
API Key Create
1 property 1 required
AgentRunMetricsResponse
object
10 properties 10 required
AgentRunMetricsSummary
object
6 properties 6 required
UserFeedbackRequest
object
1 property 1 required
ChatVisibility
string
AgentRunLog
object
8 properties 3 required
AgentRunTrendPoint
object
4 properties 4 required
StripeSessionRequest
object
Stripe Session
5 properties 4 required
ScheduleRequest
object
5 properties 2 required
VibeCoderListResponse
object
1 property 1 required
ServerWithConnections
object
5 properties 4 required
MonetizationSummary
object
2 properties 2 required
AgentRequestPartial
object
17 properties
AgentRunViewListResponse
object
2 properties 2 required
StripeResponseSuccess
object
Stripe Response Success
1 property 1 required
AgentFilePositionUpdate
object
Request model for batch position updates
2 properties 2 required
MonetizationEarningsResponse
object
1 property 1 required
DailyTotalSubscribers
object
2 properties 2 required
MCPServerTool
object
21 properties 20 required
Schedule
object
14 properties 3 required
ValidationError
object
3 properties 3 required
Service
object
2 properties 2 required
AgentFileResponse
object
API response wrapper for a single file
1 property 1 required
BucketHours
integer
McpServerLog
object
8 properties 8 required
ApiKey
object
API Key
5 properties 4 required
AgentStudioChatUpdate
object
4 properties
RunVolumeResponse
object
1 property 1 required
HTTPValidationError
object
1 property
MonetizationSubscribersResponse
object
1 property 1 required
AgentRunBreakdownResponse
object
1 property 1 required
AgentModel
object
22 properties 2 required
AgentSubscribeResponse
object
1 property 1 required
AgentExecutionCredits
object
5 properties 4 required
AgentListResponse
object
3 properties 3 required
AgentListItem
object
9 properties 2 required
StripeSessionResponse
object
Stripe Session Response
2 properties 2 required
AgentFileCreateRequest
object
Request model for creating a new agent file
6 properties 3 required
CliAuthModel
object
5 properties 1 required
AgentSubscribeRequest
object
2 properties 2 required
ApiKeyHidden
object
API Key Hidden
4 properties 3 required
AgentSubscriptionResponse
object
7 properties 2 required
AgentRunView
object
14 properties 5 required
SlugRequest
object
1 property 1 required
AgentThemePreferenceResponse
object
3 properties 3 required
CliAuthInsertModel
object
1 property
AgentFileBatchPositionRequest
object
Request model for updating positions of multiple files
1 property 1 required
BillingInformationSubscription
object
Billing Information Response
10 properties 3 required
AgentFileUpdateRequest
object
Request model for updating an agent file (all fields optional)
6 properties
ScheduleListResponse
object
1 property 1 required
ToolExecutionLog
object
Tool Execution Log
10 properties 10 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Toolhouse publishes across the network.

Toolhouse Workers API
AE Profile APIs.io
Toolhouse Agent Runs API
AE Profile APIs.io
Toolhouse API Keys API
AE Profile APIs.io
Toolhouse Backoffice API
AE Profile APIs.io
Toolhouse Logs API
AE Profile APIs.io
Toolhouse Metrics API
AE Profile APIs.io
Toolhouse SDK API API
AE Profile APIs.io
#User API
← Back to T APIs
API Details
ID
toolhouse:toolhouse-user-api-api
Base URL
https://agents.toolhouse.ai
Docs
https://docs.toolhouse.ai/toolhouse
Provider
Toolhouse
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=toolhouse-user-api-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/toolhouse-user-api-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Toolhouse User 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.