Using the REST API
Last updated
Was this helpful?
Last updated
Was this helpful?
Was this helpful?
You can retrieve information about your Roboflow projects and datasets using the REST API.
/
- the Root route can be used to validate your API Key and find your workspace ID.
/:workspace
- the Workspace route gives you information about your workspace and a list of its projects.
/:workspace/:project
- the Project route shows information about a project and its versions.
/:workspace/:project/:version
- the Version route surfaces information about a version, its trained model (if present), and exported datasets.
/:workspace/:project/:version/:format
- the Format route is where you go to retrieve a download link for a zipped dataset in a particular export format.
The data structure in Roboflow is largely hierarchical; the API layout matches this. Workspaces contain Projects which contain Versions which have trained models and are exported in various Formats.
At the top level (https://api.roboflow.com/
), you can verify your api_key
is working. The response will tell you which workspace
owns the key.
Example for the roboflow
workspace:
$ curl "https://api.roboflow.com/?api_key=$ROBOFLOW_API_KEY"
{
"welcome": "Welcome to the Roboflow API.",
"instructions": "You are successfully authenticated.",
"docs": "https://docs.roboflow.com",
"workspace": "roboflow"
}
You can drill down into this workspace with its Workspace endpoint to access information about your projects.