Unfortunately the functions docs are very, very superficial and neither contain any information on how to access the incoming request (e.g. HTTP headers, source IP, etc.) nor on how to return anything else than text responses.

Thanks for the feedback. Here are some examples in Node.js to get you started. If you prefer other languages let us know but it’s the same model function to perform an HTTP redirect function main() { return { headers: { location: 'https://example.com' }, statusCode: 302 } } set a cookie and return some html function main() { return { headers: { 'Set-Cookie': 'UserID=Jane; Max-Age=3600; Version=', 'Content-Type': 'text/html' }, statusCode: 200, body: '<html><body><h3>hello</h3></body></html>' } } return image/png (or other binary content, must be base64 encode function main() { let png = <base 64 encoded string> return { headers: { 'Content-Type': 'image/png' }, statusCode: 200, body: png }; } return json (default response) function main(params) { return { statusCode: 200, headers: { 'Content-Type': 'application/json' }, body: params }; } The statusCode is optional and defaults to 200 OK. The headers are also optional. The body is required for a valid response. (This is the same as AWS Lambda.)

There are several properties available in the application’s context called __ow_headers, __ow_path, __ow_method which provide additional information about the calling context. These are available as arguments to the function. The first is the request headers, the second is the path segment (after your function name), and the last is the HTTP verb used to invoke the function. In addition the values __ow_query and __ow_body may be present (the latter base64 encoded) for binary and non-JSON input types. Here is an example JavaScript/Typescript repo that demonstrates how to use these.

Functions: how to access request info / return other response types

DigitalOcean

Featured AI Products
Compute
Build, deploy, and scale cloud compute resources
Containers and Images
Safely store and manage containers and backups
Managed Databases
Fully managed resources running popular database engines
Management and Dev Tools
Control infrastructure and gather insights
Networking
Secure and control traffic to apps
Security
Help protect your account and resources with these security features
Storage
Store and access any amount of data reliably in the cloud
Browse all products
AI/ML
CMS
Data and IoT
Developer Tools
Gaming and Media
Hosting
Security and Networking
Startups and SMBs
Web and App Platforms
See all solutions
Community
Documentation
Developer Tools
Get Involved
Utilities and Help
Become a Partner
Marketplace
Pricing

- Community
- DigitalOcean
- Community
- DigitalOcean

- Community
- DigitalOcean
- Community
- DigitalOcean

The developer cloud

Scale up as you grow — whether you're running one virtual machine or ten thousand.

View all products

Start building today

From GPU-powered inference and Kubernetes to managed databases and storage, get everything you need to build, scale, and deploy intelligent applications.

Become a contributor for community

DigitalOcean Documentation

Resources for startups and AI-native businesses

The developer cloud

Start building today

Report this

Functions: how to access request info / return other response types

Related questions

Why is my requirements.txt not being used?

How do I add requirements.txt to Digital Ocean's Serverless Functions? Runtime Python:3.11 does not have all the libraries I need Installed

Functions: file_get_contents for URLs

Modifier Cannot Access Namespace Function Using doctl CLI with Full Access Token

Does a DO function do npm install, or I need to manually upload the node_modules folder?

Why are environment variables being removed upon DO functions update?

Activation records and log messages not appearing for my Serverless Function

Request for Information Regarding SMTP Port Restrictions

Function exceeded limit in deployment - following structure of Typescript example?

Log forwarding from functions to logtail/Better Stack throws 401

App Platform: Internal communication between a service and a function

Unable to use python scripts from lib in functions

Report this

Functions: how to access request info / return other response types

Related questions

Why is my requirements.txt not being used?

How do I add requirements.txt to Digital Ocean's Serverless Functions? Runtime Python:3.11 does not have all the libraries I need Installed

Functions: file_get_contents for URLs

Modifier Cannot Access Namespace Function Using doctl CLI with Full Access Token

Does a DO function do npm install, or I need to manually upload the node_modules folder?

Why are environment variables being removed upon DO functions update?

Activation records and log messages not appearing for my Serverless Function

Request for Information Regarding SMTP Port Restrictions

Function exceeded limit in deployment - following structure of Typescript example?

Log forwarding from functions to logtail/Better Stack throws 401

App Platform: Internal communication between a service and a function

Unable to use python scripts from lib in functions