> For the complete documentation index, see [llms.txt](https://docs.defguard.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.defguard.net/2.1/for-developers/rest-api/core/proxy/stream-the-progress-of-edge-proxy-tls-setup.md).

# Stream the progress of edge (proxy) TLS setup

Drives the whole TLS setup flow and reports its progress as Server-Sent Events.

```json
{"openapi":"3.1.0","info":{"title":"defguard Core API","version":"2.1.0"},"tags":[{"name":"proxy","description":"Edge (proxy) instances, their TLS and ACME setup."}],"security":[{"cookie":[]},{"api_token":[]}],"components":{"securitySchemes":{"cookie":{"type":"apiKey","in":"cookie","name":"defguard_session"},"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"ApiErrorResponse":{"type":"object","description":"Body returned with error responses.","required":["msg"],"properties":{"code":{"type":["string","null"],"description":"Machine-readable error code, returned for selected errors."},"msg":{"type":"string","description":"Human-readable error message."}}}}},"paths":{"/api/v1/proxy/setup/stream":{"get":{"tags":["proxy"],"summary":"Stream the progress of edge (proxy) TLS setup","description":"Drives the whole TLS setup flow and reports its progress as Server-Sent Events.","operationId":"setup_proxy_tls_stream","parameters":[{"name":"common_name","in":"query","description":"Common name for the edge certificate.","required":true,"schema":{"type":"string"}},{"name":"ip_or_domain","in":"query","description":"Address the edge instance is reachable at.","required":true,"schema":{"type":"string"}},{"name":"grpc_port","in":"query","description":"gRPC port of the edge instance.","required":true,"schema":{"type":"integer","format":"int32","minimum":0}}],"responses":{"200":{"description":"Server-Sent Event stream with setup progress. Each event carries the current step name and its result.","content":{"text/event-stream":{"schema":{"type":"string"}}}},"401":{"description":"Session is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"403":{"description":"Requires admin privileges.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}}}}
```