---
title: "Throw API Exception with Headers"
slug: "throw-api-exception-with-headers"
description: "Learn how the Throw API Exception with Headers step sends custom headers, exception messages, and HTTP error status codes from REST service Flows."
updated: 2026-05-15T20:33:42Z
published: 2026-05-15T20:33:42Z
canonical: "documentation.decisions.com/throw-api-exception-with-headers"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Throw API Exception with Headers

## Overview

| ## Step Details |
| --- |
| **Introduced in Version** | 7.9.0 |
| **Last Modified in Version** | 7.9.0 |
| **Location** | Flow Management > Error Handling |

The **Throw API Exception with Headers** step sends custom headers along with an exception message and HTTP error status code when Flows are called as REST services.

---

## Properties

| Property | Description | Data Type |
| --- | --- | --- |
| **Inputs** |
|  | Headers | Custom HTTPS headers that can be returned | List of HttpRequestHeaderObject |
|  | Message | Returned response message when the exception is thrown | String |
|  | Status Code | HTTP response code | Int32 |
| **Outputs** |
|  | None | --- | --- |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778790709089.png)