Experiment Management API

The Experiment management API can be used to programmatically create and control flags and experiments.

Endpoints

API
Description
Flag APIs Flag APIs to create, edit, and display flags, and their properties.
Experiment APIs Experiment APIs to create, edit, and display experiments, and their properties.
Deployment APIs Deployment APIs to create, edit, and display deployments that flags or experiments can be assigned to.
Version APIs Version APIs to display a list of versions of flags or experiments that the management API key has access to.

Management API Key

You can create and revoke management API keys by clicking on "Management API" in the bottom left of the sidebar. Read more about the Management API Key in the comprehensive guide to all Amplitude keys.

Authorization

The management API uses the HTTP Authorization header for authentication.

The header must be: Authorization: Bearer <management-api-key>.

Management API keuys

Management API keys are different from the deployment keys used to fetch flag variants. They're created and managed via the Management API link in the Experiment sidebar.

Rate limiting

Current API limits are per project, and impose the following restrictions:

Limit (requests) Duration
100 1 second
100000 Daily. Daily limits is reset at the end of the day UTC time.

Regions

Region Endpoint
Standard Server https://experiment.amplitude.com
EU Residency Server https://experiment.eu.amplitude.com

Conventions

Status codes

The API uses meaningful status codes to communicate the result of requests.

Code Meaning
200 Success
400 Input is missing or invalid
401 Invalid or revoked API key
403 API key doesn't have access to the specified environment
429 Too many requests

Cursors

Endpoints that list resources such as /experiments will only return a limited number of items per request. To fetch the next page of items, the nextCursor value returned from the first request must be passed as the cursor parameter of the next request. In this way multiple requests can be chained together to fetch the total set of items.

Was this page helpful?

Thanks for your feedback!

July 15th, 2024

Need help? Contact Support

Visit Amplitude.com

Have a look at the Amplitude Blog

Learn more at Amplitude Academy

© 2024 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.