Getting Started with the API
API Version V1.2
Overview
The Vena API is a REST API that allows users to
- Retrieve template information
- Upload files to steps
- Create jobs
- Edit jobs
- Run jobs
Authentication
To use the API, you will need to get a username and password (i.e. application token) from Vena.
See Appendix A: Authorization & Authentication for more details.
Know your region
Every API endpoint requires you to know your region. You can find your region by logging into vena.io and viewing the region listed in the URL.
List of endpoints
There is no set order to these endpoints, although you may need a piece of information from one to run another.
E.g., to run Get Template, you will need a template ID which you can retrieve from List Templates.
- List Templates
- Get Template
- Start With Data
- Start With File
- Create Job
- Get Job
- Get Job Status
- Cancel Job
- Load File to Specific Input
- Load JSON to Specific Input
- Submit Job
Troubleshooting
If you are running into any issues/errors, please refer to the Troubleshooting section to try and figure out what might be wrong.