diff --git a/openapi.yaml b/openapi.yaml
index c8c2d81..9b88f79 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -1,7 +1,7 @@
openapi: 3.0.1
info:
title: api
- version: 0.2.15
+ version: 0.2.18
paths:
/evaluate/v1/boolean:
post:
@@ -523,6 +523,11 @@ paths:
required: false
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -571,6 +576,11 @@ paths:
required: true
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -648,6 +658,11 @@ paths:
required: false
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -686,6 +701,11 @@ paths:
required: true
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -763,6 +783,11 @@ paths:
required: false
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -847,6 +872,11 @@ paths:
required: true
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -940,6 +970,11 @@ paths:
required: false
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -1024,6 +1059,11 @@ paths:
required: true
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -1112,6 +1152,11 @@ paths:
required: false
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -1160,6 +1205,11 @@ paths:
required: true
schema:
type: string
+ - name: reference
+ in: query
+ required: false
+ schema:
+ type: string
responses:
'200':
description: ''
@@ -1322,6 +1372,8 @@ components:
type: object
additionalProperties:
type: string
+ reference:
+ type: string
required:
- namespaceKey
- flagKey
@@ -1439,6 +1491,8 @@ components:
type: array
items:
$ref: '#/components/schemas/EvaluationevaluationRequest'
+ reference:
+ type: string
required:
- requests
EvaluationbatchEvaluationResponse:
@@ -1478,6 +1532,7 @@ components:
- METHOD_TOKEN
- METHOD_OIDC
- METHOD_KUBERNETES
+ - METHOD_JWT
description: The default is METHOD_NONE
Authauthentication:
type: object
diff --git a/reference/overview.mdx b/reference/overview.mdx
index a49344a..4a14bf2 100644
--- a/reference/overview.mdx
+++ b/reference/overview.mdx
@@ -10,6 +10,22 @@ The Flipt REST API can also be used with any language that can make HTTP request
The latest version of the REST API is fully documented using the [OpenAPI v3 specification](https://github.com/flipt-io/flipt-openapi).
+## Authentication
+
+
+Flipt authentication is **disabled** (not required) by default.
+
+Head to the [Configuration: Authentication](/configuration#authentication) section to enable it.
+
+
+
+As of [v1.35.0](https://github.com/flipt-io/flipt/releases/tag/v1.35.0) Flipt now supports two types of authentication for the API:
+
+- **Client Token Authentication** - This method user tokens stored by Flipt to authenticate the request. See the [Using Client Tokens](/authentication/using-tokens) section for more information.
+- **JSON Web Token (JWT) Authentication** - This method uses a JWT token, created and signed externally from Flipt to authenticate the request. See the [Using JWT Tokens](/authentication/using-jwt) section for more information.
+
+See the [Authentication](/authentication) documentation for more information on all supported authentication methods.
+
## SDKs
We're adding new SDKs all the time. To see the current list of official REST SDKs, head to the [REST SDKs](/integration/server/rest) documentation.
@@ -37,16 +53,3 @@ Version [v1.20.0](https://github.com/flipt-io/flipt/releases/tag/v1.20.0) of Fli
All previous endpoints without the `/namespaces` prefix still work as before (i.e.: `/api/v1/flags`), they simply resolve to using the **default** namespace.
See the [Concepts: Namespaces](/concepts#namespaces) section for more information.
-
-## Authentication
-
-
-Flipt authentication is **disabled** (not required) by default.
-
-Head to the [Configuration: Authentication](/configuration#authentication) section to enable it.
-
-
-
-Once enabled, the Flipt REST API uses tokens for authentication. The token is passed in the `Authorization` header of the request as a `Bearer` token.
-
-For more information on how to create a token, see the [Authentication](/authentication) documentation.