# Auth

Authentication operations.

## Authenticate

> Authenticate to retrieve the HUE application key. Requires to go and press the button on the bridge

```json
{"openapi":"3.0.3","info":{"title":"Hue CLIP API","version":"v2"},"tags":[{"name":"Auth","description":"Authentication operations."}],"servers":[{"url":"https://{bridgeInternalIPAddress}","description":"Your Home Bridge","variables":{"bridgeInternalIPAddress":{"default":"192.168.1.0","description":"Use the broker server discover process by visiting https://discovery.meethue.com\nto discover the IP address of the bridge on your network\n"}}}],"paths":{"/api":{"post":{"operationId":"authenticate","summary":"Authenticate","description":"Authenticate to retrieve the HUE application key. Requires to go and press the button on the bridge","tags":["Auth"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"devicetype":{"type":"string"},"generateclientkey":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Authentication Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/response"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}},"components":{"schemas":{"response":{"type":"array","minItems":1,"maxItems":1,"items":{"type":"object","properties":{"success":{"type":"object","properties":{"username":{"type":"string"},"clientkey":{"type":"string"}}},"error":{"type":"object","properties":{"type":{"type":"integer"},"address":{"type":"string"},"description":{"type":"string"}}}}}},"ErrorResponse":{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"type":"object","required":["description"],"properties":{"description":{"type":"string","description":"a human-readable explanation specific to this occurrence of the problem."}}}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}
```