Run GraphQL Operations from a CLI¶

Overview¶

You can access your app's exposed GraphQL API through a terminal or command line interface. GraphQL operates over HTTP, so the CLI can be a standard HTTP client, like curl, or a specialized GraphQL CLI, like graphqurl.

To send GraphQL requests to your app, you'll need the following:

Your App ID. For details on how to find this, see Find Your App ID.
A valid user access token. For details on how to get an access token, see Authenticate GraphQL Requests.

Run a Query¶

gq https://realm.mongodb.com/api/client/v2.0/app/<Your App ID>/graphql \
    -H 'Authorization: Bearer <Valid Access Token>' \
    -q 'query AllMoviesFromYear($year: Int!) { movies(query: { year: $year }) { title year runtime } }' \
    -v 'year=2000'

Run a Mutation¶

gq https://realm.mongodb.com/api/client/v2.0/app/<Your App ID>/graphql \
    -H 'Authorization: Bearer <Valid Access Token>' \
    -q 'mutation UpdateMovieTitle($oldTitle: String!, $newTitle: String!) { updateOneMovie(query: { title: $oldTitle } set: { title: $newTitle }) { title year } }'
    -v 'oldTitle=The Matrix Reloaded'
    -v 'newTitle=The Matrix 2'

Give Feedback

← Authenticate GraphQL Requests GraphQL Types, Resolvers, and Operators →