Skip to content

Researcher REST API

The purpose of the Researcher REST API is to provide an easy-to-use programming interface for submitting, listing, and deleting Jobs.

There are other APIs that provide the same functionality. Specifically:

Finding the API Endpoint URL

The URL is composed of an IP address part and a port part (<IP-ADDRESS>:<PORT>). To find the endpoint, run:

echo "http://$(kubectl get nodes -o=jsonpath='{.items[0].status.addresses[0].address}'):$(kubectl get services -n runai -o=jsonpath='{.items[?( == "researcher-service")].spec.ports[0].nodePort}')"


The Researcher REST API does not work when the system is configured to authenticate Researchers. We are working to add this functionality.

Last update: May 10, 2021