> For the complete documentation index, see [llms.txt](https://api-docs.realfinity.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.realfinity.io/api/api-reference/auth.md).

# Auth

## POST /oauth/token

> Generate an OAuth token

```json
{"openapi":"3.0.4","info":{"title":"HomeDashboard","version":"v1.2"},"tags":[{"name":"Auth"}],"servers":[{"url":"/homedashboard"}],"security":[{}],"paths":{"/oauth/token":{"post":{"tags":["Auth"],"summary":"Generate an OAuth token","requestBody":{"description":"","content":{"application/json;odata.metadata=minimal;odata.streaming=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=minimal;odata.streaming=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=minimal":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full;odata.streaming=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full;odata.streaming=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none;odata.streaming=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none;odata.streaming=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.streaming=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.streaming=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=minimal;odata.streaming=true;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=minimal;odata.streaming=false;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=minimal;odata.streaming=false;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=minimal;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=minimal;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full;odata.streaming=true;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full;odata.streaming=true;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full;odata.streaming=false;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full;odata.streaming=false;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=full;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none;odata.streaming=true;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none;odata.streaming=true;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none;odata.streaming=false;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none;odata.streaming=false;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.metadata=none;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.streaming=true;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.streaming=true;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.streaming=false;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;odata.streaming=false;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"text/plain":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"text/json":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/Realfinity.Public.Api.Models.GetAccessTokenRequest"}}}},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Realfinity.Public.Api.Models.GetAccessTokenRequest":{"type":"object","properties":{"client_id":{"type":"string","nullable":true},"client_secret":{"type":"string","nullable":true}},"additionalProperties":false}}}}
```