{"openapi":"3.0.3","info":{"title":"Voxwoven API","version":"1.0.0"},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer"}},"schemas":{}},"paths":{"/healthz":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/readyz":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/openapi.json":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/console":{"get":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"post":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/console/projects/{id}":{"get":{"security":[{"apiKey":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/capabilities":{"get":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/project":{"get":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/agent-schema":{"get":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/agents":{"get":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/agents/validate":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"instructions":{"type":"string","minLength":1,"maxLength":100000},"knowledge":{"type":"string","maxLength":300000},"tools":{"type":"array","maxItems":64,"items":{"type":"object","properties":{"type":{"enum":["function"]},"function":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-zA-Z][a-zA-Z0-9_]*$"},"description":{"type":"string","minLength":1,"maxLength":5000},"parameters":{"type":"object"}},"required":["name","description","parameters"],"additionalProperties":false},"execution":{"oneOf":[{"type":"object","properties":{"type":{"enum":["client"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"enum":["webhook"]},"url":{"type":"string","minLength":1,"maxLength":2048}},"required":["type","url"],"additionalProperties":false}]},"readOnly":{"type":"boolean"},"finishOnSuccess":{"type":"boolean"}},"required":["type","function"],"additionalProperties":false}},"stt":{"type":"object","properties":{"provider":{"enum":["moonshine"]},"model":{"enum":["small-streaming-en"]}},"required":[],"additionalProperties":false},"tts":{"type":"object","properties":{"provider":{"enum":["kokoro","kitten","piper","pocket","phonon"]},"model":{"enum":["82m-v1.0","nano-0.8","micro-0.8","ljspeech-medium","100m-int8","31m-en"]},"voice":{"type":"string","minLength":1,"maxLength":80},"speed":{"type":"number","minimum":0.75,"maximum":1.5}},"required":[],"additionalProperties":false},"llm":{"type":"object","properties":{"provider":{"enum":["openrouter"]},"model":{"type":"string","minLength":1,"maxLength":150},"temperature":{"type":"number","minimum":0,"maximum":2},"maxTokens":{"type":"integer","minimum":100,"maximum":4000}},"required":[],"additionalProperties":false},"session":{"type":"object","properties":{"maxSeconds":{"type":"integer","minimum":30,"maximum":3600},"maxUtteranceSeconds":{"type":"integer","minimum":1,"maximum":60},"maxToolRounds":{"type":"integer","minimum":1,"maximum":8},"responseTimeoutMs":{"type":"integer","minimum":5000,"maximum":120000}},"required":[],"additionalProperties":false},"answerGuards":{"type":"array","maxItems":16,"items":{"type":"object","properties":{"phrases":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"string","minLength":1,"maxLength":100}},"requiresSuccessfulTools":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string","minLength":1,"maxLength":64}},"retryInstruction":{"type":"string","minLength":1,"maxLength":2000}},"required":["phrases","requiresSuccessfulTools","retryInstruction"],"additionalProperties":false}}},"required":["instructions"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/projects":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"origins":{"type":"array","items":{"type":"string","minLength":1}},"webhookOrigins":{"type":"array","items":{"type":"string","minLength":1}},"models":{"type":"array","items":{"type":"string","minLength":1}},"concurrency":{"type":"integer"},"dailySessions":{"type":"integer"}},"required":["name","origins"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"get":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/admin/projects/{id}":{"patch":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"origins":{"type":"array","items":{"type":"string","minLength":1}},"webhookOrigins":{"type":"array","items":{"type":"string","minLength":1}},"models":{"type":"array","items":{"type":"string","minLength":1}},"concurrency":{"type":"integer"},"dailySessions":{"type":"integer"}},"required":[],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/keys":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scopes":{"type":"array","items":{"type":"string","minLength":1}}},"required":[],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}},"get":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/keys/{id}":{"delete":{"security":[{"apiKey":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/credentials/openrouter":{"put":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string","minLength":1}},"required":["key"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/agents/{id}":{"put":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"instructions":{"type":"string","minLength":1,"maxLength":100000},"knowledge":{"type":"string","maxLength":300000},"tools":{"type":"array","maxItems":64,"items":{"type":"object","properties":{"type":{"enum":["function"]},"function":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-zA-Z][a-zA-Z0-9_]*$"},"description":{"type":"string","minLength":1,"maxLength":5000},"parameters":{"type":"object"}},"required":["name","description","parameters"],"additionalProperties":false},"execution":{"oneOf":[{"type":"object","properties":{"type":{"enum":["client"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"enum":["webhook"]},"url":{"type":"string","minLength":1,"maxLength":2048}},"required":["type","url"],"additionalProperties":false}]},"readOnly":{"type":"boolean"},"finishOnSuccess":{"type":"boolean"}},"required":["type","function"],"additionalProperties":false}},"stt":{"type":"object","properties":{"provider":{"enum":["moonshine"]},"model":{"enum":["small-streaming-en"]}},"required":[],"additionalProperties":false},"tts":{"type":"object","properties":{"provider":{"enum":["kokoro","kitten","piper","pocket","phonon"]},"model":{"enum":["82m-v1.0","nano-0.8","micro-0.8","ljspeech-medium","100m-int8","31m-en"]},"voice":{"type":"string","minLength":1,"maxLength":80},"speed":{"type":"number","minimum":0.75,"maximum":1.5}},"required":[],"additionalProperties":false},"llm":{"type":"object","properties":{"provider":{"enum":["openrouter"]},"model":{"type":"string","minLength":1,"maxLength":150},"temperature":{"type":"number","minimum":0,"maximum":2},"maxTokens":{"type":"integer","minimum":100,"maximum":4000}},"required":[],"additionalProperties":false},"session":{"type":"object","properties":{"maxSeconds":{"type":"integer","minimum":30,"maximum":3600},"maxUtteranceSeconds":{"type":"integer","minimum":1,"maximum":60},"maxToolRounds":{"type":"integer","minimum":1,"maximum":8},"responseTimeoutMs":{"type":"integer","minimum":5000,"maximum":120000}},"required":[],"additionalProperties":false},"answerGuards":{"type":"array","maxItems":16,"items":{"type":"object","properties":{"phrases":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"string","minLength":1,"maxLength":100}},"requiresSuccessfulTools":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string","minLength":1,"maxLength":64}},"retryInstruction":{"type":"string","minLength":1,"maxLength":2000}},"required":["phrases","requiresSuccessfulTools","retryInstruction"],"additionalProperties":false}}},"required":["instructions"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}},"get":{"security":[{"apiKey":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/sessions":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","minLength":1},"origin":{"type":"string","minLength":1},"agent":{"type":"string","minLength":1},"version":{"type":"integer","minimum":1},"config":{"type":"object","properties":{"instructions":{"type":"string","minLength":1,"maxLength":100000},"knowledge":{"type":"string","maxLength":300000},"tools":{"type":"array","maxItems":64,"items":{"type":"object","properties":{"type":{"enum":["function"]},"function":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-zA-Z][a-zA-Z0-9_]*$"},"description":{"type":"string","minLength":1,"maxLength":5000},"parameters":{"type":"object"}},"required":["name","description","parameters"],"additionalProperties":false},"execution":{"oneOf":[{"type":"object","properties":{"type":{"enum":["client"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"enum":["webhook"]},"url":{"type":"string","minLength":1,"maxLength":2048}},"required":["type","url"],"additionalProperties":false}]},"readOnly":{"type":"boolean"},"finishOnSuccess":{"type":"boolean"}},"required":["type","function"],"additionalProperties":false}},"stt":{"type":"object","properties":{"provider":{"enum":["moonshine"]},"model":{"enum":["small-streaming-en"]}},"required":[],"additionalProperties":false},"tts":{"type":"object","properties":{"provider":{"enum":["kokoro","kitten","piper","pocket","phonon"]},"model":{"enum":["82m-v1.0","nano-0.8","micro-0.8","ljspeech-medium","100m-int8","31m-en"]},"voice":{"type":"string","minLength":1,"maxLength":80},"speed":{"type":"number","minimum":0.75,"maximum":1.5}},"required":[],"additionalProperties":false},"llm":{"type":"object","properties":{"provider":{"enum":["openrouter"]},"model":{"type":"string","minLength":1,"maxLength":150},"temperature":{"type":"number","minimum":0,"maximum":2},"maxTokens":{"type":"integer","minimum":100,"maximum":4000}},"required":[],"additionalProperties":false},"session":{"type":"object","properties":{"maxSeconds":{"type":"integer","minimum":30,"maximum":3600},"maxUtteranceSeconds":{"type":"integer","minimum":1,"maximum":60},"maxToolRounds":{"type":"integer","minimum":1,"maximum":8},"responseTimeoutMs":{"type":"integer","minimum":5000,"maximum":120000}},"required":[],"additionalProperties":false},"answerGuards":{"type":"array","maxItems":16,"items":{"type":"object","properties":{"phrases":{"type":"array","minItems":1,"maxItems":32,"items":{"type":"string","minLength":1,"maxLength":100}},"requiresSuccessfulTools":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string","minLength":1,"maxLength":64}},"retryInstruction":{"type":"string","minLength":1,"maxLength":2000}},"required":["phrases","requiresSuccessfulTools","retryInstruction"],"additionalProperties":false}}},"required":["instructions"],"additionalProperties":false}},"required":["subject","origin"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/sessions/{id}":{"delete":{"security":[{"apiKey":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/tool-calls/verify":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","minLength":1},"proof":{"type":"string","minLength":1}},"required":["subject","proof"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/tool-calls/{id}/result":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","minLength":1},"result":{"type":"object","additionalProperties":true}},"required":["subject","result"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/v1/speech":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":2000},"provider":{"type":"string","minLength":1},"model":{"type":"string","minLength":1},"voice":{"type":"string","minLength":1},"speed":{"type":"number","minimum":0.75,"maximum":1.5},"format":{"enum":["pcm","wav","mp3"]},"cache":{"type":"boolean"}},"required":["text"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v1/usage":{"get":{"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}}}}