A companion to our API references
In our various guides we assumed the use of our Python SDK. There are some use cases where this is not appropriate. For example, if you are integrating Humanloop from a non-Python backend, such as Node.js, or using a no-or-low-code builder such as Bubble or Zapier. In these cases, you can leverage our RESTful APIs directly.
To help with direct API integrations, we maintain a Postman Workspace with various worked examples for the main endpoints you will need.
A Humanloop account. If you don't have one, you can create an account now by going to the Sign up page.
Set your API keys in Postman
- Navigate to your Humanloop profile page and copy your Humanloop API key.
- Navigate to our Postman Workspace and set the environment to
Productionin the dropdown in the top right where it says
- Select the
Environment quick lookbutton beside the environment dropdown and paste your Humanloop API key into the
CURRENT VALUEof the
- Navigate to your OpenAI profile and copy the API key.
- Navigate back to our Postman Workspace and paste your OpenAI key into the
CURRENT VALUEof the global
You are now all set to use Postman to interact with the APIs with real examples!
Try out the Postman Collections
A collection is a set of executable API specifications that are grouped together in Postman.
There are 4 executable collections provided to check out.
The Generate Flow is the best place to start. It contains all the basic API calls needed to create a project, make generations and provide feedback. To try it out:
- Expand the Generate Flow collection on the left hand side.
- Execute the
POSTcalls in order from top to bottom by selecting them under the collection on the left hand side and pressing the
Sendbutton on the right hand side. You should see the resulting response body appearing in the box below the request body.
- Try editing the request body and resending - you can reference the corresponding API guides for a full spec of the request schema.
- If you now navigate to your Humanloop projects page, you will see a new project called
quickstart-postmanwith the logged data and feedback that has been created by the collection.
- You can now generate populated code snippets across a range of languages by selecting the code icon on the right hand side beside the request and response bodies:
Updated 4 months ago