# 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.

 - [POST /twins](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_gettwinsasync.md)
 - [PUT /twins](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_createorreplacetwinasync.md)
 - [GET /twins/{id}](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_gettwinbyidasync.md)
 - [PATCH /twins/{id}](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_patchtwin.md)
 - [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.
 - [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 re
 - [POST /twins/count](https://developers.willowinc.com/openapi/willow-api/twins/twinsv2_gettwinscount.md)