{"openapi":"3.1.0","info":{"title":"Knock Agent Notification API","version":"1.0.0","description":"Send actionable Android notifications and poll for human responses."},"servers":[{"url":"https://knock.95-216-171-100.sslip.io"}],"components":{"securitySchemes":{"agentKey":{"type":"http","scheme":"bearer"}}},"paths":{"/v1/notifications":{"post":{"summary":"Send a notification","security":[{"agentKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","body"],"properties":{"deviceId":{"type":"string","format":"uuid"},"title":{"type":"string","maxLength":120},"body":{"type":"string","maxLength":1000},"imageUrl":{"type":"string","format":"uri"},"linkUrl":{"type":"string","format":"uri"},"metadata":{"type":"object","additionalProperties":true},"actions":{"type":"array","maxItems":3,"items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"destructive":{"type":"boolean"}}}},"timeoutSeconds":{"type":"integer","minimum":5,"maximum":86400}}}}}},"responses":{"201":{"description":"Notification accepted"}}}},"/v1/notifications/{id}":{"get":{"summary":"Poll notification state","security":[{"agentKey":[]}],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Current state and response"}}}},"/v1/notifications/{id}/wait":{"get":{"summary":"Long-poll until terminal state","security":[{"agentKey":[]}],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"timeout","schema":{"type":"integer","minimum":1,"maximum":25}}],"responses":{"200":{"description":"Current or terminal state"}}}}}}