Bulk Data QueriesΒΆ

To make multiple queries as a part of the same request you can send them as parts of one bulk query.

To select from multiple tables in the same request, make a bulk query as follows

POST data.<cluster-name>.hasura-app.io/v1/query HTTP/1.1
Content-Type: application/json
Authorization: Bearer <auth-token> # optional if cookie is set
X-Hasura-Role: <role>  # optional. Pass if only specific user role has access

{
    "type": "bulk",
    "args": [
        {
            "type": "select",
            "args": {
                "table": "article",
                "columns": ["*"]
            }
        },
        {
            "type": "select",
            "args": {
                "table": "author",
                "columns": ["*"]
            }
        }
    ]
}

The response of the above query will be an array of two elements with the first one containing the result from the article table and the second one containing the result from the author table.

A sample response will look like below

POST data.<cluster-name>.hasura-app.io/v1/query HTTP/1.1
Content-Type: application/json
Authorization: Bearer <auth-token> # optional if cookie is set
X-Hasura-Role: <role>  # optional. Pass if only specific user role has access

[
    [{
        "rating": 4,
        "author_id": 12,
        "content": "Vestibulum accumsan neque. Quisque ornare tortor.",
        "id": 1,
        "title": "sem ut dolor dapibus gravida."
    }],
    [{
        "name": "Chrissie",
        "id": 1
    }]
]

Note

In the above example we are sending two select queries in the bulk query. They can be any of the query types supported by Hasura. You can find the complete list here.

« previous | next »
Want to contribute or report missing content? Check out the github repo for docs.
Powered by Sphinx. Copyright © 2019 Hasura.