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 each 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[?(@.metadata.name == "researcher-service")].spec.ports[0].nodePort}')"

Limitations

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


Last update: January 5, 2021