Pattern: Serverless Long Running HTTP Requests in AWS

Joarley Moraes
Nov 24, 2017 · 3 min read

The serverless way to deploy web applications in AWS usually involves hooking up API Gateway with Lambda. If you done this, chances are you have ran into a built-in constraint: the timeout. These products are designed to run microservices, which are expected to be micro, duration-wise as well 😆. However, there are some use cases for which our web app needs to handle long runnings tasks. In this article, I will share with you an HTTP pattern to accomplish that while still being serverless.


So the first realization is that the full Lambda timeout is useless because the request is fronted by API Gateway. So for serverless architectures using API Gateway and whatever integration backend, we have to do our thing under 29s! 😓

There are plenty of use cases I can see that would need more than 29 s. But that’s not important right now. We have first to understand our pattern’s goal:

We want to respond to the request quickly and perform the long running task on the background.

Simple, right ? This is also called Asynchronous processing.

Let’s it break it down into three parts: i) initial request/response; ii) background processing; iii) polling.

Initial Request/Response

Section 6.3.3 of RFC 7231

The 202 (Accepted) status code indicates that the request has been accepted for processing, but the processing has not been completed.

That’s precisely what we are doing here. The last piece of information we need to include is the URI Locationof our job. We do this by adding the Location header to the HTTP response, which will look like:

HTTP 202
Location: jobs/1234

All of this can be easily executed in under 29s. 😁

Background Processing

Once processing is completed, the function must update the status of Job in the database. Something like my_job.status = 'DONE'.


GET jobs/1234
{"status": "RUNNING"}

Clients should send requests with care so not to overload the server with too many requests. A good strategy is to perform polls with Exponential Backoff.


Thanks to Cloudcraft for this nice diagram :)

That’s It

Liked it ? Share this with your friends. And give it a Clap to help spread the word.


All things serverless (

Joarley Moraes

Written by

Probably building something. 💡🚀


All things serverless (