# parseUsesRef (/docs/api/functions/parseUsesRef)



```ts
function parseUsesRef(uses): PinTarget | null;
```

Defined in: [packages/core/src/passes/pin.ts:56](https://github.com/austenstone/actio/blob/2b01e694a0f76521d8c073f3c6a2e48917d2c9d9/packages/core/src/passes/pin.ts#L56)

Classify a `uses:` literal into a pinnable target, or null when it is local,
untagged, or already immutable (a 40-hex sha / `@sha256:` digest). Returning
null on immutable refs is what makes re-pinning a no-op.

## Parameters [#parameters]

### uses [#uses]

`string`

## Returns [#returns]

[`PinTarget`](../interfaces/PinTarget.mdx) | `null`


## Sitemap

Browse the full documentation: [Markdown sitemap](https://austenstone.github.io/actio/sitemap.md) · [XML sitemap](https://austenstone.github.io/actio/sitemap.xml)