<div align="center">
        <img src="https://github.com/user-attachments/assets/b643774e-4edd-4312-adda-1d75d0c36661" width="200">
   <p>On-call, incident response and status pages all under one roof.</p>
   <a href="https://api-docs.incident.io/"><img src="https://img.shields.io/static/v1?label=Docs&message=API Ref&color=000000&style=for-the-badge" /></a>
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" /></a>
</div>

> [!NOTE]  
> Please note this SDK has not been tested and is not yet for production use. It is primarily to showcase Speakeasy's generation capabilities using the Incident.io OpenAPI specification

<!-- Start Summary [summary] -->
## Summary

incident.io: This is the API reference for incident.io.

It documents available API endpoints, provides examples of how to use it, and
instructions around things like authentication and error handling.

The API is hosted at:

- https://api.incident.io/

And you will need to create an API key via your [incident.io
dashboard](https://app.incident.io/settings/api-keys) to make requests.

# Making requests

Here are the key concepts required to make requests to the incident.io API.

## Authentication

For all requests made to the incident.io API, you'll need an API key.

To create an API key, head to the incident dashboard and visit [API
keys](https://app.incident.io/settings/api-keys). When you create the key,
you'll be able to choose what actions it can take for your account: choose
carefully, as those roles can only be set when you first create the key. We'll
only show you the token once, so make sure you store it somewhere safe.

Once you have the key, you should make requests to the API that set the
`Authorization` request header using a "Bearer" authentication scheme:

```
Authorization: Bearer <YOUR_API_KEY>
```

## Errors

We use standard HTTP response codes to indicate the status or failure of API
requests.

The API response body will be JSON, and contain more detailed information on the
nature of the error.

An example error when a request is made without an API key:

```json
{
  "type": "authentication_error",
  "status": 401,
  "request_id": "8e3cc412-b49d-4957-9073-2c19d2c61804",
  "errors": [
    {
      "code": "missing_authorization_material",
      "message": "No authorization material provided in request"
    }
  ]
}
```

Note that the error:

- Contains the HTTP status (`401`)
- References the type of error (`authentication_error`)
- Includes a `request_id` that can be provided to incident.io support to help
	debug questions with your API request
- Provides a list of individual errors, which go into detail about why the error
	occurred

The most common error will be a 422 Validation Error, which is returned when the
request was rejected due to failing validations.

These errors look like this:

```json
{
  "type": "validation_error",
  "status": 422,
  "request_id": "631766c4-4afd-4803-997c-cd700928fa4b",
  "errors": [
    {
      "code": "is_required",
      "message": "A severity is required to open an incident",
      "source": {
        "field": "severity_id"
      }
    }
  ]
}
```

This error is caused by not providing a severity identifier, which should be at
the `severity_id` field of the request payload. Errors like these can be mapped to
forms, should you be integrating with the API from a user-interface.

## Compatibility

We won't make breaking changes to existing API services or endpoints, but will
expect integrators to upgrade themselves to the latest API endpoints within 3
months of us deprecating the old service.

We will make changes that are considered backwards compatible, which include:

- Adding new API endpoints and services
- Adding new properties to responses from existing API endpoints
- Reordering properties returned from existing API endpoints
- Adding optional request parameters to existing API endpoints
- Altering the format or length of IDs
- Adding new values to enums

It is important that clients are robust to these changes, to ensure reliable
integrations.

As an example, if you are generating a client using an openapi-generator, ensure
the generated client is configured to support unknown enum values, often
configured via the `enumUnknownDefaultCase` parameter.

When breaking changes are unavoidable, we'll create a new service version on a
separate path, and run them in parallel.

For example:

- https://api.incident.io/v1/incidents
- https://api.incident.io/v2/incidents

For any questions, email support@incident.io.
<!-- End Summary [summary] -->

<!-- Start Table of Contents [toc] -->
## Table of Contents

* [SDK Installation](#sdk-installation)
* [Requirements](#requirements)
* [SDK Example Usage](#sdk-example-usage)
* [Available Resources and Operations](#available-resources-and-operations)
* [Standalone functions](#standalone-functions)
* [Retries](#retries)
* [Error Handling](#error-handling)
* [Server Selection](#server-selection)
* [Custom HTTP Client](#custom-http-client)
* [Debugging](#debugging)
<!-- End Table of Contents [toc] -->

<!-- Start SDK Installation [installation] -->
## SDK Installation

The SDK can be installed with either [npm](https://www.npmjs.com/), [pnpm](https://pnpm.io/), [bun](https://bun.sh/) or [yarn](https://classic.yarnpkg.com/en/) package managers.

### NPM

```bash
npm add incidentio
```

### PNPM

```bash
pnpm add incidentio
```

### Bun

```bash
bun add incidentio
```

### Yarn

```bash
yarn add incidentio zod

# Note that Yarn does not install peer dependencies automatically. You will need
# to install zod as shown above.
```
<!-- End SDK Installation [installation] -->

<!-- Start Requirements [requirements] -->
## Requirements

For supported JavaScript runtimes, please consult [RUNTIMES.md](RUNTIMES.md).
<!-- End Requirements [requirements] -->

<!-- Start SDK Example Usage [usage] -->
## SDK Example Usage

### Example

```typescript
import { Incidentio } from "incidentio";

const incidentio = new Incidentio();

async function run() {
  const result = await incidentio.actions.list({
    incidentId: "01FCNDV6P870EA6S7TK1DSYDG0",
    isFollowUp: true,
    incidentMode: "real",
  });

  // Handle the result
  console.log(result);
}

run();

```
<!-- End SDK Example Usage [usage] -->

<!-- Start Available Resources and Operations [operations] -->
## Available Resources and Operations

<details open>
<summary>Available methods</summary>

### [~~actions~~](docs/sdks/actions/README.md)

* [~~list~~](docs/sdks/actions/README.md#list) - List Actions V1 :warning: **Deprecated**
* [~~get~~](docs/sdks/actions/README.md#get) - Show Actions V1 :warning: **Deprecated**

### [actionsV2](docs/sdks/actionsv2/README.md)

* [list](docs/sdks/actionsv2/README.md#list) - List Actions V2
* [get](docs/sdks/actionsv2/README.md#get) - Show Actions V2

### [alertEvents](docs/sdks/alertevents/README.md)

* [createHTTP](docs/sdks/alertevents/README.md#createhttp) - CreateHTTP Alert Events V2

### [alertRoutes](docs/sdks/alertroutes/README.md)

* [create](docs/sdks/alertroutes/README.md#create) - Create Alert Routes V2
* [delete](docs/sdks/alertroutes/README.md#delete) - Destroy Alert Routes V2
* [show](docs/sdks/alertroutes/README.md#show) - Show Alert Routes V2
* [update](docs/sdks/alertroutes/README.md#update) - Update Alert Routes V2

### [catalogEntries](docs/sdks/catalogentries/README.md)

* [list](docs/sdks/catalogentries/README.md#list) - ListEntries Catalog V2
* [create](docs/sdks/catalogentries/README.md#create) - CreateEntry Catalog V2
* [delete](docs/sdks/catalogentries/README.md#delete) - DestroyEntry Catalog V2
* [show](docs/sdks/catalogentries/README.md#show) - ShowEntry Catalog V2
* [update](docs/sdks/catalogentries/README.md#update) - UpdateEntry Catalog V2

### [catalogResources](docs/sdks/catalogresources/README.md)

* [list](docs/sdks/catalogresources/README.md#list) - ListResources Catalog V2

### [catalogTypes](docs/sdks/catalogtypes/README.md)

* [list](docs/sdks/catalogtypes/README.md#list) - ListTypes Catalog V2
* [create](docs/sdks/catalogtypes/README.md#create) - CreateType Catalog V2
* [delete](docs/sdks/catalogtypes/README.md#delete) - DestroyType Catalog V2
* [show](docs/sdks/catalogtypes/README.md#show) - ShowType Catalog V2
* [update](docs/sdks/catalogtypes/README.md#update) - UpdateType Catalog V2
* [updateSchema](docs/sdks/catalogtypes/README.md#updateschema) - UpdateTypeSchema Catalog V2

### [customFieldOptions](docs/sdks/customfieldoptions/README.md)

* [list](docs/sdks/customfieldoptions/README.md#list) - List Custom Field Options V1
* [create](docs/sdks/customfieldoptions/README.md#create) - Create Custom Field Options V1
* [delete](docs/sdks/customfieldoptions/README.md#delete) - Delete Custom Field Options V1
* [get](docs/sdks/customfieldoptions/README.md#get) - Show Custom Field Options V1
* [update](docs/sdks/customfieldoptions/README.md#update) - Update Custom Field Options V1

### [customFields](docs/sdks/customfields/README.md)

* [create](docs/sdks/customfields/README.md#create) - Create Custom Fields V2
* [delete](docs/sdks/customfields/README.md#delete) - Delete Custom Fields V2
* [get](docs/sdks/customfields/README.md#get) - Show Custom Fields V2
* [update](docs/sdks/customfields/README.md#update) - Update Custom Fields V2

### [customFieldsV2](docs/sdks/customfieldsv2/README.md)

* [list](docs/sdks/customfieldsv2/README.md#list) - List Custom Fields V2

### [escalationPaths](docs/sdks/escalationpaths/README.md)

* [create](docs/sdks/escalationpaths/README.md#create) - CreatePath Escalations V2
* [delete](docs/sdks/escalationpaths/README.md#delete) - DestroyPath Escalations V2
* [get](docs/sdks/escalationpaths/README.md#get) - ShowPath Escalations V2
* [update](docs/sdks/escalationpaths/README.md#update) - UpdatePath Escalations V2

### [followUps](docs/sdks/followups/README.md)

* [list](docs/sdks/followups/README.md#list) - List Follow-ups V2
* [get](docs/sdks/followups/README.md#get) - Show Follow-ups V2

### [incidentAttachments](docs/sdks/incidentattachments/README.md)

* [list](docs/sdks/incidentattachments/README.md#list) - List Incident Attachments V1
* [create](docs/sdks/incidentattachments/README.md#create) - Create Incident Attachments V1
* [delete](docs/sdks/incidentattachments/README.md#delete) - Delete Incident Attachments V1


### [incidentMemberships](docs/sdks/incidentmemberships/README.md)

* [create](docs/sdks/incidentmemberships/README.md#create) - Create Incident Memberships V1
* [revoke](docs/sdks/incidentmemberships/README.md#revoke) - Revoke Incident Memberships V1

### [incidentRoles](docs/sdks/incidentroles/README.md)

* [list](docs/sdks/incidentroles/README.md#list) - List Incident Roles V2
* [create](docs/sdks/incidentroles/README.md#create) - Create Incident Roles V2
* [delete](docs/sdks/incidentroles/README.md#delete) - Delete Incident Roles V2
* [get](docs/sdks/incidentroles/README.md#get) - Show Incident Roles V2
* [update](docs/sdks/incidentroles/README.md#update) - Update Incident Roles V2

### [incidents](docs/sdks/incidents/README.md)

* [list](docs/sdks/incidents/README.md#list) - List Incidents V2
* [create](docs/sdks/incidents/README.md#create) - Create Incidents V2
* [get](docs/sdks/incidents/README.md#get) - Show Incidents V2
* [update](docs/sdks/incidents/README.md#update) - Edit Incidents V2

### [incidentStatuses](docs/sdks/incidentstatuses/README.md)

* [list](docs/sdks/incidentstatuses/README.md#list) - List Incident Statuses V1
* [create](docs/sdks/incidentstatuses/README.md#create) - Create Incident Statuses V1
* [delete](docs/sdks/incidentstatuses/README.md#delete) - Delete Incident Statuses V1
* [get](docs/sdks/incidentstatuses/README.md#get) - Show Incident Statuses V1
* [update](docs/sdks/incidentstatuses/README.md#update) - Update Incident Statuses V1

### [~~incidentsV1~~](docs/sdks/incidentsv1/README.md)

* [~~list~~](docs/sdks/incidentsv1/README.md#list) - List Incidents V1 :warning: **Deprecated**
* [~~create~~](docs/sdks/incidentsv1/README.md#create) - Create Incidents V1 :warning: **Deprecated**
* [~~get~~](docs/sdks/incidentsv1/README.md#get) - Show Incidents V1 :warning: **Deprecated**

### [incidentTimestamps](docs/sdks/incidenttimestamps/README.md)

* [list](docs/sdks/incidenttimestamps/README.md#list) - List Incident Timestamps V2
* [get](docs/sdks/incidenttimestamps/README.md#get) - Show Incident Timestamps V2

### [incidentTypes](docs/sdks/incidenttypes/README.md)

* [list](docs/sdks/incidenttypes/README.md#list) - List Incident Types V1
* [get](docs/sdks/incidenttypes/README.md#get) - Show Incident Types V1

### [incidentUpdates](docs/sdks/incidentupdates/README.md)

* [list](docs/sdks/incidentupdates/README.md#list) - List Incident Updates V2

### [scheduleEntries](docs/sdks/scheduleentries/README.md)

* [list](docs/sdks/scheduleentries/README.md#list) - ListScheduleEntries Schedules V2

### [schedules](docs/sdks/schedules/README.md)

* [list](docs/sdks/schedules/README.md#list) - List Schedules V2
* [create](docs/sdks/schedules/README.md#create) - Create Schedules V2
* [delete](docs/sdks/schedules/README.md#delete) - Destroy Schedules V2
* [get](docs/sdks/schedules/README.md#get) - Show Schedules V2
* [update](docs/sdks/schedules/README.md#update) - Update Schedules V2

### [severities](docs/sdks/severities/README.md)

* [list](docs/sdks/severities/README.md#list) - List Severities V1
* [create](docs/sdks/severities/README.md#create) - Create Severities V1
* [delete](docs/sdks/severities/README.md#delete) - Delete Severities V1
* [get](docs/sdks/severities/README.md#get) - Show Severities V1
* [update](docs/sdks/severities/README.md#update) - Update Severities V1

### [users](docs/sdks/users/README.md)

* [list](docs/sdks/users/README.md#list) - List Users V2
* [get](docs/sdks/users/README.md#get) - Show Users V2

### [utilities](docs/sdks/utilities/README.md)

* [identity](docs/sdks/utilities/README.md#identity) - Identity Utilities V1
* [getOpenAPI](docs/sdks/utilities/README.md#getopenapi) - OpenAPI Utilities V1
* [getOpenApiv3](docs/sdks/utilities/README.md#getopenapiv3) - OpenAPIV3 Utilities V1

### [workflows](docs/sdks/workflows/README.md)

* [list](docs/sdks/workflows/README.md#list) - ListWorkflows Workflows V2
* [create](docs/sdks/workflows/README.md#create) - CreateWorkflow Workflows V2
* [delete](docs/sdks/workflows/README.md#delete) - DestroyWorkflow Workflows V2
* [get](docs/sdks/workflows/README.md#get) - ShowWorkflow Workflows V2
* [update](docs/sdks/workflows/README.md#update) - UpdateWorkflow Workflows V2

</details>
<!-- End Available Resources and Operations [operations] -->

<!-- Start Standalone functions [standalone-funcs] -->
## Standalone functions

All the methods listed above are available as standalone functions. These
functions are ideal for use in applications running in the browser, serverless
runtimes or other environments where application bundle size is a primary
concern. When using a bundler to build your application, all unused
functionality will be either excluded from the final bundle or tree-shaken away.

To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).

<details>

<summary>Available standalone functions</summary>

- [actionsGet](docs/sdks/actions/README.md#get)
- [actionsList](docs/sdks/actions/README.md#list)
- [actionsV2Get](docs/sdks/actionsv2/README.md#get)
- [actionsV2List](docs/sdks/actionsv2/README.md#list)
- [alertEventsCreateHTTP](docs/sdks/alertevents/README.md#createhttp)
- [alertRoutesCreate](docs/sdks/alertroutes/README.md#create)
- [alertRoutesDelete](docs/sdks/alertroutes/README.md#delete)
- [alertRoutesShow](docs/sdks/alertroutes/README.md#show)
- [alertRoutesUpdate](docs/sdks/alertroutes/README.md#update)
- [catalogEntriesCreate](docs/sdks/catalogentries/README.md#create)
- [catalogEntriesDelete](docs/sdks/catalogentries/README.md#delete)
- [catalogEntriesList](docs/sdks/catalogentries/README.md#list)
- [catalogEntriesShow](docs/sdks/catalogentries/README.md#show)
- [catalogEntriesUpdate](docs/sdks/catalogentries/README.md#update)
- [catalogResourcesList](docs/sdks/catalogresources/README.md#list)
- [catalogTypesCreate](docs/sdks/catalogtypes/README.md#create)
- [catalogTypesDelete](docs/sdks/catalogtypes/README.md#delete)
- [catalogTypesList](docs/sdks/catalogtypes/README.md#list)
- [catalogTypesShow](docs/sdks/catalogtypes/README.md#show)
- [catalogTypesUpdateSchema](docs/sdks/catalogtypes/README.md#updateschema)
- [catalogTypesUpdate](docs/sdks/catalogtypes/README.md#update)
- [customFieldOptionsCreate](docs/sdks/customfieldoptions/README.md#create)
- [customFieldOptionsDelete](docs/sdks/customfieldoptions/README.md#delete)
- [customFieldOptionsGet](docs/sdks/customfieldoptions/README.md#get)
- [customFieldOptionsList](docs/sdks/customfieldoptions/README.md#list)
- [customFieldOptionsUpdate](docs/sdks/customfieldoptions/README.md#update)
- [customFieldsCreate](docs/sdks/customfields/README.md#create)
- [customFieldsDelete](docs/sdks/customfields/README.md#delete)
- [customFieldsGet](docs/sdks/customfields/README.md#get)
- [customFieldsUpdate](docs/sdks/customfields/README.md#update)
- [customFieldsV2List](docs/sdks/customfieldsv2/README.md#list)
- [escalationPathsCreate](docs/sdks/escalationpaths/README.md#create)
- [escalationPathsDelete](docs/sdks/escalationpaths/README.md#delete)
- [escalationPathsGet](docs/sdks/escalationpaths/README.md#get)
- [escalationPathsUpdate](docs/sdks/escalationpaths/README.md#update)
- [followUpsGet](docs/sdks/followups/README.md#get)
- [followUpsList](docs/sdks/followups/README.md#list)
- [incidentAttachmentsCreate](docs/sdks/incidentattachments/README.md#create)
- [incidentAttachmentsDelete](docs/sdks/incidentattachments/README.md#delete)
- [incidentAttachmentsList](docs/sdks/incidentattachments/README.md#list)
- [incidentMembershipsCreate](docs/sdks/incidentmemberships/README.md#create)
- [incidentMembershipsRevoke](docs/sdks/incidentmemberships/README.md#revoke)
- [incidentRolesCreate](docs/sdks/incidentroles/README.md#create)
- [incidentRolesDelete](docs/sdks/incidentroles/README.md#delete)
- [incidentRolesGet](docs/sdks/incidentroles/README.md#get)
- [incidentRolesList](docs/sdks/incidentroles/README.md#list)
- [incidentRolesUpdate](docs/sdks/incidentroles/README.md#update)
- [incidentStatusesCreate](docs/sdks/incidentstatuses/README.md#create)
- [incidentStatusesDelete](docs/sdks/incidentstatuses/README.md#delete)
- [incidentStatusesGet](docs/sdks/incidentstatuses/README.md#get)
- [incidentStatusesList](docs/sdks/incidentstatuses/README.md#list)
- [incidentStatusesUpdate](docs/sdks/incidentstatuses/README.md#update)
- [incidentTimestampsGet](docs/sdks/incidenttimestamps/README.md#get)
- [incidentTimestampsList](docs/sdks/incidenttimestamps/README.md#list)
- [incidentTypesGet](docs/sdks/incidenttypes/README.md#get)
- [incidentTypesList](docs/sdks/incidenttypes/README.md#list)
- [incidentUpdatesList](docs/sdks/incidentupdates/README.md#list)
- [incidentsCreate](docs/sdks/incidents/README.md#create)
- [incidentsGet](docs/sdks/incidents/README.md#get)
- [incidentsList](docs/sdks/incidents/README.md#list)
- [incidentsUpdate](docs/sdks/incidents/README.md#update)
- [incidentsV1Create](docs/sdks/incidentsv1/README.md#create)
- [incidentsV1Get](docs/sdks/incidentsv1/README.md#get)
- [incidentsV1List](docs/sdks/incidentsv1/README.md#list)
- [scheduleEntriesList](docs/sdks/scheduleentries/README.md#list)
- [schedulesCreate](docs/sdks/schedules/README.md#create)
- [schedulesDelete](docs/sdks/schedules/README.md#delete)
- [schedulesGet](docs/sdks/schedules/README.md#get)
- [schedulesList](docs/sdks/schedules/README.md#list)
- [schedulesUpdate](docs/sdks/schedules/README.md#update)
- [severitiesCreate](docs/sdks/severities/README.md#create)
- [severitiesDelete](docs/sdks/severities/README.md#delete)
- [severitiesGet](docs/sdks/severities/README.md#get)
- [severitiesList](docs/sdks/severities/README.md#list)
- [severitiesUpdate](docs/sdks/severities/README.md#update)
- [usersGet](docs/sdks/users/README.md#get)
- [usersList](docs/sdks/users/README.md#list)
- [utilitiesGetOpenAPI](docs/sdks/utilities/README.md#getopenapi)
- [utilitiesGetOpenApiv3](docs/sdks/utilities/README.md#getopenapiv3)
- [utilitiesIdentity](docs/sdks/utilities/README.md#identity)
- [workflowsCreate](docs/sdks/workflows/README.md#create)
- [workflowsDelete](docs/sdks/workflows/README.md#delete)
- [workflowsGet](docs/sdks/workflows/README.md#get)
- [workflowsList](docs/sdks/workflows/README.md#list)
- [workflowsUpdate](docs/sdks/workflows/README.md#update)


</details>
<!-- End Standalone functions [standalone-funcs] -->

<!-- Start Retries [retries] -->
## Retries

Some of the endpoints in this SDK support retries.  If you use the SDK without any configuration, it will fall back to the default retry strategy provided by the API.  However, the default retry strategy can be overridden on a per-operation basis, or across the entire SDK.

To change the default retry strategy for a single API call, simply provide a retryConfig object to the call:
```typescript
import { Incidentio } from "incidentio";

const incidentio = new Incidentio();

async function run() {
  const result = await incidentio.actions.list({
    incidentId: "01FCNDV6P870EA6S7TK1DSYDG0",
    isFollowUp: true,
    incidentMode: "real",
  }, {
    retries: {
      strategy: "backoff",
      backoff: {
        initialInterval: 1,
        maxInterval: 50,
        exponent: 1.1,
        maxElapsedTime: 100,
      },
      retryConnectionErrors: false,
    },
  });

  // Handle the result
  console.log(result);
}

run();

```

If you'd like to override the default retry strategy for all operations that support retries, you can provide a retryConfig at SDK initialization:
```typescript
import { Incidentio } from "incidentio";

const incidentio = new Incidentio({
  retryConfig: {
    strategy: "backoff",
    backoff: {
      initialInterval: 1,
      maxInterval: 50,
      exponent: 1.1,
      maxElapsedTime: 100,
    },
    retryConnectionErrors: false,
  },
});

async function run() {
  const result = await incidentio.actions.list({
    incidentId: "01FCNDV6P870EA6S7TK1DSYDG0",
    isFollowUp: true,
    incidentMode: "real",
  });

  // Handle the result
  console.log(result);
}

run();

```
<!-- End Retries [retries] -->

<!-- Start Error Handling [errors] -->
## Error Handling

All SDK methods return a response object or throw an error. If Error objects are specified in your OpenAPI Spec, the SDK will throw the appropriate Error type.

| Error Object    | Status Code     | Content Type    |
| --------------- | --------------- | --------------- |
| errors.SDKError | 4xx-5xx         | */*             |

Validation errors can also occur when either method arguments or data returned from the server do not match the expected format. The `SDKValidationError` that is thrown as a result will capture the raw value that failed validation in an attribute called `rawValue`. Additionally, a `pretty()` method is available on this error that can be used to log a nicely formatted string since validation errors can list many issues and the plain error string may be difficult read when debugging. 


```typescript
import { Incidentio } from "incidentio";
import { SDKValidationError } from "incidentio/models/errors";

const incidentio = new Incidentio();

async function run() {
  let result;
  try {
    result = await incidentio.actions.list({
      incidentId: "01FCNDV6P870EA6S7TK1DSYDG0",
      isFollowUp: true,
      incidentMode: "real",
    });

    // Handle the result
    console.log(result);
  } catch (err) {
    switch (true) {
      case (err instanceof SDKValidationError): {
        // Validation errors can be pretty-printed
        console.error(err.pretty());
        // Raw value may also be inspected
        console.error(err.rawValue);
        return;
      }
      default: {
        throw err;
      }
    }
  }
}

run();

```
<!-- End Error Handling [errors] -->

<!-- Start Server Selection [server] -->
## Server Selection

### Select Server by Index

You can override the default server globally by passing a server index to the `serverIdx` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the indexes associated with the available servers:

| # | Server | Variables |
| - | ------ | --------- |
| 0 | `https://api.incident.io` | None |

```typescript
import { Incidentio } from "incidentio";

const incidentio = new Incidentio({
  serverIdx: 0,
});

async function run() {
  const result = await incidentio.actions.list({
    incidentId: "01FCNDV6P870EA6S7TK1DSYDG0",
    isFollowUp: true,
    incidentMode: "real",
  });

  // Handle the result
  console.log(result);
}

run();

```


### Override Server URL Per-Client

The default server can also be overridden globally by passing a URL to the `serverURL` optional parameter when initializing the SDK client instance. For example:

```typescript
import { Incidentio } from "incidentio";

const incidentio = new Incidentio({
  serverURL: "https://api.incident.io",
});

async function run() {
  const result = await incidentio.actions.list({
    incidentId: "01FCNDV6P870EA6S7TK1DSYDG0",
    isFollowUp: true,
    incidentMode: "real",
  });

  // Handle the result
  console.log(result);
}

run();

```
<!-- End Server Selection [server] -->

<!-- Start Custom HTTP Client [http-client] -->
## Custom HTTP Client

The TypeScript SDK makes API calls using an `HTTPClient` that wraps the native
[Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API). This
client is a thin wrapper around `fetch` and provides the ability to attach hooks
around the request lifecycle that can be used to modify the request or handle
errors and response.

The `HTTPClient` constructor takes an optional `fetcher` argument that can be
used to integrate a third-party HTTP client or when writing tests to mock out
the HTTP client and feed in fixtures.

The following example shows how to use the `"beforeRequest"` hook to to add a
custom header and a timeout to requests and how to use the `"requestError"` hook
to log errors:

```typescript
import { Incidentio } from "incidentio";
import { HTTPClient } from "incidentio/lib/http";

const httpClient = new HTTPClient({
  // fetcher takes a function that has the same signature as native `fetch`.
  fetcher: (request) => {
    return fetch(request);
  }
});

httpClient.addHook("beforeRequest", (request) => {
  const nextRequest = new Request(request, {
    signal: request.signal || AbortSignal.timeout(5000)
  });

  nextRequest.headers.set("x-custom-header", "custom value");

  return nextRequest;
});

httpClient.addHook("requestError", (error, request) => {
  console.group("Request Error");
  console.log("Reason:", `${error}`);
  console.log("Endpoint:", `${request.method} ${request.url}`);
  console.groupEnd();
});

const sdk = new Incidentio({ httpClient });
```
<!-- End Custom HTTP Client [http-client] -->

<!-- Start Debugging [debug] -->
## Debugging

You can setup your SDK to emit debug logs for SDK requests and responses.

You can pass a logger that matches `console`'s interface as an SDK option.

> [!WARNING]
> Beware that debug logging will reveal secrets, like API tokens in headers, in log messages printed to a console or files. It's recommended to use this feature only during local development and not in production.

```typescript
import { Incidentio } from "incidentio";

const sdk = new Incidentio({ debugLogger: console });
```
<!-- End Debugging [debug] -->

<!-- Placeholder for Future Speakeasy SDK Sections -->

# Development

## Maturity

This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage
to a specific package version. This way, you can install the same version each time without breaking changes unless you are intentionally
looking for the latest version.

## Contributions

While we value open-source contributions to this SDK, this library is generated programmatically. Any manual changes added to internal files will be overwritten on the next generation. 
We look forward to hearing your feedback. Feel free to open a PR or an issue with a proof of concept and we'll do our best to include it in a future release. 

### SDK Created by [Speakeasy](https://www.speakeasy.com/?utm_campaign=typescript)
