# Amazon CloudWatch Evidently API

> Amazon CloudWatch Evidently API on Apizie: 38 endpoints (This operation assigns feature variation to user sessions. For each user session, you pass in an entityID…, Returns configuration details about all the experiments in the specified project., Creates an Evidently experiment . Before you create an experiment, you must create the feature to use for…, Returns configuration details about all the features in the specified project., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-evidently`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-evidently
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-evidently/openapi.json

You can use Amazon CloudWatch Evidently to safely validate new features by serving them to a specified percentage of your users while you roll out the feature. You can monitor the performance of the new feature to help…

## Endpoints

### This operation assigns feature variation to user sessions. For each user session, you pass in an entityID…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/batch-evaluate-feature` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project that contains the feature being evaluated. |
| body | object | yes | JSON request body |

### Returns configuration details about all the experiments in the specified project.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/list-experiments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | The maximum number of results to include in the response. |
| nextToken | string | no | The token to use when requesting the next set of results. You received this token from a previous ListExperiments operation. |
| project | string | yes | The name or ARN of the project to return the experiment list from. |
| status | string | no | Use this optional parameter to limit the returned results to only the experiments with the status that you specify here. |

### Creates an Evidently experiment . Before you create an experiment, you must create the feature to use for…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/create-experiment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project that you want to create the new experiment in. |
| body | object | yes | JSON request body |

### Returns configuration details about all the features in the specified project.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/list-features` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | The maximum number of results to include in the response. |
| nextToken | string | no | The token to use when requesting the next set of results. You received this token from a previous ListFeatures operation. |
| project | string | yes | The name or ARN of the project to return the feature list from. |

### Creates an Evidently feature that you want to launch or test. You can define up to five variations of a…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/create-feature` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project that is to contain the new feature. |
| body | object | yes | JSON request body |

### Returns configuration details about all the launches in the specified project.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/list-launches` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | The maximum number of results to include in the response. |
| nextToken | string | no | The token to use when requesting the next set of results. You received this token from a previous ListLaunches operation. |
| project | string | yes | The name or ARN of the project to return the launch list from. |
| status | string | no | Use this optional parameter to limit the returned results to only the launches with the status that you specify here. |

### Creates a launch of a given feature. Before you create a launch, you must create the feature to use for the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/create-launch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project that you want to create the launch in. |
| body | object | yes | JSON request body |

### Returns configuration details about all the projects in the current Region in your account.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/list-projects` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | The maximum number of results to include in the response. |
| nextToken | string | no | The token to use when requesting the next set of results. You received this token from a previous ListProjects operation. |

### Creates a project, which is the logical object in Evidently that can contain features, launches, and…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/create-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Returns a list of audience segments that you have created in your account in this Region.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/list-segments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | The maximum number of results to include in the response. If you omit this, the default of 50 is used. |
| nextToken | string | no | The token to use when requesting the next set of results. You received this token from a previous ListSegments operation. |

### Use this operation to define a segment of your audience. A segment is a portion of your audience that share…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/create-segment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Returns the details about one experiment. You must already know the experiment name. To retrieve a list of…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/get-experiment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| experiment | string | yes | The name of the experiment that you want to see the details of. |
| project | string | yes | The name or ARN of the project that contains the experiment. |

### Updates an Evidently experiment. Don't use this operation to update an experiment's tag. Instead, use…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/update-experiment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| experiment | string | yes | The name of the experiment to update. |
| project | string | yes | The name or ARN of the project that contains the experiment that you want to update. |
| body | object | yes | JSON request body |

### Deletes an Evidently experiment. The feature used for the experiment is not deleted. To stop an experiment…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/delete-experiment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| experiment | string | yes | The name of the experiment to delete. |
| project | string | yes | The name or ARN of the project that contains the experiment to delete. |

### Returns the details about one feature. You must already know the feature name. To retrieve a list of…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/get-feature` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| feature | string | yes | The name of the feature that you want to retrieve information for. |
| project | string | yes | The name or ARN of the project that contains the feature. |

### Updates an existing feature. You can't use this operation to update the tags of an existing feature.…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/update-feature` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| feature | string | yes | The name of the feature to be updated. |
| project | string | yes | The name or ARN of the project that contains the feature to be updated. |
| body | object | yes | JSON request body |

### Deletes an Evidently feature.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/delete-feature` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| feature | string | yes | The name of the feature to delete. |
| project | string | yes | The name or ARN of the project that contains the feature to delete. |

### Returns the details about one launch. You must already know the launch name. To retrieve a list of launches…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/get-launch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| launch | string | yes | The name of the launch that you want to see the details of. |
| project | string | yes | The name or ARN of the project that contains the launch. |

### Updates a launch of a given feature. Don't use this operation to update the tags of an existing launch.…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/update-launch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| launch | string | yes | The name of the launch that is to be updated. |
| project | string | yes | The name or ARN of the project that contains the launch that you want to update. |
| body | object | yes | JSON request body |

### Deletes an Evidently launch. The feature used for the launch is not deleted. To stop a launch without…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/delete-launch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| launch | string | yes | The name of the launch to delete. |
| project | string | yes | The name or ARN of the project that contains the launch to delete. |

### Returns the details about one launch. You must already know the project name. To retrieve a list of projects…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/get-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project that you want to see the details of. |

### Updates the description of an existing project. To create a new project, use CreateProject . Don't use this…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/update-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project to update. |
| body | object | yes | JSON request body |

### Deletes an Evidently project. Before you can delete a project, you must delete all the features that the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/delete-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project to delete. |

### Returns information about the specified segment. Specify the segment you want to view by specifying its ARN.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/get-segment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| segment | string | yes | The ARN of the segment to return information for. |

### Deletes a segment. You can't delete a segment that is being used in a launch or experiment, even if that…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/delete-segment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| segment | string | yes | Specifies the segment to delete. |

### This operation assigns a feature variation to one given user session. You pass in an entityID that…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/evaluate-feature` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| feature | string | yes | The name of the feature being evaluated. |
| project | string | yes | The name or ARN of the project that contains this feature. |
| body | object | yes | JSON request body |

### Retrieves the results of a running or completed experiment. No results are available until there have been…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/get-experiment-results` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| experiment | string | yes | The name of the experiment to retrieve the results of. |
| project | string | yes | The name or ARN of the project that contains the experiment that you want to see the results of. |
| body | object | yes | JSON request body |

### Use this operation to find which experiments or launches are using a specified segment.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/list-segment-references` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | integer | no | The maximum number of results to include in the response. If you omit this, the default of 50 is used. |
| nextToken | string | no | The token to use when requesting the next set of results. You received this token from a previous ListSegmentReferences operation. |
| segment | string | yes | The ARN of the segment that you want to view information for. |
| type | string | yes | Specifies whether to return information about launches or experiments that use this segment. |

### Displays the tags associated with an Evidently resource.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The ARN of the resource that you want to see the tags of. |

### Assigns one or more tags (key-value pairs) to the specified CloudWatch Evidently resource. Projects,…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The ARN of the CloudWatch Evidently resource that you're adding tags to. |
| body | object | yes | JSON request body |

### Sends performance events to Evidently. These events can be used to evaluate a launch or an experiment.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/put-project-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project to write the events to. |
| body | object | yes | JSON request body |

### Starts an existing experiment. To create an experiment, use CreateExperiment .
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/start-experiment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| experiment | string | yes | The name of the experiment to start. |
| project | string | yes | The name or ARN of the project that contains the experiment to start. |
| body | object | yes | JSON request body |

### Starts an existing launch. To create a launch, use CreateLaunch .
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/start-launch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| launch | string | yes | The name of the launch to start. |
| project | string | yes | The name or ARN of the project that contains the launch to start. |

### Stops an experiment that is currently running. If you stop an experiment, you can't resume it or restart it.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/stop-experiment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| experiment | string | yes | The name of the experiment to stop. |
| project | string | yes | The name or ARN of the project that contains the experiment to stop. |
| body | object | yes | JSON request body |

### Stops a launch that is currently running. After you stop a launch, you will not be able to resume it or…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/stop-launch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| launch | string | yes | The name of the launch to stop. |
| project | string | yes | The name or ARN of the project that contains the launch that you want to stop. |
| body | object | yes | JSON request body |

### Use this operation to test a rules pattern that you plan to use to create an audience segment. For more…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/test-segment-pattern` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Removes one or more tags from the specified resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The ARN of the CloudWatch Evidently resource that you're removing tags from. |
| tagKeys | array | yes | The list of tag keys to remove from the resource. |

### Updates the data storage options for this project. If you store evaluation events, you an keep them and…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/update-project-data-delivery` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| project | string | yes | The name or ARN of the project that you want to modify the data storage options for. |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/batch-evaluate-feature" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon CloudWatch Evidently API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-evidently/batch-evaluate-feature with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Amazon CloudWatch Evidently API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Amazon CloudWatch Evidently itself also needs your own key from amazonaws.com.

### Can AI agents use the Amazon CloudWatch Evidently API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-evidently.

### What is the status of the Amazon CloudWatch Evidently API?
Needs your own provider key (bring your own key)