> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usebruno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bru Tag Reference

## meta

Store metadata about your request

```bash theme={null}
meta {
  name: Get users
  type: http
  seq: 1
  tags: [
    smoke
    sanity
  ]
}
```

The `seq` is used to store the sequence number. This decides the sort position of your request in the UI.
The `type` can be either `http` or `graphql`
The `tags` is an array of strings that can be used to filter requests during collection runs. Tags are useful for organizing and selectively running requests based on categories like environment, functionality, or priority.

## get

Make a `GET` http call

```bash theme={null}
get {
  url: https://api.github.com/users/usebruno
}
```

## post

Make a `POST` http call

```bash theme={null}
post {
  url: https://api.github.com/users/usebruno
}
```

## put

Make a `PUT` http call

```bash theme={null}
put {
  url: https://api.github.com/users/usebruno
}
```

## delete

Make a `DELETE` http call

```bash theme={null}
delete {
  url: https://api.github.com/users/usebruno
}
```

## options

Make a get `OPTIONS` call

```bash theme={null}
options {
  url: https://api.github.com/users/usebruno
}
```

## trace

Make a `TRACE` http call

```bash theme={null}
trace {
  url: https://api.github.com/users/usebruno
}
```

## connect

Make a `CONNECT` http call

```bash theme={null}
connect {
  url: https://api.github.com/users/usebruno
}
```

## head

Make a `HEAD` http call

```bash theme={null}
head {
  url: https://api.github.com/users/usebruno
}
```

## query

The request query params

```bash theme={null}
get {
  url: https://api.textlocal.in/send?apiKey=secret&numbers=9988776655&message=hello
}

params:query {
  apiKey: secret
  numbers: 9988776655
  message: hello
}
```

## path

The request path params

```bash theme={null}
get {
  url: https://api.textlocal.in/user/:userId
}

params:path {
  userId: 13
}
```

## headers

The request query headers

```bash theme={null}
get {
  url: https://api.textlocal.in/send?apiKey=secret&numbers=9988776655&message=hello
}

headers {
  content-type: application/json
  Authorization: Bearer topsecret
}
```

## body

The request body (defaults to json)

```bash theme={null}
body {
  {
    username: 'john',
    password: 'governingdynamics'
  }
}
```

## body:text

The request body as text

```bash theme={null}
body:text {
  This is a text body
}
```

## body:xml

The request body as xml

```bash theme={null}
body:xml {
  <xml>
    <name>John</name>
    <age>30</age>
  </xml>
}
```

## body:form-urlencoded

The request body as form-urlencoded

```bash theme={null}
body:form-urlencoded {
  apikey: secret
  numbers: +91998877665
  ~message: hello
}
```

## body:multipart-form

The request body as multipart-form

```bash theme={null}
body:multipart-form {
  apikey: secret
  numbers: +91998877665
  ~message: hello
}
```

## body:graphql

The request body as graphql

```bash theme={null}
body:graphql {
  {
    launchesPast {
      launch_site {
        site_name
      }
      launch_success
    }
  }
}
```

## body:graphql:vars

The request body as graphql vars

```bash theme={null}
body:graphql:vars {
  {
    "limit": 5
  }
}
```

## script:pre-request

The request body as pre-request

```bash theme={null}
script:pre-request {
  req.setHeader("Authorization", "{{token}}");
}
```

## script:post-response

The request body as post-response

```bash theme={null}
script:post-response {
  bru.setVar("token", res.body.token);
}
```

## test

The tests

```bash theme={null}
body:test {
  expect(res.status).to.equal(200);
}
```