---
name: "PONAPI::Client::Request::Role::HasRelationshipUpdateData"
section: "3pm"
platform: "linux"
package: "libponapi-client-perl"
version: "0.002012-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/PONAPI::Client::Request::Role::HasRelationshipUpdateData"
---

# PONAPI::Client::Request::Role::HasRelationshipUpdateData(3pm)

request - role - has relationship-update-data

## NAME

PONAPI::Client::Request::Role::HasRelationshipUpdateData - request - role - has relationship-update-data

## VERSION

version 0.002012

## DESCRIPTION

Similar to PONAPI::Client::Request::Role::HasData, but for relationship updates. Unlike the rest of the spec, relationship updates can take not just a hashref of data, but also undef, or an arrayref.

```
    # Replaces the specified relationship(s) with a one-to-one relationship to foo.
    $client->update_relationships( ..., data => { type => "foo", id => 4 } );
    # Replaces the
    $client->update_relationships( ..., data => [ { type => "foo", id => 4 }, { ... } ] );
    # Clears the relationship
    $client->update_relationships( ..., data => undef );
    $client->update_relationships( ..., data => [] );
```

The underlaying repository decides whether the one-to-one or one-to-many difference is significant.

## AUTHORS

- •

  Mickey Nasriachi \<mickey@cpan.org\>

- •

  Stevan Little \<stevan@cpan.org\>

- •

  Brian Fraser \<hugmeir@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2019 by Mickey Nasriachi, Stevan Little, Brian Fraser.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.