---
title: "Evaluate an Unleash context against a change request preview."
method: POST
path: "/api/admin/playground/change-request/{id}"
tags: ["Playground"]
---

# Evaluate an Unleash context against a change request preview.

`POST /api/admin/playground/change-request/{id}`

**Enterprise feature**

Use the provided `context` to evaluate toggles on this Unleash instance with a change request applied in preview mode. You can use comma-separated values to provide multiple values to each context field. Returns a combinatorial list of all toggles that match the parameters and what they evaluate to.

## Path parameters

- `id` string, required

## Request body

- ChangeRequestPlaygroundRequestSchema — Data for the playground API to evaluate flags with change request applied in preview mode
  - `context` SdkContextSchema, required — The Unleash context as modeled in client SDKs
    - `appName` string, required — The name of the application.
    - `currentTime` string, date-time — A DateTime (or similar) data class instance or a string in an RFC3339-compatible format. Defaults to the current time if not set by the user.
    - `environment` string — The environment the app is running in.
    - `properties` object — Additional Unleash context properties
    - `remoteAddress` string — The app's IP address
    - `sessionId` string — An identifier for the current session
    - `userId` string — An identifier for the current user

## Response `200`

advancedPlaygroundResponseSchema

- AdvancedPlaygroundResponseSchema — The state of all features given the provided input.
  - `input` AdvancedPlaygroundRequestSchema, required — Data for the playground API to evaluate toggles in advanced mode with environment and context multi selection
    - `environments` string[], required — The environments to evaluate toggles in.
    - `projects` union — A list of projects to check for toggles in.
      - string[] — A list of projects to check for toggles in.
      - '*' — Check toggles in all projects.
    - `context` SdkContextSchema, required — The Unleash context as modeled in client SDKs
      - `appName` string, required — The name of the application.
      - `currentTime` string, date-time — A DateTime (or similar) data class instance or a string in an RFC3339-compatible format. Defaults to the current time if not set by the user.
      - `environment` string — The environment the app is running in.
      - `properties` object — Additional Unleash context properties
      - `remoteAddress` string — The app's IP address
      - `sessionId` string — An identifier for the current session
      - `userId` string — An identifier for the current user
  - `features` AdvancedPlaygroundFeatureSchema[], required — The list of features that have been evaluated.
    - `name` string, required — The feature's name.
    - `projectId` string, required — The ID of the project that contains this feature.
    - `environments` object, required — The lists of features that have been evaluated grouped by environment.
  - `warnings` object — Warnings that occurred during evaluation.
    - `invalidContextProperties` string[] — A list of top-level context properties that were provided as input that are not valid due to being the wrong type.

## Other responses

- `400` — The request data does not match what we expect.
- `401` — Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.
- `404` — The requested resource was not found.

---

[API](https://skmtc.net/unleash/apis/unleash-api-3.md) · [All operations](https://skmtc.net/unleash/apis/unleash-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unleash/unleash-api-3/revisions/b2c3116e633e/schema)