# Twins

The Twins endpoints enable creating, updating, and fetching one or more twins at a time. When receiving twins, there are also options to include relationships in the same response.

## List twins

 - [POST /twins](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_gettwinsasync.md)

## Create or replace a twin.

 - [PUT /twins](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_createorreplacetwinasync.md)

## Retrieve a twin

 - [GET /twins/{id}](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_gettwinbyidasync.md)

## Update a twin

 - [PATCH /twins/{id}](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_patchtwin.md)

## Retrieve multiple twins

 - [POST /twins/ids](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_gettwinsbyidsasync.md): Retrieve twin details for the list of twin Ids included in the request body.
Any ids that do not reference valid twins will silently be omitted from the response -- no 404/NotFound will be generated.
Match response against your query to find any invalid IDs.

## Retrieve Twin graph.

 - [POST /twins/graph](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_gettwingraph.md): Retrieves a twin by its ID along with its associated twins as defined in the request.
The relationships field in the request is optional.
Twins will be returned in the response even if the nested relationships failed to find a twin. Similar to a sql outer join semantics.

## Count twins

 - [POST /twins/count](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_gettwinscount.md)