# FinalizeUploadError

Defined in: [packages/synapse-core/src/errors/pdp.ts:74](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/pdp.ts#L74)

Finalizing a streaming upload (`POST /pdp/piece/uploads/{uuid}`) failed.

Unlike a failure to create the upload session, the bytes were already sent to the provider, so
the problem is the PieceCID or how the provider processed the upload. Extends [PostPieceError](/reference/filoz/synapse-core/errors/classes/postpieceerror/),
which streaming uploads threw for this step before.

## Extends

- [`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/)

## Constructors

### Constructor

> **new FinalizeUploadError**(`error`, `options?`): `FinalizeUploadError`

Defined in: [packages/synapse-core/src/errors/pdp.ts:57](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/pdp.ts#L57)

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `error` | `string` |
| `options?` | [`ProviderErrorOptions`](/reference/filoz/synapse-core/errors/interfaces/providererroroptions/) |

#### Returns

`FinalizeUploadError`

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`constructor`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#constructor)

## Properties

### \[symbol\]

> **\[symbol\]**: `boolean` = `true`

Defined in: [packages/synapse-core/src/errors/provider.ts:21](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/provider.ts#L21)

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`[symbol]`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#symbol)

***

### \[symbol\]

> **\[symbol\]**: `boolean` = `true`

Defined in: [packages/synapse-core/src/errors/base.ts:19](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/base.ts#L19)

#### Inherited from

`PostPieceError.[symbol]`

***

### cause?

> `optional` **cause?**: [`Error`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error)

Defined in: [packages/synapse-core/src/errors/base.ts:22](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/base.ts#L22)

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`cause`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#cause)

***

### details?

> `optional` **details?**: `string`

Defined in: [packages/synapse-core/src/errors/base.ts:23](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/base.ts#L23)

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`details`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#details)

***

### message

> **message**: `string`

Defined in: node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1075

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`message`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#message)

***

### name

> **name**: `"FinalizeUploadError"` = `'FinalizeUploadError'`

Defined in: [packages/synapse-core/src/errors/pdp.ts:75](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/pdp.ts#L75)

#### Overrides

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`name`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#name)

***

### notFound

> **notFound**: `boolean`

Defined in: [packages/synapse-core/src/errors/provider.ts:27](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/provider.ts#L27)

`true` when the service provider answered 404.

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`notFound`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#notfound)

***

### shortMessage

> **shortMessage**: `string`

Defined in: [packages/synapse-core/src/errors/base.ts:24](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/base.ts#L24)

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`shortMessage`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#shortmessage)

***

### stack?

> `optional` **stack?**: `string`

Defined in: node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.es5.d.ts:1076

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`stack`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#stack)

***

### status?

> `optional` **status?**: `number`

Defined in: [packages/synapse-core/src/errors/provider.ts:25](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/provider.ts#L25)

The HTTP status the service provider answered with. `undefined` when the failure was not an HTTP response.

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`status`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#status)

***

### stackTraceLimit

> `static` **stackTraceLimit**: `number`

Defined in: node\_modules/.pnpm/@types+node@26.2.0/node\_modules/@types/node/globals.d.ts:67

The `Error.stackTraceLimit` property specifies the number of stack frames
collected by a stack trace (whether generated by `new Error().stack` or
`Error.captureStackTrace(obj)`).

The default value is `10` but may be set to any valid JavaScript number. Changes
will affect any stack trace captured _after_ the value has been changed.

If set to a non-number value, or set to a negative number, stack traces will
not capture any frames.

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`stackTraceLimit`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#stacktracelimit)

***

### summary

> `protected` `static` **summary**: `string` = `'Failed to finalize upload.'`

Defined in: [packages/synapse-core/src/errors/pdp.ts:76](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/pdp.ts#L76)

The short message, overridden by subclasses for the step that failed.

#### Overrides

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`summary`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#summary)

## Methods

### toJSON()

> **toJSON**(): [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)\<`string`, `unknown`\>

Defined in: [packages/synapse-core/src/errors/provider.ts:43](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/provider.ts#L43)

#### Returns

[`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)\<`string`, `unknown`\>

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`toJSON`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#tojson)

***

### captureStackTrace()

> `static` **captureStackTrace**(`targetObject`, `constructorOpt?`): `void`

Defined in: node\_modules/.pnpm/@types+node@26.2.0/node\_modules/@types/node/globals.d.ts:51

Creates a `.stack` property on `targetObject`, which when accessed returns
a string representing the location in the code at which
`Error.captureStackTrace()` was called.

```js
const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar to `new Error().stack`
```

The first line of the trace will be prefixed with
`${myObject.name}: ${myObject.message}`.

The optional `constructorOpt` argument accepts a function. If given, all frames
above `constructorOpt`, including `constructorOpt`, will be omitted from the
generated stack trace.

The `constructorOpt` argument is useful for hiding implementation
details of error generation from the user. For instance:

```js
function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Create an error without stack trace to avoid calculating the stack trace twice.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capture the stack trace above function b
  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
  throw error;
}

a();
```

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `targetObject` | `object` |
| `constructorOpt?` | [`Function`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Function) |

#### Returns

`void`

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`captureStackTrace`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#capturestacktrace)

***

### fromHttpError()

> `static` **fromHttpError**\<`T`\>(`this`, `error`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`T`\>

Defined in: [packages/synapse-core/src/errors/provider.ts:60](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/provider.ts#L60)

Build the error from an `HttpError`, keeping the response status and the `HttpError` as `cause`.
The response body becomes `details`, or `HTTP <status>` when the body is empty.

#### Type Parameters

| Type Parameter |
| ------ |
| <a id="type-parameter-t"></a> `T` |

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `this` | new (`error`, `options`) => `T` |
| `error` | `HttpError` |

#### Returns

[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`T`\>

#### Example

```ts
throw await PullError.fromHttpError(response.error)
```

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`fromHttpError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#fromhttperror)

***

### is()

> `static` **is**(`value`): `value is FinalizeUploadError`

Defined in: [packages/synapse-core/src/errors/pdp.ts:78](https://github.com/FilOzone/synapse-sdk/blob/ef6c62c2d5e01c004a5cdb1a12bfa58ab9ee1834/packages/synapse-core/src/errors/pdp.ts#L78)

Check if a value is a [PostPieceError](/reference/filoz/synapse-core/errors/classes/postpieceerror/), including a [FinalizeUploadError](/reference/filoz/synapse-core/errors/classes/finalizeuploaderror/).

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `value` | `unknown` |

#### Returns

`value is FinalizeUploadError`

#### Overrides

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`is`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#is)

***

### isError()

> `static` **isError**(`error`): `error is Error`

Defined in: node\_modules/.pnpm/typescript@6.0.3/node\_modules/typescript/lib/lib.esnext.error.d.ts:21

Indicates whether the argument provided is a built-in Error instance or not.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `error` | `unknown` |

#### Returns

`error is Error`

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`isError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#iserror)

***

### prepareStackTrace()

> `static` **prepareStackTrace**(`err`, `stackTraces`): `any`

Defined in: node\_modules/.pnpm/@types+node@26.2.0/node\_modules/@types/node/globals.d.ts:55

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `err` | [`Error`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error) |
| `stackTraces` | `CallSite`[] |

#### Returns

`any`

#### See

https://v8.dev/docs/stack-trace-api#customizing-stack-traces

#### Inherited from

[`PostPieceError`](/reference/filoz/synapse-core/errors/classes/postpieceerror/).[`prepareStackTrace`](/reference/filoz/synapse-core/errors/classes/postpieceerror/#preparestacktrace)