Skip to content
Featureflip Docs

Re-identifies the user with a new context, for example after login.

POST
/v1/client/identify
 
curl --request POST \
  --url https://eval.featureflip.io/v1/client/identify \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "context": { "additionalProperty": "example" } }'

Re-evaluates all client-visible flags and returns the updated values. Also updates the context on any active SSE connections for this environment.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “ Header Parameters ”
X-Featureflip-Reports-Evaluations
string

Set to 1 when the client reports the flags it reads to POST /v1/client/events. The flags this request serves are then not counted as evaluated unless the client reports its reads, so flags it never reports look unused to staleness checks and archiving. Omit it otherwise.

Request Body

Section titled “ Request Body ”

The evaluation request containing the new user context attributes.

object
context
required
object
key
additional properties
nullable
Example generated 
{
  "context": {
    "additionalProperty": "example"
  }
}

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Returns the re-evaluated results for all client-visible flags.

Media type application/json
object
flags
required
object
key
additional properties
object
value
required
variation
required
string
nullable
reason
required
string
nullable
prerequisiteKey
string
nullable
Example generated 
{
  "flags": {
    "additionalProperty": {
      "value": "example",
      "variation": "example",
      "reason": "example",
      "prerequisiteKey": "example"
    }
  }
}

401

Section titled “ 401 ”

Client SDK key is missing or invalid.

Media type application/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Example generated 
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

503

Section titled “ 503 ”

Flag configuration is temporarily unavailable; retry after the interval in Retry-After.