Makes an authenticated HTTP request to the GitLab API, and prints the response.
  The endpoint argument should either be a path of a GitLab API v4 endpoint, or
  `graphql` to access the GitLab GraphQL API.

  - [GitLab REST API documentation](https://docs.gitlab.com/api/)
  - [GitLab GraphQL documentation](https://docs.gitlab.com/api/graphql/)

  If the current directory is a Git directory, uses the GitLab authenticated host in the current
  directory. Otherwise, `gitlab.com` will be used.
  To override the GitLab hostname, use `--hostname`.

  These placeholder values, when used in the endpoint argument, are
  replaced with values from the repository of the current directory:

  - `:branch`
  - `:fullpath`
  - `:group`
  - `:id`
  - `:namespace`
  - `:repo`
  - `:user`
  - `:username`

  Methods: the default HTTP request method is `GET`, if no parameters are added,
  and `POST` otherwise. Override the method with `--method`.

  Pass one or more `--raw-field` values in `key=value` format to add
  JSON-encoded string parameters to the `POST` body.

  The `--field` flag behaves like `--raw-field` with magic type conversion based
  on the format of the value:

  - Literal values `true`, `false`, `null`, and integer numbers are converted to
    appropriate JSON types.
  - Values beginning with `[` or `{` are parsed as JSON arrays or objects. Invalid
    JSON and trailing data fail instead of being sent as strings. Leading whitespace
    before the bracket or brace prevents JSON parsing and remains part of a string.
  - Placeholder values `:namespace`, `:repo`, and `:branch` are populated with values
    from the repository of the current directory, including string leaves and keys
    inside JSON arrays and objects.
  - If the value starts with `@`, the rest of the value is interpreted as a
    filename to read the value from. Pass `-` to read from standard input.

  Placeholder substitutions in endpoint paths are URL-encoded as one path segment.
  In inferred fields they are sent unchanged; query serialization encodes them.
  Use --placeholder name=value to define a custom :name, without overriding a
  built-in placeholder. Raw fields do not expand custom placeholders.

  `--raw-field` always sends strings. A bracketed value such as
  `-f 'scopes=[api,read_api]'` is the literal string `"[api,read_api]"`, not an
  array; use `-F 'scopes=["api","read_api"]'` for a JSON array. On write methods,
  glab warns about the old bracketed shorthand without changing the value.

  Field names are not parsed into nested JSON. Bracketed names are supported only
  when fields become URL query parameters: explicit `GET` or `DELETE` requests, or
  requests where `--input` supplies the body. For example,
  `-X GET -f 'position[base_sha]=abc'` sends that literal percent-encoded query key.

  A query name ending in `[]` accumulates every repeated value in flag order:
  `-X GET -f 'ids[]=1' -f 'ids[]=2'`. For ordinary names, the last value from the
  same flag wins, and an inferred `--field` value wins over a `--raw-field` value
  with the same name regardless of ordering.

  Do not mix an explicit array query name with inferred JSON-array syntax for the
  same wire key. For example, `-f 'ids[]=1' -F 'ids=[2,3]'` is rejected. Bracketed
  names are also rejected for JSON request bodies; use a JSON value such as
  `-F 'position={"base_sha":"abc"}'`, `-F 'ids=[1,2]'`, or `--input` instead.

  For GraphQL requests, all fields other than `query` and `operationName` are
  interpreted as GraphQL variables.

  Use `--form` for multipart/form-data endpoints. Prefix a file value with `@`,
  or use `@-` once to read a file field from stdin. Do not combine `--form` with
  `--field`, `--raw-field`, or `--input`; every multipart field must use `--form`.

  Raw request body can be passed from the outside via a file specified by `--input`.
  Pass `-` to read from standard input. In this mode, parameters specified with
  `--field` flags are serialized into URL query parameters.

  In `--paginate` mode, all pages of results are requested sequentially until
  no more pages of results remain. For GraphQL requests:

  - The original query must accept an `$endCursor: String` variable.
  - The query must fetch the `pageInfo{ hasNextPage, endCursor }` set of fields from a collection.

  For REST pagination, glab follows the server-provided `Link` URL as-is. Query
  fields are not rebuilt on later pages, preventing duplicate filters or an
  overridden `page` parameter.

  The `--output` flag controls the output format:

  - `json` (default): Pretty-printed JSON. Arrays are output as a single JSON array.
  - `ndjson`: Newline-delimited JSON (also known as JSONL or JSON Lines). Each array element
    or object is output on a separate line. This format is more memory-efficient for large datasets
    and works well with tools like `jq`. See https://github.com/ndjson/ndjson-spec and
    https://jsonlines.org/ for format specifications.

  NDJSON output preserves JSON-number precision when decoding and re-encoding response values.
  Request fields that represent empty arrays are encoded as empty arrays rather than `null`.
  These guarantees matter for automation that consumes large numeric IDs or intentionally clears
  an array-valued API field; do not add string coercions or placeholder values as workarounds.

  USAGE

    glab api <endpoint> [--flags]

  EXAMPLES

    $ glab api projects/:fullpath/releases
    $ glab api projects/gitlab-com%2Fwww-gitlab-com/issues
    $ glab api issues --paginate
    $ glab api issues --paginate --output ndjson
    $ glab api issues --paginate --output ndjson | jq 'select(.state == "opened")'
    $ glab api graphql -f query="query { currentUser { username } }"
    $ glab api graphql -f query='
    query {
      project(fullPath: "gitlab-org/gitlab-docs") {
        name
        forksCount
        statistics {
          wikiSize
        }
        issuesEnabled
        boards {
          nodes {
            id
            name
          }
        }
      }
    }
    '

    $ glab api graphql --paginate -f query='
    query($endCursor: String) {
      project(fullPath: "gitlab-org/graphql-sandbox") {
        name
        issues(first: 2, after: $endCursor) {
          edges {
            node {
              title
            }
          }
          pageInfo {
            endCursor
            hasNextPage
          }
        }
      }
    }
    '

  FLAGS

    -F --field      Add a parameter of inferred type. Changes the default HTTP method to "POST".
    --form          Add a multipart form field. Prefix a file with @ or use @- once for stdin. Changes the default HTTP method to "POST".
    -H --header     Add an additional HTTP request header.
    -h --help       Show help for this command.
    --hostname      The GitLab hostname for the request. Defaults to 'gitlab.com', or the authenticated host in the current Git directory.
    -i --include    Include HTTP response headers in the output.
    --input         The file to use as the body for the HTTP request.
    -X --method     The HTTP method for the request. (GET)
    --output        Format output as: json, ndjson. (json)
    --paginate      Make additional HTTP requests to fetch all pages of results.
    --placeholder   Define a custom placeholder in <name>=<value> format, expanded from :<name>. Repeat the flag to define more than one.
    -f --raw-field  Add a string parameter.
    --silent        Do not print the response body.

glab api --help

DUO_WORKFLOW_WORKFLOW_ID=... glab api projects/:fullpath
GITLAB_DUO_SESSION_ID=... glab api projects/:fullpath

# A slash in the branch name is encoded as one path segment
glab api projects/:fullpath/repository/branches/:target \
  --placeholder target=feature/login

# Query serialization handles encoding; use GET explicitly
glab api projects/:fullpath/repository/branches -X GET \
  --placeholder term=feature/login -F search=:term

# JSON array
glab api projects/:fullpath --method PUT \
  -F 'topics=["platform","GitLab"]'

# Nested object; placeholders expand inside JSON strings
glab api graphql \
  -F 'query=mutation($input: ProjectInput!) { updateProject(input: $input) { errors } }' \
  -F 'input={"projectPath":":fullpath","labels":["automation"]}'

# Built-in filtering on a structured-output command
glab ci status --output=json --jq '.pipeline.status'

# Built-in filtering on another structured-output command
glab repo list --output=json --jq '.[].path_with_namespace'

# External jq is still useful for ndjson/stream-style processing
glab api issues --paginate --output ndjson | jq 'select(.state == "opened")'

# Project upload
glab api projects/:fullpath/uploads --method POST \
  --form "file=@./screenshot.png"

# Wiki attachment: both fields use --form
glab api projects/:fullpath/wikis/attachments --method POST \
  --form "file=@./screenshot.png" --form "branch=main"