AssertionError when trying to POST with bearer auth

[Khayet]

Checklist

• I've searched for similar issues.
• I'm using the latest version of HTTPie.

---

Minimal reproduction code and steps

/Users/Khayet https POST --auth-type bearer --auth $TOKEN "https://example.org"

Current result

Traceback (most recent call last):
  File "/opt/homebrew/bin/http", line 8, in <module>
    sys.exit(main())
             ~~~~^^
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/__main__.py", line 9, in main
    exit_status = main()
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/core.py", line 162, in main
    return raw_main(
        parser=parser,
    ...<2 lines>...
        env=env
    )
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/core.py", line 77, in raw_main
    parsed_args = parser.parse_args(
        args=args,
        env=env,
    )
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/cli/argparser.py", line 176, in parse_args
    self._guess_method()
    ~~~~~~~~~~~~~~~~~~^^
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/cli/argparser.py", line 416, in _guess_method
    assert not self.args.request_items
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
AssertionError

Expected result

Probably an error message telling me what is wrong about the invocation and how to do it correctly. I'm new to httpie and guess that I did something wrong but I don't know what. https --help is telling me that the method parameter comes directly after the https command but maybe the problem is that the url is in the wrong place and httpie gets confused due to the auth parameters?

Debug output

Please re-run the command with --debug, then copy the entire command & output and paste both below:

/Users/Khayet https POST --auth-type bearer --auth $TOKEN "https://example.org" --debug
HTTPie 3.2.4
Requests 2.32.3
Pygments 2.18.0
Python 3.13.1 (main, Dec  3 2024, 17:59:52) [Clang 16.0.0 (clang-1600.0.26.4)]
/opt/homebrew/Cellar/httpie/3.2.4/libexec/bin/python
Darwin 24.3.0

<Environment {'apply_warnings_filter': <function Environment.apply_warnings_filter at 0x106628220>,
 'args': Namespace(),
 'as_silent': <function Environment.as_silent at 0x1066280e0>,
 'colors': 256,
 'config': {'default_options': []},
 'config_dir': PosixPath('/Users/jakob.herpel/.config/httpie'),
 'devnull': <property object at 0x106609530>,
 'is_windows': False,
 'log_error': <function Environment.log_error at 0x106628180>,
 'program_name': 'http',
 'quiet': 0,
 'rich_console': <functools.cached_property object at 0x105ba1fd0>,
 'rich_error_console': <functools.cached_property object at 0x1066005a0>,
 'show_displays': True,
 'stderr': <_io.TextIOWrapper name='<stderr>' mode='w' encoding='utf-8'>,
 'stderr_isatty': True,
 'stdin': <_io.TextIOWrapper name='<stdin>' mode='r' encoding='utf-8'>,
 'stdin_encoding': 'utf-8',
 'stdin_isatty': True,
 'stdout': <_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>,
 'stdout_encoding': 'utf-8',
 'stdout_isatty': True}>

<PluginManager {'adapters': [],
 'auth': [<class 'httpie.plugins.builtin.BasicAuthPlugin'>,
          <class 'httpie.plugins.builtin.DigestAuthPlugin'>,
          <class 'httpie.plugins.builtin.BearerAuthPlugin'>],
 'converters': [],
 'formatters': [<class 'httpie.output.formatters.headers.HeadersFormatter'>,
                <class 'httpie.output.formatters.json.JSONFormatter'>,
                <class 'httpie.output.formatters.xml.XMLFormatter'>,
                <class 'httpie.output.formatters.colors.ColorFormatter'>]}>
Traceback (most recent call last):
  File "/opt/homebrew/bin/http", line 8, in <module>
    sys.exit(main())
             ~~~~^^
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/__main__.py", line 9, in main
    exit_status = main()
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/core.py", line 162, in main
    return raw_main(
        parser=parser,
    ...<2 lines>...
        env=env
    )
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/core.py", line 77, in raw_main
    parsed_args = parser.parse_args(
        args=args,
        env=env,
    )
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/cli/argparser.py", line 176, in parse_args
    self._guess_method()
    ~~~~~~~~~~~~~~~~~~^^
  File "/opt/homebrew/Cellar/httpie/3.2.4/libexec/lib/python3.13/site-packages/httpie/cli/argparser.py", line 416, in _guess_method
    assert not self.args.request_items
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
AssertionError

Additional information, screenshots, or code examples

…

[alp1n3-eth]

I don't have a solution for the codebase regarding the error, but I think I see where the problem popped up. I'm also very new to this tool (as a warning). In the section of the docs describing working with bearer auth it gives this command as an example:

https -A bearer -a token pie.dev/bearer

Which will result in the same error that you posted, and I was able to reproduce it. Looking at a different section of the docs, and the help page from the program reveals that the tool requires a different syntax to be followed:

https POST https://{{ URL }} -A bearer -a {{ TOKEN }}

The help output references the usage:

usage:
    http [METHOD] URL [REQUEST_ITEM ...]

Which appears to require the URL to come after the method, instead of allowing it at the end like the first example. Not sure if this is just a documentation issue, but I agree that it could also use a more user-friendly error there anyways.