{"openapi":"3.1.0","info":{"title":"pulse-api • v0","description":"Real-time audio intelligence backend for Pulse macOS app.","contact":{"name":"Nfrax","email":"ali@nfrax.com"},"license":{"name":"MIT"},"version":"0.1.0"},"paths":{"/advise":{"post":{"tags":["Advise"],"summary":"Advise","description":"One-shot text-based advice endpoint (no audio stream needed).","operationId":"advise","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextAdviceRequest"}}},"required":true,"description":"Request body for POST /advise."},"responses":{"200":{"description":"Advise success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvisorResponse"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//advise'"},{"lang":"bash","label":"httpie","source":"http POST '//advise'"}]}},"/title":{"post":{"tags":["Advise"],"summary":"Generate Title","description":"Generate a short 2-3 word conversation title with an emoji.","operationId":"generate_title","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TitleRequest"}}},"required":true,"description":"Request body for POST /title."},"responses":{"200":{"description":"Generate Title success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TitleResponse"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//title'"},{"lang":"bash","label":"httpie","source":"http POST '//title'"}]}},"/workspaces/{workspace_id}/automations":{"post":{"tags":["Automations"],"summary":"Create Automation","description":"Create a new automation in the given workspace.","operationId":"create_automation","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutomationCreate"}}},"description":"Request body for POST /workspaces/{workspace_id}/automations."},"responses":{"201":{"description":"Create Automation success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutomationRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//workspaces/{workspace_id}/automations'"},{"lang":"bash","label":"httpie","source":"http POST '//workspaces/{workspace_id}/automations'"}]},"get":{"tags":["Workspaces"],"summary":"List Automations","description":"List automations for a workspace.","operationId":"list_automations","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Automations success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AutomationRead"},"title":"Response List Automations"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/automations'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/automations'"}]}},"/automations/{automation_id}":{"get":{"tags":["Automations"],"summary":"Get Automation","description":"Get a single automation by ID.","operationId":"get_automation","parameters":[{"name":"automation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Automation Id"},"description":"automation_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Automation success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutomationRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//automations/{automation_id}'"},{"lang":"bash","label":"httpie","source":"http GET '//automations/{automation_id}'"}]},"patch":{"tags":["Automations"],"summary":"Update Automation","description":"Update an automation's metadata, script, schedule, or enabled state.","operationId":"update_automation","parameters":[{"name":"automation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Automation Id"},"description":"automation_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutomationUpdate"}}},"description":"Request body for PATCH /automations/{automation_id}."},"responses":{"200":{"description":"Update Automation success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutomationRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PATCH '//automations/{automation_id}'"},{"lang":"bash","label":"httpie","source":"http PATCH '//automations/{automation_id}'"}]},"delete":{"tags":["Automations"],"summary":"Delete Automation","description":"Delete an automation, remove any schedule, and remove its script file.","operationId":"delete_automation","parameters":[{"name":"automation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Automation Id"},"description":"automation_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//automations/{automation_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//automations/{automation_id}'"}]}},"/automations/{automation_id}/run":{"post":{"tags":["Automations"],"summary":"Run Automation","description":"Trigger an automation to run immediately, independent of its schedule.","operationId":"run_automation","parameters":[{"name":"automation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Automation Id"},"description":"automation_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Run Automation success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutomationRunResult"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//automations/{automation_id}/run'"},{"lang":"bash","label":"httpie","source":"http POST '//automations/{automation_id}/run'"}]}},"/automations/{automation_id}/runs":{"get":{"tags":["Automations"],"summary":"List Automation Runs","description":"List recent runs for an automation, newest first.","operationId":"list_automation_runs","parameters":[{"name":"automation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Automation Id"},"description":"automation_id parameter."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"},"description":"limit parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Automation Runs success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AutomationRunRead"},"title":"Response List Automation Runs"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//automations/{automation_id}/runs'"},{"lang":"bash","label":"httpie","source":"http GET '//automations/{automation_id}/runs'"}]}},"/workspaces/{workspace_id}/connections":{"get":{"tags":["Connections"],"summary":"List Connections","operationId":"list_connections","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Connections success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionRead"},"title":"Response List Connections"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /workspaces/{workspace_id}/connections.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/connections'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/connections'"}]},"post":{"tags":["Connections"],"summary":"Create Connection","operationId":"create_connection","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionCreate"}}},"description":"Request body for POST /workspaces/{workspace_id}/connections."},"responses":{"201":{"description":"Create Connection success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /workspaces/{workspace_id}/connections.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//workspaces/{workspace_id}/connections'"},{"lang":"bash","label":"httpie","source":"http POST '//workspaces/{workspace_id}/connections'"}]}},"/connections/{connection_id}":{"patch":{"tags":["Connections"],"summary":"Update Connection","operationId":"update_connection","parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"},"description":"connection_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionUpdate"}}},"description":"Request body for PATCH /connections/{connection_id}."},"responses":{"200":{"description":"Update Connection success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"PATCH /connections/{connection_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PATCH '//connections/{connection_id}'"},{"lang":"bash","label":"httpie","source":"http PATCH '//connections/{connection_id}'"}]},"delete":{"tags":["Connections"],"summary":"Delete Connection","operationId":"delete_connection","parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"},"description":"connection_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"DELETE /connections/{connection_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//connections/{connection_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//connections/{connection_id}'"}]}},"/connections/{connection_id}/sync":{"post":{"tags":["Connections"],"summary":"Sync Connection Tools","operationId":"sync_connection_tools","parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"},"description":"connection_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Sync Connection Tools success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionSyncResult"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /connections/{connection_id}/sync.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//connections/{connection_id}/sync'"},{"lang":"bash","label":"httpie","source":"http POST '//connections/{connection_id}/sync'"}]}},"/connections/{connection_id}/tools/{tool_id}":{"patch":{"tags":["Connections"],"summary":"Update Connection Tool","operationId":"update_connection_tool","parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"},"description":"connection_id parameter."},{"name":"tool_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Tool Id"},"description":"tool_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionToolUpdate"}}},"description":"Request body for PATCH /connections/{connection_id}/tools/{tool_id}."},"responses":{"200":{"description":"Update Connection Tool success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionToolRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"PATCH /connections/{connection_id}/tools/{tool_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PATCH '//connections/{connection_id}/tools/{tool_id}'"},{"lang":"bash","label":"httpie","source":"http PATCH '//connections/{connection_id}/tools/{tool_id}'"}]}},"/conversations":{"post":{"tags":["Conversations"],"summary":"Create Conversation","description":"Create or upsert a conversation.\n\nIf ``body.id`` is provided and already exists, the row is updated instead\nof creating a duplicate (upsert semantics).  This supports the common\npattern where the frontend assigns a UUID up-front and then saves\nincrementally as new messages arrive.","operationId":"create_conversation","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationCreate"}}},"required":true,"description":"Request body for POST /conversations."},"responses":{"201":{"description":"Create Conversation success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//conversations'"},{"lang":"bash","label":"httpie","source":"http POST '//conversations'"}]}},"/conversations/{conversation_id}":{"get":{"tags":["Conversations"],"summary":"Get Conversation","operationId":"get_conversation","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"},"description":"conversation_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Conversation success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /conversations/{conversation_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//conversations/{conversation_id}'"},{"lang":"bash","label":"httpie","source":"http GET '//conversations/{conversation_id}'"}]},"patch":{"tags":["Conversations"],"summary":"Update Conversation","operationId":"update_conversation","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"},"description":"conversation_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationUpdate"}}},"description":"Request body for PATCH /conversations/{conversation_id}."},"responses":{"200":{"description":"Update Conversation success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"PATCH /conversations/{conversation_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PATCH '//conversations/{conversation_id}'"},{"lang":"bash","label":"httpie","source":"http PATCH '//conversations/{conversation_id}'"}]},"delete":{"tags":["Conversations"],"summary":"Delete Conversation","operationId":"delete_conversation","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"},"description":"conversation_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"DELETE /conversations/{conversation_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//conversations/{conversation_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//conversations/{conversation_id}'"}]}},"/conversations/{conversation_id}/files":{"get":{"tags":["Conversations"],"summary":"List Conversation Files","description":"Return the workspace file tree for a conversation.\n\nResolves the on-disk working directory for the task associated with this\nconversation and returns both the resolved root path and the recursive\nfile listing. The tree is empty when the directory does not exist.","operationId":"list_conversation_files","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"},"description":"conversation_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Conversation Files success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationFilesRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//conversations/{conversation_id}/files'"},{"lang":"bash","label":"httpie","source":"http GET '//conversations/{conversation_id}/files'"}]}},"/attachments/{attachment_id}/content":{"get":{"tags":["Conversations"],"summary":"Get Attachment Content","description":"Download attachment bytes for an attachment owned by the current user.","operationId":"get_attachment_content","parameters":[{"name":"attachment_id","in":"path","required":true,"schema":{"type":"string","title":"Attachment Id"},"description":"attachment_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Attachment Content success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//attachments/{attachment_id}/content'"},{"lang":"bash","label":"httpie","source":"http GET '//attachments/{attachment_id}/content'"}]}},"/skills-marketplace/search":{"get":{"tags":["Skills"],"summary":"Search Marketplace","description":"Search the skills marketplace with server-side pagination.","operationId":"search_marketplace","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"description":"Search query for marketplace skills","title":"Q"},"description":"Search query for marketplace skills"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Per Page"},"description":"Results per page"},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Search Marketplace success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedSkillsResponse"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//skills-marketplace/search'"},{"lang":"bash","label":"httpie","source":"http GET '//skills-marketplace/search'"}]}},"/skills-marketplace/featured":{"get":{"tags":["Skills"],"summary":"Featured Marketplace","description":"Return popular skills across common categories (fetched concurrently).","operationId":"featured_marketplace","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":20,"title":"Per Page"},"description":"Results per page"},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Featured Marketplace success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedSkillsResponse"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//skills-marketplace/featured'"},{"lang":"bash","label":"httpie","source":"http GET '//skills-marketplace/featured'"}]}},"/skills-marketplace/content":{"get":{"tags":["Skills"],"summary":"Get Marketplace Skill Content","description":"Fetch the SKILL.md content for a marketplace skill from GitHub.","operationId":"get_marketplace_skill_content","parameters":[{"name":"source","in":"query","required":true,"schema":{"type":"string","description":"Skill source (owner/repo)","title":"Source"},"description":"Skill source (owner/repo)"},{"name":"skill_id","in":"query","required":true,"schema":{"type":"string","description":"Skill identifier","title":"Skill Id"},"description":"Skill identifier"},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Marketplace Skill Content success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceSkillContent"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//skills-marketplace/content'"},{"lang":"bash","label":"httpie","source":"http GET '//skills-marketplace/content'"}]}},"/skills-marketplace/publish":{"post":{"tags":["Skills"],"summary":"Publish Skill","description":"Publish a skill to the shared GitHub skills repo.\n\nFollows the Agent Skills open standard (agentskills.io/specification).\nPushes ``skills/<skill_id>/SKILL.md`` (plus any additional files) to the\nconfigured repo via the GitHub Contents API.\n\nThe caller's user ID is embedded as ``metadata.owner_id`` in the YAML\nfrontmatter.  On updates, the existing owner_id must match the caller.\nSystem skills cannot be overwritten.","operationId":"publish_skill","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishRequest"}}},"required":true,"description":"Request body for POST /skills-marketplace/publish."},"responses":{"201":{"description":"Publish Skill success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishResponse"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//skills-marketplace/publish'"},{"lang":"bash","label":"httpie","source":"http POST '//skills-marketplace/publish'"}]}},"/skills-marketplace/unpublish":{"delete":{"tags":["Skills"],"summary":"Unpublish Skill","description":"Remove a published skill from the shared GitHub skills repo.\n\nOnly the original owner (matching ``metadata.owner_id``) can delete.\nSystem skills cannot be removed.","operationId":"unpublish_skill","parameters":[{"name":"skill_id","in":"query","required":true,"schema":{"type":"string","description":"Skill slug to remove from the marketplace","title":"Skill Id"},"description":"Skill slug to remove from the marketplace"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//skills-marketplace/unpublish'"},{"lang":"bash","label":"httpie","source":"http DELETE '//skills-marketplace/unpublish'"}]}},"/projects/{project_id}/notes":{"get":{"tags":["Notes"],"summary":"List Notes","operationId":"list_notes","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"},"description":"project_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Notes success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NoteListItem"},"title":"Response List Notes"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /projects/{project_id}/notes.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//projects/{project_id}/notes'"},{"lang":"bash","label":"httpie","source":"http GET '//projects/{project_id}/notes'"}]},"post":{"tags":["Notes"],"summary":"Create Note","operationId":"create_note","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"},"description":"project_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteCreate"}}},"description":"Request body for POST /projects/{project_id}/notes."},"responses":{"201":{"description":"Create Note success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /projects/{project_id}/notes.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//projects/{project_id}/notes'"},{"lang":"bash","label":"httpie","source":"http POST '//projects/{project_id}/notes'"}]}},"/projects/{project_id}/notes/cover-image":{"post":{"tags":["Notes"],"summary":"Generate Note Cover Image","operationId":"generate_note_cover_image","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"},"description":"project_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteCoverImageRequest"}}},"description":"Request body for POST /projects/{project_id}/notes/cover-image."},"responses":{"200":{"description":"Generate Note Cover Image success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteCoverImageResponse"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /projects/{project_id}/notes/cover-image.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//projects/{project_id}/notes/cover-image'"},{"lang":"bash","label":"httpie","source":"http POST '//projects/{project_id}/notes/cover-image'"}]}},"/notes/{note_id}":{"get":{"tags":["Notes"],"summary":"Get Note","operationId":"get_note","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Note success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /notes/{note_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//notes/{note_id}'"},{"lang":"bash","label":"httpie","source":"http GET '//notes/{note_id}'"}]},"patch":{"tags":["Notes"],"summary":"Update Note","operationId":"update_note","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteUpdate"}}},"description":"Request body for PATCH /notes/{note_id}."},"responses":{"200":{"description":"Update Note success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"PATCH /notes/{note_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PATCH '//notes/{note_id}'"},{"lang":"bash","label":"httpie","source":"http PATCH '//notes/{note_id}'"}]},"delete":{"tags":["Notes"],"summary":"Delete Note","operationId":"delete_note","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"DELETE /notes/{note_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//notes/{note_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//notes/{note_id}'"}]}},"/notes/{note_id}/outline":{"get":{"tags":["Notes"],"summary":"Get Note Outline","operationId":"get_note_outline","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Note Outline success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NoteOutlineItem"},"title":"Response Get Note Outline"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /notes/{note_id}/outline.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//notes/{note_id}/outline'"},{"lang":"bash","label":"httpie","source":"http GET '//notes/{note_id}/outline'"}]}},"/notes/{note_id}/targets/resolve":{"post":{"tags":["Notes"],"summary":"Resolve Note Target Endpoint","operationId":"resolve_note_target_endpoint","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteTargetQuery"}}},"description":"Request body for POST /notes/{note_id}/targets/resolve."},"responses":{"200":{"description":"Resolve Note Target Endpoint success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteTarget"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /notes/{note_id}/targets/resolve.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//notes/{note_id}/targets/resolve'"},{"lang":"bash","label":"httpie","source":"http POST '//notes/{note_id}/targets/resolve'"}]}},"/notes/{note_id}/patch":{"post":{"tags":["Notes"],"summary":"Patch Note","operationId":"patch_note","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotePatchApplyRequest"}}},"description":"Request body for POST /notes/{note_id}/patch."},"responses":{"200":{"description":"Patch Note success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /notes/{note_id}/patch.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//notes/{note_id}/patch'"},{"lang":"bash","label":"httpie","source":"http POST '//notes/{note_id}/patch'"}]}},"/notes/{note_id}/revisions":{"get":{"tags":["Notes"],"summary":"List Note Revisions","operationId":"list_note_revisions","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Note Revisions success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NoteRevisionRead"},"title":"Response List Note Revisions"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /notes/{note_id}/revisions.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//notes/{note_id}/revisions'"},{"lang":"bash","label":"httpie","source":"http GET '//notes/{note_id}/revisions'"}]}},"/notes/{note_id}/revisions/{revision_id}":{"get":{"tags":["Notes"],"summary":"Get Note Revision","operationId":"get_note_revision","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"name":"revision_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Revision Id"},"description":"revision_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Note Revision success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRevisionRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /notes/{note_id}/revisions/{revision_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//notes/{note_id}/revisions/{revision_id}'"},{"lang":"bash","label":"httpie","source":"http GET '//notes/{note_id}/revisions/{revision_id}'"}]}},"/notes/{note_id}/revisions/{revision_id}/restore":{"post":{"tags":["Notes"],"summary":"Restore Note Revision","operationId":"restore_note_revision","parameters":[{"name":"note_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Note Id"},"description":"note_id parameter."},{"name":"revision_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Revision Id"},"description":"revision_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRestore"}}},"description":"Request body for POST /notes/{note_id}/revisions/{revision_id}/restore."},"responses":{"200":{"description":"Restore Note Revision success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /notes/{note_id}/revisions/{revision_id}/restore.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//notes/{note_id}/revisions/{revision_id}/restore'"},{"lang":"bash","label":"httpie","source":"http POST '//notes/{note_id}/revisions/{revision_id}/restore'"}]}},"/workspaces/{workspace_id}/notes/search":{"get":{"tags":["Notes"],"summary":"Search Notes","operationId":"search_notes","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Q"},"description":"q parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Search Notes success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NoteListItem"},"title":"Response Search Notes"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /workspaces/{workspace_id}/notes/search.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/notes/search'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/notes/search'"}]}},"/workspaces/{workspace_id}/projects":{"get":{"tags":["Projects"],"summary":"List Projects","operationId":"list_projects","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Projects success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProjectRead"},"title":"Response List Projects"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /workspaces/{workspace_id}/projects.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/projects'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/projects'"}]},"post":{"tags":["Projects"],"summary":"Create Project","operationId":"create_project","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectCreate"}}},"description":"Request body for POST /workspaces/{workspace_id}/projects."},"responses":{"201":{"description":"Create Project success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /workspaces/{workspace_id}/projects.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//workspaces/{workspace_id}/projects'"},{"lang":"bash","label":"httpie","source":"http POST '//workspaces/{workspace_id}/projects'"}]}},"/workspaces/{workspace_id}/projects/{project_id}":{"get":{"tags":["Projects"],"summary":"Get Project","operationId":"get_project","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"},"description":"project_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Project success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /workspaces/{workspace_id}/projects/{project_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/projects/{project_id}'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/projects/{project_id}'"}]},"patch":{"tags":["Projects"],"summary":"Update Project","operationId":"update_project","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"},"description":"project_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectUpdate"}}},"description":"Request body for PATCH /workspaces/{workspace_id}/projects/{project_id}."},"responses":{"200":{"description":"Update Project success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"PATCH /workspaces/{workspace_id}/projects/{project_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PATCH '//workspaces/{workspace_id}/projects/{project_id}'"},{"lang":"bash","label":"httpie","source":"http PATCH '//workspaces/{workspace_id}/projects/{project_id}'"}]},"delete":{"tags":["Projects"],"summary":"Delete Project","operationId":"delete_project","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Project Id"},"description":"project_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"DELETE /workspaces/{workspace_id}/projects/{project_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//workspaces/{workspace_id}/projects/{project_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//workspaces/{workspace_id}/projects/{project_id}'"}]}},"/mcp-registry":{"get":{"tags":["Connections"],"summary":"List Registry","description":"Return curated recommended Connections backed by MCP servers.","operationId":"list_registry","responses":{"200":{"description":"List Registry success","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/RegistryEntry"},"type":"array","title":"Response List Registry"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ValidationError"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"parameters":[{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//mcp-registry'"},{"lang":"bash","label":"httpie","source":"http GET '//mcp-registry'"}]}},"/mcp-registry/search":{"get":{"tags":["Connections"],"summary":"Search Registry","description":"Search recommended Connections by name and description.","operationId":"search_registry","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Search query for recommended Connections","title":"Q"},"description":"Search query for recommended Connections"},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Search Registry success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RegistryEntry"},"title":"Response Search Registry"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//mcp-registry/search'"},{"lang":"bash","label":"httpie","source":"http GET '//mcp-registry/search'"}]}},"/workspaces/{workspace_id}/skills":{"get":{"tags":["Skills"],"summary":"List Skills","operationId":"list_skills","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Skills success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SkillListRead"},"title":"Response List Skills"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /workspaces/{workspace_id}/skills.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/skills'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/skills'"}]},"post":{"tags":["Skills"],"summary":"Create Skill","operationId":"create_skill","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillCreate"}}},"description":"Request body for POST /workspaces/{workspace_id}/skills."},"responses":{"201":{"description":"Create Skill success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /workspaces/{workspace_id}/skills.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//workspaces/{workspace_id}/skills'"},{"lang":"bash","label":"httpie","source":"http POST '//workspaces/{workspace_id}/skills'"}]}},"/skills/{skill_id}":{"get":{"tags":["Skills"],"summary":"Get Skill","operationId":"get_skill","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"},"description":"skill_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Skill success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"description":"GET /skills/{skill_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//skills/{skill_id}'"},{"lang":"bash","label":"httpie","source":"http GET '//skills/{skill_id}'"}]},"patch":{"tags":["Skills"],"summary":"Update Skill","operationId":"update_skill","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"},"description":"skill_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillUpdate"}}},"description":"Request body for PATCH /skills/{skill_id}."},"responses":{"200":{"description":"Update Skill success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"PATCH /skills/{skill_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PATCH '//skills/{skill_id}'"},{"lang":"bash","label":"httpie","source":"http PATCH '//skills/{skill_id}'"}]},"delete":{"tags":["Skills"],"summary":"Delete Skill","operationId":"delete_skill","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"},"description":"skill_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"DELETE /skills/{skill_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//skills/{skill_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//skills/{skill_id}'"}]}},"/skills/{skill_id}/documents":{"post":{"tags":["Skills"],"summary":"Add Skill Document","operationId":"add_skill_document","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"},"description":"skill_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillDocumentCreate"}}},"description":"Request body for POST /skills/{skill_id}/documents."},"responses":{"201":{"description":"Add Skill Document success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillDocumentRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /skills/{skill_id}/documents.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//skills/{skill_id}/documents'"},{"lang":"bash","label":"httpie","source":"http POST '//skills/{skill_id}/documents'"}]}},"/skills/{skill_id}/documents/{doc_id}":{"delete":{"tags":["Skills"],"summary":"Delete Skill Document","operationId":"delete_skill_document","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"},"description":"skill_id parameter."},{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"},"description":"doc_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"DELETE /skills/{skill_id}/documents/{doc_id}.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//skills/{skill_id}/documents/{doc_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//skills/{skill_id}/documents/{doc_id}'"}]}},"/skills/{skill_id}/run":{"post":{"tags":["Skills"],"summary":"Run Skill","operationId":"run_skill","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Skill Id"},"description":"skill_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillRunRequest"}}},"description":"Request body for POST /skills/{skill_id}/run."},"responses":{"200":{"description":"Run Skill success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillRunResult"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"description":"POST /skills/{skill_id}/run.","x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//skills/{skill_id}/run'"},{"lang":"bash","label":"httpie","source":"http POST '//skills/{skill_id}/run'"}]}},"/workspaces":{"get":{"tags":["Workspaces"],"summary":"List Workspaces","description":"List all workspaces belonging to the authenticated user.\n\nIf the user has no workspaces, a default \"Personal\" workspace is created\nautomatically so that there is always at least one workspace.","operationId":"list_workspaces","responses":{"200":{"description":"List Workspaces success","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WorkspaceRead"},"type":"array","title":"Response List Workspaces"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/ValidationError"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"parameters":[{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces'"}]},"post":{"tags":["Workspaces"],"summary":"Create Workspace","description":"Create a new workspace.","operationId":"create_workspace","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceCreate"}}},"required":true,"description":"Request body for POST /workspaces."},"responses":{"201":{"description":"Create Workspace success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST '//workspaces'"},{"lang":"bash","label":"httpie","source":"http POST '//workspaces'"}]}},"/workspaces/{workspace_id}":{"get":{"tags":["Workspaces"],"summary":"Get Workspace","description":"Get a single workspace by ID.","operationId":"get_workspace","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Workspace success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}'"}]},"patch":{"tags":["Workspaces"],"summary":"Update Workspace","description":"Update workspace metadata and instruction fields.","operationId":"update_workspace","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceUpdate"}}},"description":"Request body for PATCH /workspaces/{workspace_id}."},"responses":{"200":{"description":"Update Workspace success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceRead"}}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PATCH '//workspaces/{workspace_id}'"},{"lang":"bash","label":"httpie","source":"http PATCH '//workspaces/{workspace_id}'"}]},"delete":{"tags":["Workspaces"],"summary":"Delete Workspace","description":"Delete a workspace and all of its contents.\n\nReturns 409 if the user only has one workspace — every user must retain at\nleast one workspace at all times.","operationId":"delete_workspace","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//workspaces/{workspace_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//workspaces/{workspace_id}'"}]}},"/workspaces/{workspace_id}/instructions":{"get":{"tags":["Workspaces"],"summary":"Get Workspace Instructions","description":"Return workspace instructions as plain text.","operationId":"get_workspace_instructions","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"Get Workspace Instructions success","content":{"text/plain":{"schema":{"type":"string"},"example":""}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/instructions'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/instructions'"}]},"put":{"tags":["Workspaces"],"summary":"Put Workspace Instructions","description":"Replace workspace instructions with the provided full content.","operationId":"put_workspace_instructions","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceInstructionsUpdate"}}},"description":"Request body for PUT /workspaces/{workspace_id}/instructions."},"responses":{"200":{"description":"Put Workspace Instructions success","content":{"text/plain":{"schema":{"type":"string"},"example":""}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X PUT '//workspaces/{workspace_id}/instructions'"},{"lang":"bash","label":"httpie","source":"http PUT '//workspaces/{workspace_id}/instructions'"}]}},"/workspaces/{workspace_id}/conversations":{"get":{"tags":["Workspaces"],"summary":"List Conversations","description":"List conversations for a workspace, most recent first.","operationId":"list_conversations","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Conversations success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConversationRead"},"title":"Response List Conversations"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/conversations'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/conversations'"}]}},"/workspaces/{workspace_id}/artifacts":{"get":{"tags":["Workspaces"],"summary":"List Artifacts","description":"List durable user-facing artifacts for a workspace, most recent first.","operationId":"list_artifacts","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"$ref":"#/components/parameters/IfNoneMatch"},{"$ref":"#/components/parameters/IfModifiedSince"}],"responses":{"200":{"description":"List Artifacts success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactRead"},"title":"Response List Artifacts"},"example":[]}},"headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"},"304":{"description":"Not Modified","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}}}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X GET '//workspaces/{workspace_id}/artifacts'"},{"lang":"bash","label":"httpie","source":"http GET '//workspaces/{workspace_id}/artifacts'"}]}},"/workspaces/{workspace_id}/artifacts/{item_id}":{"delete":{"tags":["Workspaces"],"summary":"Delete Artifact","description":"Remove an artifact from a workspace.","operationId":"delete_artifact","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workspace Id"},"description":"workspace_id parameter."},{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"},"description":"item_id parameter."},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"204":{"description":"No Content","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/LastModified"},"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}},"security":[],"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X DELETE '//workspaces/{workspace_id}/artifacts/{item_id}'"},{"lang":"bash","label":"httpie","source":"http DELETE '//workspaces/{workspace_id}/artifacts/{item_id}'"}]}}},"components":{"schemas":{"AdvisorResponse":{"properties":{"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"AdvisorResponse"},"ArtifactRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"},"name":{"type":"string","title":"Name"},"mime_type":{"type":"string","title":"Mime Type"},"path":{"type":"string","title":"Path"},"size":{"type":"integer","title":"Size"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","project_id","conversation_id","name","mime_type","path","size","created_at","updated_at"],"title":"ArtifactRead"},"AutomationCreate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"script_content":{"type":"string","title":"Script Content"},"trigger":{"type":"string","title":"Trigger","default":"manual"},"schedule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule"}},"type":"object","required":["script_content"],"title":"AutomationCreate"},"AutomationRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"script_path":{"type":"string","title":"Script Path"},"trigger":{"type":"string","title":"Trigger"},"schedule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"enabled":{"type":"boolean","title":"Enabled"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","workspace_id","name","slug","title","description","script_path","trigger","schedule","last_run_at","enabled","created_at"],"title":"AutomationRead"},"AutomationRunRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"automation_id":{"type":"string","format":"uuid","title":"Automation Id"},"source":{"type":"string","title":"Source"},"success":{"type":"boolean","title":"Success"},"exit_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Exit Code"},"output":{"type":"string","title":"Output"},"artifact_ids":{"items":{"type":"string"},"type":"array","title":"Artifact Ids"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"type":"string","format":"date-time","title":"Completed At"}},"type":"object","required":["id","automation_id","source","success","exit_code","output","artifact_ids","started_at","completed_at"],"title":"AutomationRunRead"},"AutomationRunResult":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id"},"automation_id":{"type":"string","format":"uuid","title":"Automation Id"},"success":{"type":"boolean","title":"Success"},"output":{"type":"string","title":"Output"},"artifact_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Artifact Ids"}},"type":"object","required":["run_id","automation_id","success","output","artifact_ids"],"title":"AutomationRunResult"},"AutomationUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"script_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Content"},"trigger":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger"},"schedule":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"}},"type":"object","title":"AutomationUpdate"},"ConnectionCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"mcp_server_url":{"type":"string","title":"Mcp Server Url"},"transport":{"type":"string","enum":["stdio","sse","streamable_http","http"],"title":"Transport","default":"streamable_http"},"config":{"additionalProperties":true,"type":"object","title":"Config"},"enabled":{"type":"boolean","title":"Enabled","default":true},"oauth_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oauth Provider"}},"type":"object","required":["name","mcp_server_url"],"title":"ConnectionCreate"},"ConnectionRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"mcp_server_url":{"type":"string","title":"Mcp Server Url"},"transport":{"type":"string","enum":["stdio","sse","streamable_http"],"title":"Transport"},"config":{"additionalProperties":true,"type":"object","title":"Config"},"enabled":{"type":"boolean","title":"Enabled"},"oauth_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oauth Provider"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"tools":{"items":{"$ref":"#/components/schemas/ConnectionToolRead"},"type":"array","title":"Tools"},"oauth_authorize_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oauth Authorize Url"}},"type":"object","required":["id","workspace_id","name","mcp_server_url","transport","config","enabled","oauth_provider","created_at","updated_at","tools"],"title":"ConnectionRead"},"ConnectionSyncResult":{"properties":{"connection_id":{"type":"string","format":"uuid","title":"Connection Id"},"synced_tools":{"type":"integer","title":"Synced Tools"}},"type":"object","required":["connection_id","synced_tools"],"title":"ConnectionSyncResult"},"ConnectionToolRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"connection_id":{"type":"string","format":"uuid","title":"Connection Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"input_schema":{"additionalProperties":true,"type":"object","title":"Input Schema"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["id","connection_id","name","description","input_schema","enabled"],"title":"ConnectionToolRead"},"ConnectionToolUpdate":{"properties":{"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["enabled"],"title":"ConnectionToolUpdate"},"ConnectionUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"transport":{"anyOf":[{"type":"string","enum":["stdio","sse","streamable_http","http"]},{"type":"null"}],"title":"Transport"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"oauth_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oauth Provider"}},"type":"object","title":"ConnectionUpdate"},"ConversationCreate":{"properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Id"},"workspace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Workspace Id"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id"},"parent_conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Conversation Id"},"branch_from_message_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Branch From Message Index"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emoji"},"messages":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Messages"},"transcript":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Transcript"}},"type":"object","title":"ConversationCreate"},"ConversationFilesRead":{"properties":{"root_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Root Path"},"tree":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tree"}},"type":"object","title":"ConversationFilesRead"},"ConversationRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"workspace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Workspace Id"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id"},"parent_conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Conversation Id"},"branch_from_message_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Branch From Message Index"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emoji"},"messages":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Messages"},"transcript":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Transcript"},"is_archived":{"type":"boolean","title":"Is Archived","default":false},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","project_id","parent_conversation_id","branch_from_message_index","title","created_at","updated_at"],"title":"ConversationRead"},"ConversationUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emoji"},"messages":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Messages"},"transcript":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Transcript"},"is_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Archived"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id"},"parent_conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Conversation Id"},"branch_from_message_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Branch From Message Index"}},"type":"object","title":"ConversationUpdate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MarketplaceSkill":{"properties":{"id":{"type":"string","title":"Id"},"skillId":{"type":"string","title":"Skillid"},"name":{"type":"string","title":"Name"},"installs":{"type":"integer","title":"Installs"},"source":{"type":"string","title":"Source"}},"type":"object","required":["id","skillId","name","installs","source"],"title":"MarketplaceSkill"},"MarketplaceSkillContent":{"properties":{"id":{"type":"string","title":"Id"},"content":{"type":"string","title":"Content"},"source_url":{"type":"string","title":"Source Url"}},"type":"object","required":["id","content","source_url"],"title":"MarketplaceSkillContent"},"NoteCoverImageRequest":{"properties":{"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"generation_mode":{"type":"string","enum":["custom","note_context"],"title":"Generation Mode","default":"custom"},"note_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note Title"},"note_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note Context"},"source_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Image"}},"type":"object","title":"NoteCoverImageRequest"},"NoteCoverImageResponse":{"properties":{"cover_image":{"type":"string","title":"Cover Image"},"revised_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revised Prompt"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","required":["cover_image"],"title":"NoteCoverImageResponse"},"NoteCreate":{"properties":{"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content","default":""},"document":{"anyOf":[{"$ref":"#/components/schemas/NoteDocument"},{"type":"null"}]},"emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emoji"},"cover_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image"},"cover_offset_x":{"type":"number","title":"Cover Offset X","default":0.0},"cover_offset_y":{"type":"number","title":"Cover Offset Y","default":0.0},"parent_note_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Note Id"},"author_type":{"type":"string","enum":["user","agent"],"title":"Author Type","default":"user"},"source_task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Task Id"}},"type":"object","required":["title"],"title":"NoteCreate"},"NoteDocument":{"properties":{"version":{"type":"integer","title":"Version","default":1},"blocks":{"items":{"$ref":"#/components/schemas/NoteDocumentBlock"},"type":"array","title":"Blocks"}},"additionalProperties":false,"type":"object","title":"NoteDocument"},"NoteDocumentBlock":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","enum":["paragraph","heading1","heading2","heading3","checklist","bulletList","numberedList","table","codeBlock","quote","divider","visualization"],"title":"Type"},"content":{"type":"string","title":"Content","default":""}},"additionalProperties":false,"type":"object","required":["type"],"title":"NoteDocumentBlock"},"NoteListItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"project_id":{"type":"string","format":"uuid","title":"Project Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"parent_note_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Note Id"},"title":{"type":"string","title":"Title"},"emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emoji"},"content_preview":{"type":"string","title":"Content Preview"},"child_count":{"type":"integer","title":"Child Count","default":0},"last_edited_by":{"type":"string","enum":["user","agent"],"title":"Last Edited By"},"last_source_task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Last Source Task Id"},"last_source_task_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Source Task Title"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","project_id","workspace_id","title","content_preview","last_edited_by","created_at","updated_at"],"title":"NoteListItem"},"NoteOutlineItem":{"properties":{"block_id":{"type":"string","title":"Block Id"},"level":{"type":"integer","title":"Level"},"title":{"type":"string","title":"Title"},"path":{"items":{"type":"string"},"type":"array","title":"Path"},"block_index":{"type":"integer","title":"Block Index"},"section_block_ids":{"items":{"type":"string"},"type":"array","title":"Section Block Ids"},"preview":{"type":"string","title":"Preview","default":""}},"additionalProperties":false,"type":"object","required":["block_id","level","title","block_index"],"title":"NoteOutlineItem"},"NotePatch":{"properties":{"base_revision_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Base Revision Id"},"target":{"$ref":"#/components/schemas/NoteTarget"},"operations":{"items":{"$ref":"#/components/schemas/NotePatchOperation"},"type":"array","title":"Operations"}},"additionalProperties":false,"type":"object","required":["target"],"title":"NotePatch"},"NotePatchApplyRequest":{"properties":{"patch":{"$ref":"#/components/schemas/NotePatch"},"author_type":{"type":"string","enum":["user","agent"],"title":"Author Type","default":"user"},"source_task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Task Id"}},"type":"object","required":["patch"],"title":"NotePatchApplyRequest"},"NotePatchOperation":{"properties":{"type":{"type":"string","enum":["replace_text","replace_blocks","insert_before","insert_after","delete_blocks"],"title":"Type"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"}},"additionalProperties":false,"type":"object","required":["type"],"title":"NotePatchOperation"},"NotePathItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emoji"}},"type":"object","required":["id","title"],"title":"NotePathItem"},"NoteRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"project_id":{"type":"string","format":"uuid","title":"Project Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"parent_note_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Note Id"},"title":{"type":"string","title":"Title"},"emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emoji"},"cover_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image"},"cover_offset_x":{"type":"number","title":"Cover Offset X"},"cover_offset_y":{"type":"number","title":"Cover Offset Y"},"content":{"type":"string","title":"Content"},"document":{"$ref":"#/components/schemas/NoteDocument"},"path":{"items":{"$ref":"#/components/schemas/NotePathItem"},"type":"array","title":"Path"},"child_notes":{"items":{"$ref":"#/components/schemas/NoteListItem"},"type":"array","title":"Child Notes"},"current_revision_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Current Revision Id"},"last_edited_by":{"type":"string","enum":["user","agent"],"title":"Last Edited By"},"last_source_task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Last Source Task Id"},"last_source_task_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Source Task Title"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","project_id","workspace_id","title","cover_offset_x","cover_offset_y","content","document","path","child_notes","last_edited_by","created_at","updated_at"],"title":"NoteRead"},"NoteRestore":{"properties":{"author_type":{"type":"string","enum":["user","agent"],"title":"Author Type","default":"user"},"source_task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Task Id"}},"type":"object","title":"NoteRestore"},"NoteRevisionRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"note_id":{"type":"string","format":"uuid","title":"Note Id"},"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"document":{"$ref":"#/components/schemas/NoteDocument"},"author_type":{"type":"string","enum":["user","agent"],"title":"Author Type"},"source_task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Task Id"},"source_task_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Task Title"},"preview":{"type":"string","title":"Preview"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","note_id","title","content","document","author_type","source_task_id","preview","created_at"],"title":"NoteRevisionRead"},"NoteTarget":{"properties":{"note_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Note Id"},"note_revision_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Note Revision Id"},"target_kind":{"type":"string","enum":["blocks","text"],"title":"Target Kind","default":"blocks"},"block_ids":{"items":{"type":"string"},"type":"array","title":"Block Ids"},"anchor_block_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Anchor Block Id"},"focus_block_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Focus Block Id"},"start_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start Offset"},"end_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"End Offset"},"selected_text":{"type":"string","title":"Selected Text","default":""},"selected_markdown":{"type":"string","title":"Selected Markdown","default":""},"preview":{"type":"string","title":"Preview","default":""},"heading_path":{"items":{"type":"string"},"type":"array","title":"Heading Path"},"source":{"type":"string","title":"Source","default":"selection"}},"additionalProperties":false,"type":"object","title":"NoteTarget"},"NoteTargetQuery":{"properties":{"block_ids":{"items":{"type":"string"},"type":"array","title":"Block Ids"},"anchor_block_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Anchor Block Id"},"focus_block_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Focus Block Id"},"start_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start Offset"},"end_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"End Offset"},"selected_text":{"type":"string","title":"Selected Text","default":""},"heading_path":{"items":{"type":"string"},"type":"array","title":"Heading Path"},"section_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section Query"}},"additionalProperties":false,"type":"object","title":"NoteTargetQuery"},"NoteUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"document":{"anyOf":[{"$ref":"#/components/schemas/NoteDocument"},{"type":"null"}]},"emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emoji"},"cover_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image"},"cover_offset_x":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cover Offset X"},"cover_offset_y":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cover Offset Y"},"parent_note_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Note Id"},"author_type":{"type":"string","enum":["user","agent"],"title":"Author Type"},"source_task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Task Id"}},"type":"object","required":["author_type"],"title":"NoteUpdate"},"PaginatedSkillsResponse":{"properties":{"skills":{"items":{"$ref":"#/components/schemas/MarketplaceSkill"},"type":"array","title":"Skills"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["skills","total","page","per_page","total_pages"],"title":"PaginatedSkillsResponse"},"ProjectCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["name"],"title":"ProjectCreate"},"ProjectRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"is_default":{"type":"boolean","title":"Is Default"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","name","description","is_default","created_at","updated_at"],"title":"ProjectRead"},"ProjectUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","title":"ProjectUpdate"},"PublishRequest":{"properties":{"skill_id":{"type":"string","title":"Skill Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"content":{"type":"string","title":"Content"},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"},"compatibility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compatibility"},"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata"},"allowed_tools":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Allowed Tools"},"files":{"anyOf":[{"items":{"$ref":"#/components/schemas/SkillFile"},"type":"array"},{"type":"null"}],"title":"Files"}},"type":"object","required":["skill_id","name","description","content"],"title":"PublishRequest","description":"Payload to publish a skill to the shared marketplace repo.\n\nFollows the Agent Skills open standard (agentskills.io/specification)."},"PublishResponse":{"properties":{"skill_id":{"type":"string","title":"Skill Id"},"source":{"type":"string","title":"Source"},"html_url":{"type":"string","title":"Html Url"}},"type":"object","required":["skill_id","source","html_url"],"title":"PublishResponse"},"RegistryEntry":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"category":{"type":"string","enum":["Developer Tools","Productivity","Data","Communication","Finance","Research"],"title":"Category"},"mcp_server_url":{"type":"string","title":"Mcp Server Url"},"transport":{"type":"string","enum":["stdio","sse","streamable_http"],"title":"Transport"},"config_schema":{"additionalProperties":true,"type":"object","title":"Config Schema"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon Url"}},"type":"object","required":["name","description","category","mcp_server_url","transport","config_schema"],"title":"RegistryEntry"},"SkillCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"script_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Content"},"script_type":{"type":"string","enum":["python","shell","none"],"title":"Script Type","default":"none"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["name"],"title":"SkillCreate"},"SkillDocumentCreate":{"properties":{"name":{"type":"string","title":"Name"},"content":{"type":"string","title":"Content"},"mime_type":{"type":"string","title":"Mime Type","default":"text/markdown"}},"type":"object","required":["name","content"],"title":"SkillDocumentCreate"},"SkillDocumentRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"skill_id":{"type":"string","format":"uuid","title":"Skill Id"},"name":{"type":"string","title":"Name"},"content":{"type":"string","title":"Content"},"mime_type":{"type":"string","title":"Mime Type"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","skill_id","name","content","mime_type","created_at"],"title":"SkillDocumentRead"},"SkillFile":{"properties":{"path":{"type":"string","title":"Path"},"content":{"type":"string","title":"Content"}},"type":"object","required":["path","content"],"title":"SkillFile","description":"An additional file to publish alongside SKILL.md."},"SkillListRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"script_type":{"type":"string","enum":["python","shell","none"],"title":"Script Type"},"is_system":{"type":"boolean","title":"Is System"},"has_script":{"type":"boolean","title":"Has Script"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","name","description","script_type","is_system","has_script","source","created_at","updated_at"],"title":"SkillListRead"},"SkillRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"workspace_id":{"type":"string","format":"uuid","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"script_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Content"},"script_type":{"type":"string","enum":["python","shell","none"],"title":"Script Type"},"is_system":{"type":"boolean","title":"Is System"},"has_script":{"type":"boolean","title":"Has Script"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"documents":{"items":{"$ref":"#/components/schemas/SkillDocumentRead"},"type":"array","title":"Documents"}},"type":"object","required":["id","workspace_id","name","description","script_content","script_type","is_system","has_script","source","created_at","updated_at","documents"],"title":"SkillRead"},"SkillRunRequest":{"properties":{"timeout_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Timeout Seconds"}},"type":"object","title":"SkillRunRequest"},"SkillRunResult":{"properties":{"success":{"type":"boolean","title":"Success"},"exit_code":{"type":"integer","title":"Exit Code"},"stdout":{"type":"string","title":"Stdout"},"stderr":{"type":"string","title":"Stderr"},"output":{"type":"string","title":"Output"},"artifact_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Artifact Id"}},"type":"object","required":["success","exit_code","stdout","stderr","output","artifact_id"],"title":"SkillRunResult"},"SkillUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"script_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script Content"},"script_type":{"anyOf":[{"type":"string","enum":["python","shell","none"]},{"type":"null"}],"title":"Script Type"}},"type":"object","title":"SkillUpdate"},"TextAdviceRequest":{"properties":{"transcript":{"type":"string","title":"Transcript"},"query":{"type":"string","title":"Query","default":"Summarize the key points from this transcript."}},"type":"object","required":["transcript"],"title":"TextAdviceRequest"},"TitleRequest":{"properties":{"messages":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Messages"},"exclude_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exclude Title"},"exclude_emoji":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exclude Emoji"}},"type":"object","required":["messages"],"title":"TitleRequest"},"TitleResponse":{"properties":{"title":{"type":"string","title":"Title"},"emoji":{"type":"string","title":"Emoji"}},"type":"object","required":["title","emoji"],"title":"TitleResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WorkspaceCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"working_dir":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Working Dir"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"full_access":{"type":"boolean","title":"Full Access","default":false}},"type":"object","required":["name"],"title":"WorkspaceCreate"},"WorkspaceInstructionsUpdate":{"properties":{"content":{"type":"string","title":"Content"}},"type":"object","required":["content"],"title":"WorkspaceInstructionsUpdate"},"WorkspaceRead":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"working_dir":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Working Dir"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"full_access":{"type":"boolean","title":"Full Access"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","user_id","name","description","working_dir","instructions","full_access","created_at","updated_at"],"title":"WorkspaceRead"},"WorkspaceUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"working_dir":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Working Dir"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"full_access":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Full Access"}},"type":"object","title":"WorkspaceUpdate"},"Problem":{"type":"object","properties":{"type":{"type":"string","format":"uri","description":"URI identifying the error type"},"title":{"type":"string","description":"Short, human-readable summary"},"status":{"type":"integer","format":"int32","description":"HTTP status code"},"detail":{"type":"string","description":"Human-readable explanation"},"instance":{"type":"string","format":"uri-reference","description":"URI reference for this occurrence"},"code":{"type":"string","description":"Stable application error code"},"errors":{"type":"array","description":"Optional list of field/validation errors","items":{"type":"object","properties":{"loc":{"type":"array","items":{"type":"string"}},"msg":{"type":"string"},"type":{"type":"string"}}}},"trace_id":{"type":"string","description":"Correlation/trace id (if available)"}},"required":["title","status"]}},"responses":{"BadRequest":{"description":"The request is malformed or missing required fields","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"default":{"value":{"type":"about:blank","title":"Bad Request","status":400,"detail":"Invalid request payload.","instance":"https://api.example.com/request/abc123","code":"BAD_REQUEST","trace_id":"00000000000000000000000000000000"}}}}}},"Unauthorized":{"description":"Authentication required or failed","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"default":{"value":{"type":"about:blank","title":"Unauthorized","status":401,"detail":"Missing or invalid credentials.","instance":"https://api.example.com/request/abc123","code":"UNAUTHORIZED","trace_id":"00000000000000000000000000000000"}}}}}},"Forbidden":{"description":"The authenticated principal does not have access","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"default":{"value":{"type":"about:blank","title":"Forbidden","status":403,"detail":"You do not have permission to perform this action.","instance":"https://api.example.com/request/abc123","code":"FORBIDDEN","trace_id":"00000000000000000000000000000000"}}}}}},"NotFound":{"description":"The requested resource was not found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"default":{"value":{"type":"about:blank","title":"Not Found","status":404,"detail":"Resource not found.","instance":"https://api.example.com/request/abc123","code":"NOT_FOUND","trace_id":"00000000000000000000000000000000"}}}}}},"Conflict":{"description":"A conflicting resource already exists or constraints were violated","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"default":{"value":{"type":"about:blank","title":"Conflict","status":409,"detail":"Record already exists.","instance":"https://api.example.com/request/abc123","code":"CONFLICT","trace_id":"00000000000000000000000000000000"}}}}}},"ValidationError":{"description":"Request failed validation","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"default":{"value":{"type":"about:blank","title":"Unprocessable Entity","status":422,"detail":"Validation failed.","instance":"https://api.example.com/request/abc123","code":"VALIDATION_ERROR","trace_id":"00000000000000000000000000000000","errors":[{"loc":["body","email"],"msg":"value is not a valid email address","type":"value_error.email"}]}}}}}},"TooManyRequests":{"description":"Rate limit exceeded","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"default":{"value":{"type":"about:blank","title":"Too Many Requests","status":429,"detail":"Rate limit exceeded. Try again later.","instance":"https://api.example.com/request/abc123","code":"RATE_LIMITED","trace_id":"00000000000000000000000000000000"}}}}}},"ServerError":{"description":"Unexpected server error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"default":{"value":{"type":"about:blank","title":"Internal Server Error","status":500,"detail":"Something went wrong. Please contact support.","instance":"https://api.example.com/request/abc123","code":"INTERNAL_ERROR","trace_id":"00000000000000000000000000000000"}}}}}}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Provide to make the request idempotent for 24h."},"IfNoneMatch":{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"Conditional GET (ETag)."},"IfModifiedSince":{"name":"If-Modified-Since","in":"header","required":false,"schema":{"type":"string"},"description":"Conditional GET. HTTP-date per RFC 9110 (e.g. 'Wed, 01 Jan 2025 00:00:00 GMT')."},"IfMatch":{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"},"description":"Optimistic concurrency for updates."}},"headers":{"ETag":{"schema":{"type":"string"},"description":"Opaque entity tag."},"LastModified":{"schema":{"type":"string"},"description":"Last modification time, HTTP-date per RFC 9110."},"XRateLimitLimit":{"schema":{"type":"integer"},"description":"Tokens in window."},"XRateLimitRemaining":{"schema":{"type":"integer"},"description":"Remaining tokens."},"XRateLimitReset":{"schema":{"type":"integer"},"description":"Unix reset time."},"XRequestId":{"schema":{"type":"string"},"description":"Correlation id."}},"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"tokenUrl":"/users/login","scopes":{}}}}}},"servers":[{"url":"/v0"}],"tags":[{"name":"Advise","description":"Operations related to Advise."},{"name":"Automations","description":"Operations related to Automations."},{"name":"Connections","description":"Operations related to Connections."},{"name":"Conversations","description":"Operations related to Conversations."},{"name":"Notes","description":"Operations related to Notes."},{"name":"Projects","description":"Operations related to Projects."},{"name":"Skills","description":"Operations related to Skills."},{"name":"Workspaces","description":"Operations related to Workspaces."}]}