{"openapi":"3.1.0","info":{"title":"See With You screen-sharing API","version":"0.1.0","description":"Create an authorized remote screen-sharing session for your AI. No remote control or recording. Images are processed by our hosted receiver and passed to your application."},"servers":[{"url":"https://agents.seewithyou.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v1/sessions":{"post":{"operationId":"create_session","summary":"Create an invitation or sandbox session","parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string","enum":["live","sandbox"],"default":"live"},"language":{"type":"string","enum":["en","zh"],"default":"en"},"assistant_name":{"type":"string","maxLength":80}}}}}},"responses":{"201":{"description":"Session ID, user share_url (null in sandbox), expiry and polling interval","content":{"application/json":{"schema":{"type":"object","required":["id","mode","state","share_url","expires_at"],"properties":{"id":{"type":"string"},"mode":{"type":"string"},"state":{"type":"string"},"share_url":{"type":["string","null"]},"expires_at":{"type":"string","format":"date-time"},"poll_after_ms":{"type":"integer"}}}}}},"400":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"409":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"503":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/v1/sessions/{session_id}":{"get":{"operationId":"get_status","summary":"Get session and media status","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Current state and latest frame metadata"},"401":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/v1/sessions/{session_id}/screen":{"get":{"operationId":"get_screen","summary":"Get the current screen JPEG, at most once per second","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"JPEG with X-Screen-Captured-At, X-Screen-Sequence, X-Screen-Width, X-Screen-Height and X-Screen-Sandbox headers","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"409":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"410":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/v1/sessions/{session_id}/end":{"post":{"operationId":"end_session","summary":"End permanently; safe to repeat","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Session ended"},"401":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Machine-readable error code. 409: waiting/paused/disconnected/stale. 410: ended/expired. 429: rate/concurrency/trial limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}