post() — requests Function Reference

Architecture documentation for the post() function in api.py from the requests codebase.

Function python CoreAPI SessionLifecycle calls 1

Entity Profile

CoreAPI→ SessionLifecycle→ post() — requests Function Reference

Dependency Diagram

graph TD
  29f1906d_9174_948c_0188_772a5120ef97["post()"]
  b9426d6e_b47d_565b_5251_7d3a1c1dfbd1["api.py"]
  29f1906d_9174_948c_0188_772a5120ef97 -->|defined in| b9426d6e_b47d_565b_5251_7d3a1c1dfbd1
  8f0a1008_20a1_45d8_2ae7_96c1a7562216["request()"]
  29f1906d_9174_948c_0188_772a5120ef97 -->|calls| 8f0a1008_20a1_45d8_2ae7_96c1a7562216
  style 29f1906d_9174_948c_0188_772a5120ef97 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/requests/api.py lines 103–115

def post(url, data=None, json=None, **kwargs):
    r"""Sends a POST request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    return request("post", url, data=data, json=json, **kwargs)