class flask.Response(response=None, status=None, headers=None, mimetype=None, content_type=None, direct_passthrough=False)[source]

The response object that is used by default in Flask. Works like the response object from Werkzeug but is set to have an HTML mimetype by default. Quite often you don’t have to create this object yourself because make_response() will take care of that for you.

If you want to replace the response object used you can subclass this and set response_class to your subclass.


__init__([response, status, headers, ...])
add_etag([overwrite, weak]) Add an etag for the current response if there is none yet.
calculate_content_length() Returns the content length if available or None otherwise.
call_on_close(func) Adds a function to the internal list of functions that should be called as part of closing down the response.
close() Close the wrapped response if possible.
delete_cookie(key[, path, domain]) Delete a cookie.
force_type(response[, environ]) Enforce that the WSGI response is a response object of the current type.
freeze() Call this method if you want to make your response object ready for being pickled.
from_app(app, environ[, buffered]) Create a new response object from an application output.
get_app_iter(environ) Returns the application iterator for the given environ.
get_data([as_text]) The string representation of the request body.
get_etag() Return a tuple in the form (etag, is_weak).
get_wsgi_headers(environ) This is automatically called right before the response is started and returns headers modified for the given environment.
get_wsgi_response(environ) Returns the final WSGI response as tuple.
iter_encoded() Iter the response encoded with the encoding of the response.
make_conditional(request_or_environ) Make the response conditional to the request.
make_sequence() Converts the response iterator in a list.
set_cookie(key[, value, max_age, expires, ...]) Sets a cookie.
set_data(value) Sets a new string as response.
set_etag(etag[, weak]) Set the etag, and override the old one if there was one.


accept_ranges The Accept-Ranges header.
age The Age response-header field conveys the sender’s estimate of the amount of time since the response (or its revalidation) was generated at the origin server.
allow The Allow entity-header field lists the set of methods supported by the resource identified by the Request-URI.
cache_control The Cache-Control general-header field is used to specify directives that MUST be obeyed by all caching mechanisms along the request/response chain.
content_encoding The Content-Encoding entity-header field is used as a modifier to the media-type.
content_language The Content-Language entity-header field describes the natural language(s) of the intended audience for the enclosed entity.
content_length The Content-Length entity-header field indicates the size of the entity-body, in decimal number of OCTETs, sent to the recipient or, in the case of the HEAD method, the size of the entity-body that would have been sent had the request been a GET.
content_location The Content-Location entity-header field MAY be used to supply the resource location for the entity enclosed in the message when that entity is accessible from a location separate from the requested resource’s URI.
content_md5 The Content-MD5 entity-header field, as defined in RFC 1864, is an MD5 digest of the entity-body for the purpose of providing an end-to-end message integrity check (MIC) of the entity-body.
content_range The Content-Range header as ContentRange object.
content_type The Content-Type entity-header field indicates the media type of the entity-body sent to the recipient or, in the case of the HEAD method, the media type that would have been sent had the request been a GET.
data A descriptor that calls get_data() and set_data().
date The Date general-header field represents the date and time at which the message was originated, having the same semantics as orig-date in RFC 822.
expires The Expires entity-header field gives the date/time after which the response is considered stale.
is_sequence If the iterator is buffered, this property will be True.
is_streamed If the response is streamed (the response is not an iterable with a length information) this property is True.
last_modified The Last-Modified entity-header field indicates the date and time at which the origin server believes the variant was last modified.
location The Location response-header field is used to redirect the recipient to a location other than the Request-URI for completion of the request or identification of a new resource.
mimetype The mimetype (content type without charset etc.)
mimetype_params The mimetype parameters as dict.
retry_after The Retry-After response-header field can be used with a 503 (Service Unavailable) response to indicate how long the service is expected to be unavailable to the requesting client.
status The HTTP Status code
status_code The HTTP Status code as number
stream The response iterable as write-only stream.
vary The Vary field value indicates the set of request-header fields that fully determines, while the response is fresh, whether a cache is permitted to use the response to reply to a subsequent request without revalidation.
www_authenticate The WWW-Authenticate header in a parsed form.