Skip to main content
Use dv api to send an authenticated request from your terminal. The command uses your existing CLI sign-in and account permissions. If you need to sign in, run dv login.

Make a request

Run dv help api to check that your CLI includes the command. Then list the repositories you can access.
Use an endpoint path such as /repos. The CLI adds the API base URL, including /v0. Quote the path when it has query parameters. List user’s repositories.
To inspect one repository, replace REPO_ID with a repo_id from the list. Get repository details.

Choose a method and send JSON

GET is the default method. Use -X to set a different method and -d to pass a JSON request body. Find the method and body fields for your endpoint in the API reference.

Use the response in a script

The command writes the response body to standard output. For HTTP errors, it still writes the body, prints the status to standard error, and exits with a nonzero code. In Bash, enable pipefail so a failed request makes the pipeline fail even if jq succeeds. This example prints one repository name per line.