{"openapi":"3.1.0","info":{"title":"HarnessRouter API","description":"The HarnessRouter API: run a harness (an OpenAI Responses-compatible surface at /v1/responses), attach files, read sessions, turns and produced files, manage harnesses, keys and provider connections. Authenticate with an API key or a login token as a bearer.","version":"1"},"paths":{"/v1/uhp":{"get":{"summary":"Discover the protocol version and what this server supports","operationId":"uhp_discovery_v1_uhp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Uhp Discovery V1 Uhp Get"}}}}}}},"/v1/traces":{"get":{"summary":"List task traces, newest first","operationId":"list_traces_v1_traces_get","parameters":[{"name":"org","in":"query","required":true,"schema":{"type":"string","title":"Org"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","default":"","title":"Cursor"}},{"name":"member","in":"query","required":false,"schema":{"type":"string","default":"","title":"Member"}},{"name":"harness","in":"query","required":false,"schema":{"type":"string","default":"","title":"Harness"}},{"name":"workspace","in":"query","required":false,"schema":{"type":"string","default":"","title":"Workspace"}},{"name":"workspace_default","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Workspace Default"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response List Traces V1 Traces Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions":{"get":{"summary":"List sessions, newest first","operationId":"list_sessions_v1_sessions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","default":"","title":"Cursor"}},{"name":"harness","in":"query","required":false,"schema":{"type":"string","default":"","title":"Harness"}},{"name":"member","in":"query","required":false,"schema":{"type":"string","default":"","title":"Member"}},{"name":"task_ref","in":"query","required":false,"schema":{"type":"string","default":"","title":"Task Ref"}},{"name":"harness_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Harness Id"}},{"name":"workspace","in":"query","required":false,"schema":{"type":"string","default":"","title":"Workspace"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"","title":"Status"}},{"name":"since","in":"query","required":false,"schema":{"type":"string","default":"","title":"Since"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response List Sessions V1 Sessions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}":{"get":{"summary":"Get a session","operationId":"session_detail_v1_sessions__sid__get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Session Detail V1 Sessions  Sid  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"summary":"Rename a session","operationId":"patch_session_v1_sessions__sid__patch","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Patch Session V1 Sessions  Sid  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete a session and everything it produced","operationId":"delete_trace_v1_sessions__sid__delete","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Delete Trace V1 Sessions  Sid  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}/cancel":{"post":{"summary":"Stop a session's running turn","operationId":"cancel_session_v1_sessions__sid__cancel_post","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Cancel Session V1 Sessions  Sid  Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/traces/{sid}":{"get":{"summary":"Get a session's trace summary","operationId":"get_trace_v1_traces__sid__get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Trace V1 Traces  Sid  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete a session and everything it produced","operationId":"delete_trace_v1_traces__sid__delete","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Delete Trace V1 Traces  Sid  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/traces/{sid}/events":{"get":{"summary":"Get one part of a session's trace events","operationId":"get_trace_events_v1_traces__sid__events_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}},{"name":"chunk","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Chunk"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/traces/{sid}/all":{"get":{"summary":"Get all of a session's trace events","operationId":"get_trace_all_v1_traces__sid__all_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}},{"name":"compact","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Compact"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/storage":{"get":{"summary":"Get how much storage your workspaces use","operationId":"org_storage_v1_storage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Org Storage V1 Storage Get"}}}}}}},"/v1/integrations":{"get":{"summary":"List your provider connections","operationId":"org_integrations_get_v1_integrations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Org Integrations Get V1 Integrations Get"}}}}}},"put":{"summary":"Save your provider connections","operationId":"org_integrations_put_v1_integrations_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationsBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Org Integrations Put V1 Integrations Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/integrations/restore":{"post":{"summary":"Restore a removed provider connection","operationId":"org_integrations_restore_v1_integrations_restore_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Org Integrations Restore V1 Integrations Restore Post"}}}}}}},"/v1/integrations/{name}/microsoft-sign-in":{"post":{"summary":"Start a person's Microsoft sign in for a connection","operationId":"entra_person_start_v1_integrations__name__microsoft_sign_in_post","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Entra Person Start V1 Integrations  Name  Microsoft Sign In Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Sign yourself out of a connection's Microsoft sign in","operationId":"entra_person_sign_out_v1_integrations__name__microsoft_sign_in_delete","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Entra Person Sign Out V1 Integrations  Name  Microsoft Sign In Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/integrations/{name}/microsoft-people":{"get":{"summary":"List who has signed in with Microsoft for a connection","operationId":"entra_people_get_v1_integrations__name__microsoft_people_get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Entra People Get V1 Integrations  Name  Microsoft People Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/responses":{"post":{"summary":"Run a turn (OpenAI Responses compatible)","operationId":"create_response_v1_responses_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/harnesses/{harness_id}/events":{"get":{"summary":"Stream live events for a harness's sessions","operationId":"harness_events_v1_harnesses__harness_id__events_get","parameters":[{"name":"harness_id","in":"path","required":true,"schema":{"type":"string","title":"Harness Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/responses/{response_id}":{"get":{"summary":"Get a response","operationId":"get_response_v1_responses__response_id__get","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete a response","operationId":"delete_response_v1_responses__response_id__delete","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}/turns":{"get":{"summary":"Get a session's conversation, oldest first","operationId":"session_turns_v1_sessions__sid__turns_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Session Turns V1 Sessions  Sid  Turns Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}/share":{"post":{"summary":"Share a session as a page others can read, or stop sharing it","operationId":"set_session_share_v1_sessions__sid__share_post","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ShareBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Set Session Share V1 Sessions  Sid  Share Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Stop sharing a session","operationId":"revoke_session_share_v1_sessions__sid__share_delete","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Revoke Session Share V1 Sessions  Sid  Share Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Get whether a session is shared","operationId":"get_session_share_v1_sessions__sid__share_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Session Share V1 Sessions  Sid  Share Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/responses/{response_id}/input_items":{"get":{"summary":"List a response's input items","operationId":"list_input_items_v1_responses__response_id__input_items_get","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","default":"asc","title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/responses/{response_id}/cancel":{"post":{"summary":"Cancel a response's running turn","operationId":"cancel_response_v1_responses__response_id__cancel_post","parameters":[{"name":"response_id","in":"path","required":true,"schema":{"type":"string","title":"Response Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files":{"post":{"summary":"Upload a file for later turns","operationId":"upload_file_v1_files_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_file_v1_files_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{fid}":{"delete":{"summary":"Delete an uploaded file","operationId":"delete_file_v1_files__fid__delete","parameters":[{"name":"fid","in":"path","required":true,"schema":{"type":"string","title":"Fid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Delete File V1 Files  Fid  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}/files":{"get":{"summary":"List the files in a session's workspace","operationId":"session_workspace_files_v1_sessions__sid__files_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}},{"name":"changed","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Changed"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Session Workspace Files V1 Sessions  Sid  Files Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}/files/archive":{"get":{"summary":"Download a session's files as one zip","operationId":"session_files_archive_v1_sessions__sid__files_archive_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}},{"name":"changed","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Changed"}},{"name":"files","in":"query","required":false,"schema":{"type":"string","default":"","title":"Files"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}/files/{path}":{"get":{"summary":"Read one file from a session's workspace","operationId":"read_session_file_v1_sessions__sid__files__path__get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"summary":"Write one file into a session's workspace","operationId":"write_session_file_v1_sessions__sid__files__path__put","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceWrite"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Write Session File V1 Sessions  Sid  Files  Path  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/containers/{container_id}/files/{file_id}/content":{"get":{"summary":"Download a file a session produced","operationId":"container_file_content_v1_containers__container_id__files__file_id__content_get","parameters":[{"name":"container_id","in":"path","required":true,"schema":{"type":"string","title":"Container Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/containers/{container_id}/files/{file_id}/pdf":{"get":{"summary":"Get a PDF preview of an office file","operationId":"container_file_pdf_v1_containers__container_id__files__file_id__pdf_get","parameters":[{"name":"container_id","in":"path","required":true,"schema":{"type":"string","title":"Container Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance":{"get":{"summary":"Get what your organization has left to spend","operationId":"balance_v1_balance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Balance V1 Balance Get"}}}}}}},"/v1/connect":{"post":{"summary":"Start pairing your own instance with your account","operationId":"connect_create_v1_connect_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Connect Create V1 Connect Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connect/{code}/info":{"get":{"summary":"Get a pairing's details","operationId":"connect_info_v1_connect__code__info_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Connect Info V1 Connect  Code  Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connect/{code}/fulfil":{"post":{"summary":"Hand a pairing its key","operationId":"connect_fulfil_v1_connect__code__fulfil_post","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectFulfilBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Connect Fulfil V1 Connect  Code  Fulfil Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/connect/{code}":{"get":{"summary":"Wait for a pairing's key","operationId":"connect_poll_v1_connect__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp-secrets/{ref}":{"put":{"summary":"Store a tool token","operationId":"put_mcp_secret_public_v1_mcp_secrets__ref__put","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpSecretBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Put Mcp Secret Public V1 Mcp Secrets  Ref  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete a stored tool token","operationId":"delete_mcp_secret_public_v1_mcp_secrets__ref__delete","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Delete Mcp Secret Public V1 Mcp Secrets  Ref  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp-test":{"post":{"summary":"Test a tool server connection","operationId":"test_mcp_public_v1_mcp_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpTestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Test Mcp Public V1 Mcp Test Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/harnesses":{"get":{"summary":"List harnesses","operationId":"list_harnesses_public_v1_harnesses_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response List Harnesses Public V1 Harnesses Get"}}}}}},"post":{"summary":"Create a harness","operationId":"create_harness_public_v1_harnesses_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HarnessBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Create Harness Public V1 Harnesses Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/harnesses/{hid}":{"get":{"summary":"Get a harness","operationId":"get_harness_public_v1_harnesses__hid__get","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Harness Public V1 Harnesses  Hid  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"summary":"Update a harness, or create it with this id","operationId":"update_harness_public_v1_harnesses__hid__put","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HarnessBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Update Harness Public V1 Harnesses  Hid  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete a harness","operationId":"delete_harness_public_v1_harnesses__hid__delete","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Delete Harness Public V1 Harnesses  Hid  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kits":{"get":{"summary":"List kits","operationId":"list_kits_v1_kits_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response List Kits V1 Kits Get"}}}}}}},"/v1/kits/{kit_id}/launch":{"post":{"summary":"Launch a kit's harness","operationId":"launch_kit_v1_kits__kit_id__launch_post","parameters":[{"name":"kit_id","in":"path","required":true,"schema":{"type":"string","title":"Kit Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/KitLaunchBody"},{"type":"null"}],"title":"Body In"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Launch Kit V1 Kits  Kit Id  Launch Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bases":{"get":{"summary":"List base harnesses and what each can do","operationId":"list_bases_v1_bases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response List Bases V1 Bases Get"}}}}}}},"/v1/models":{"get":{"summary":"List available models","operationId":"list_models_v1_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response List Models V1 Models Get"}}}}}}},"/v1/harnesses/{hid}/models":{"get":{"summary":"List the models a harness may use","operationId":"get_harness_models_public_v1_harnesses__hid__models_get","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Harness Models Public V1 Harnesses  Hid  Models Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/harnesses/{hid}/skills/{skill_id}/files":{"get":{"summary":"Get one skill's files","operationId":"get_harness_skill_files_public_v1_harnesses__hid__skills__skill_id__files_get","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}},{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Harness Skill Files Public V1 Harnesses  Hid  Skills  Skill Id  Files Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/harnesses/{hid}/plugins/{name}/files":{"get":{"summary":"Get one installed plugin's files","operationId":"get_harness_plugin_files_public_v1_harnesses__hid__plugins__name__files_get","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Harness Plugin Files Public V1 Harnesses  Hid  Plugins  Name  Files Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/harnesses/{hid}/plugin":{"get":{"summary":"Export a harness's tools and skills as a plugin","operationId":"export_harness_plugin_public_v1_harnesses__hid__plugin_get","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Export Harness Plugin Public V1 Harnesses  Hid  Plugin Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me":{"get":{"summary":"Get who this credential acts as, and where its work lands","operationId":"me_public_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Me Public V1 Me Get"}}}}}}},"/v1/arenas":{"get":{"summary":"List arenas","operationId":"list_arenas_v1_arenas_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response List Arenas V1 Arenas Get"}}}}}},"post":{"summary":"Create an arena","operationId":"create_arena_v1_arenas_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArenaBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Create Arena V1 Arenas Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arenas/{aid}":{"get":{"summary":"Get an arena","operationId":"get_arena_v1_arenas__aid__get","parameters":[{"name":"aid","in":"path","required":true,"schema":{"type":"string","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Arena V1 Arenas  Aid  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"summary":"Update an arena","operationId":"update_arena_v1_arenas__aid__put","parameters":[{"name":"aid","in":"path","required":true,"schema":{"type":"string","title":"Aid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArenaBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Update Arena V1 Arenas  Aid  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete an arena (its tasks stay)","operationId":"delete_arena_v1_arenas__aid__delete","parameters":[{"name":"aid","in":"path","required":true,"schema":{"type":"string","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Delete Arena V1 Arenas  Aid  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp-test/database":{"post":{"summary":"Test a database connection","operationId":"test_database_public_v1_mcp_test_database_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseTestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Test Database Public V1 Mcp Test Database Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/harnesses/{hid}/servers/plugs":{"post":{"summary":"Attach your workspace's plugs to a harness","operationId":"attach_plugs_v1_harnesses__hid__servers_plugs_post","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlugsBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Attach Plugs V1 Harnesses  Hid  Servers Plugs Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Detach plugs from a harness","operationId":"detach_plugs_v1_harnesses__hid__servers_plugs_delete","parameters":[{"name":"hid","in":"path","required":true,"schema":{"type":"string","title":"Hid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Detach Plugs V1 Harnesses  Hid  Servers Plugs Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}/browser":{"get":{"summary":"Get a session's browser","operationId":"session_browser_v1_sessions__sid__browser_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Session Browser V1 Sessions  Sid  Browser Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{sid}/browser/control":{"post":{"summary":"Hand a session's browser to a person, or back to the agent","operationId":"session_browser_control_v1_sessions__sid__browser_control_post","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"string","title":"Sid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrowserControlBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Session Browser Control V1 Sessions  Sid  Browser Control Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ArenaBody":{"properties":{"name":{"type":"string","title":"Name","default":""},"columns":{"anyOf":[{"items":{"$ref":"#/components/schemas/ArenaColumnBody"},"type":"array"},{"type":"null"}],"title":"Columns"},"split":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Split"}},"type":"object","title":"ArenaBody"},"ArenaColumnBody":{"properties":{"id":{"type":"string","title":"Id"},"harness_id":{"type":"string","title":"Harness Id"},"harness_name":{"type":"string","title":"Harness Name","default":""},"base_id":{"type":"string","title":"Base Id","default":""},"model":{"type":"string","title":"Model","default":""},"session_id":{"type":"string","title":"Session Id","default":""},"winner":{"type":"boolean","title":"Winner","default":false}},"type":"object","required":["id","harness_id"],"title":"ArenaColumnBody"},"Body_upload_file_v1_files_post":{"properties":{"purpose":{"type":"string","title":"Purpose","default":"user_data"},"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_file_v1_files_post"},"BrowserControlBody":{"properties":{"control":{"type":"string","title":"Control"}},"type":"object","required":["control"],"title":"BrowserControlBody"},"ConnectBody":{"properties":{"instance":{"type":"string","title":"Instance","default":""}},"type":"object","title":"ConnectBody"},"ConnectFulfilBody":{"properties":{"api_key":{"type":"string","title":"Api Key"},"name":{"type":"string","title":"Name","default":""}},"type":"object","required":["api_key"],"title":"ConnectFulfilBody"},"CreateResponseBody":{"properties":{"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"input":{"title":"Input"},"stream":{"type":"boolean","title":"Stream","default":false},"previous_response_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Response Id"},"store":{"type":"boolean","title":"Store","default":true},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"max_output_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Output Tokens"},"background":{"type":"boolean","title":"Background","default":false},"metadata":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadata"},"tools":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Tools"},"include":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Include"},"backend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backend"},"max_step":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Step"},"timeout_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Timeout Seconds"},"max_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Cost Usd"},"reasoning":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Reasoning"}},"type":"object","title":"CreateResponseBody"},"DatabaseTestBody":{"properties":{"engine":{"type":"string","title":"Engine"},"connection_string":{"type":"string","title":"Connection String"}},"type":"object","required":["engine","connection_string"],"title":"DatabaseTestBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HarnessBody":{"properties":{"name":{"type":"string","title":"Name"},"base":{"type":"string","title":"Base"},"base_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Label"},"default_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Model"},"system_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Prompt"},"mcp_servers":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Mcp Servers"},"skills":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Skills"},"plugins":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Plugins"},"disabled_tools":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Disabled Tools"},"max_step":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Step"},"timeout_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Timeout Seconds"},"max_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Cost Usd"},"reasoning_effort":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning Effort"},"engine_member":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Engine Member"},"additional_headers":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Additional Headers"},"env":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Env"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_instance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Instance"},"environment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"}},"type":"object","required":["name","base"],"title":"HarnessBody"},"IntegrationsBody":{"properties":{"integrations":{"items":{"type":"object"},"type":"array","title":"Integrations"},"model_map":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Model Map"},"image_model_map":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Image Model Map"},"chat_model_map":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Chat Model Map"},"media_policy":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Media Policy"}},"type":"object","required":["integrations"],"title":"IntegrationsBody"},"KitDatabaseBody":{"properties":{"engine":{"type":"string","title":"Engine"},"connection_string":{"type":"string","title":"Connection String"},"sample_rows":{"type":"boolean","title":"Sample Rows","default":true}},"type":"object","required":["engine","connection_string"],"title":"KitDatabaseBody","description":"The database a kit reads, and how it connects."},"KitLaunchBody":{"properties":{"base":{"type":"string","title":"Base","default":""},"model":{"type":"string","title":"Model","default":""},"database":{"anyOf":[{"$ref":"#/components/schemas/KitDatabaseBody"},{"type":"null"}]},"harness":{"type":"string","title":"Harness","default":""}},"type":"object","title":"KitLaunchBody","description":"What a kit runs on, and what it runs against."},"McpSecretBody":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"McpSecretBody"},"McpTestBody":{"properties":{"url":{"type":"string","title":"Url"},"auth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth"}},"type":"object","required":["url"],"title":"McpTestBody"},"PlugsBody":{"properties":{"plugs":{"items":{"type":"string"},"type":"array","title":"Plugs"},"tools":{"anyOf":[{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Tools"},"apps":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Apps"},"lazy":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lazy"},"pinned":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pinned"}},"type":"object","required":["plugs"],"title":"PlugsBody"},"SessionPatch":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"}},"type":"object","title":"SessionPatch","description":"The parts of a session you can edit: its title."},"ShareBody":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","title":"ShareBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WorkspaceWrite":{"properties":{"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"content_b64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content B64"}},"type":"object","title":"WorkspaceWrite"}}},"servers":[{"url":"https://api.harnessrouter.ai"}]}