The Experiment management API can be used to programmatically create and control flags and experiments.
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. |
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.
The management API uses the HTTP Authorization header for authentication.
The header must be: Authorization: Bearer <management-api-key>
.
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.
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. |
Region | Endpoint |
---|---|
Standard Server | https://experiment.amplitude.com |
EU Residency Server | https://experiment.eu.amplitude.com |
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 |
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.
Thanks for your feedback!
October 9th, 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.