# asPieceCID

> **asPieceCID**(`pieceCidInput`): `PieceLink` \| `null`

Defined in: [packages/synapse-core/src/piece/piece.ts:41](https://github.com/FilOzone/synapse-sdk/blob/7fdc04df4e3c52366a9f0cd55da4c05e20b2ed82/packages/synapse-core/src/piece/piece.ts#L41)

Convert a PieceCID input (string or CID) to a validated CID
This is the main function to use when accepting PieceCID inputs

## Parameters

| Parameter | Type | Description |
| ------ | ------ | ------ |
| `pieceCidInput` | `string` \| `PieceLink` \| `CID`\<`unknown`, `number`, `number`, `Version`\> \| `null` \| `undefined` | PieceCID as either a CID object or string |

## Returns

`PieceLink` \| `null`

The validated PieceCID CID or null if not a valid PieceCID