To retrieve the intent manifest from Uniform Optimize, you must generate an API key. To add a new key, log into Uniform Optimize as an administrator of your team.
- After logging in, click on team settings:
Click on the API Keys tab
Click the (+) button to add a new API key
Enter a name for the key and choose the project(s) and permissions that the key should have access to:
For an API key that can read the published intent manifest, such as a Next/Nuxt app, check off the
Uniform Optimize -> Intent Manifest -> Readpermission. For an API key that can read the draft manifest (i.e. for a CMS integration or app preview), check off the
Uniform Optimize -> Read Draftspermission.
Click Create. For most uses of an API key you will need the key and the project ID you want to access. Both can be easily copied on this screen.
The API key can only be shown once. Ensure you copy it by clicking on it and store it somewhere safe before you close the form. Should you forget the key, delete it and create a new one.
After you have an API key, you can start using it in your project. There are several ways you can fetch manifest data:
- Uniform CLI (
npm install -g @uniform/cli)
uniform optimize manifest download --api-key=<your-api-key> --project <project-id>
curl -H"x-api-key: <your-api-key-here>" https://uniform.app/api/v1/manifest?projectId=<your-project-id-here>
- Other HTTP clients, such as Postman
You should receive JSON that represents the intents and signals: