Skip to content
Start here

Recipients

List share recipients by share ID
resource_sharing.recipients.list(strshare_id, RecipientListParams**kwargs) -> SyncV4PagePaginationArray[RecipientListResponse]
GET/accounts/{account_id}/shares/{share_id}/recipients
Get share recipient by ID
resource_sharing.recipients.get(strrecipient_id, RecipientGetParams**kwargs) -> RecipientGetResponse
GET/accounts/{account_id}/shares/{share_id}/recipients/{recipient_id}
Create a new share recipient
resource_sharing.recipients.create(strshare_id, RecipientCreateParams**kwargs) -> RecipientCreateResponse
POST/accounts/{account_id}/shares/{share_id}/recipients
Delete a share recipient
resource_sharing.recipients.delete(strrecipient_id, RecipientDeleteParams**kwargs) -> RecipientDeleteResponse
DELETE/accounts/{account_id}/shares/{share_id}/recipients/{recipient_id}
ModelsExpand Collapse
class RecipientListResponse:

A recipient of a share. The association_status field tracks the lifecycle of the shared resources in the recipient account. All recipients are returned by the list endpoint regardless of status; filter client-side if only active recipients are needed.

id: str

Share Recipient identifier tag.

maxLength32
account_id: str

Account identifier.

maxLength32
association_status: Literal["associating", "associated", "disassociating", "disassociated"]

The current state of the recipient relative to the share. The desired_association_status (not exposed in the response) tracks the target state set by the API; the background reconciliation workflow drives current_association_status toward it.

  • associating — The recipient was recently added; the workflow is pushing shared resources into the recipient account.
  • associated — Shared resources have been successfully applied to the recipient account.
  • disassociating — The recipient was removed (via DELETE or PUT replacement); the workflow is removing shared resources from the recipient account.
  • disassociated — Shared resources have been removed from the recipient account. The recipient record remains in the database.
One of the following:
"associating"
"associated"
"disassociating"
"disassociated"
created: datetime

When the share was created.

formatdate-time
modified: datetime

When the share was modified.

formatdate-time
resources: Optional[List[Resource]]
error: str

Share Recipient error message.

resource_id: str

Share Resource identifier.

maxLength32
resource_version: int

Resource Version.

terminal: bool

Whether the error is terminal or will be continually retried.

class RecipientGetResponse:

A recipient of a share. The association_status field tracks the lifecycle of the shared resources in the recipient account. All recipients are returned by the list endpoint regardless of status; filter client-side if only active recipients are needed.

id: str

Share Recipient identifier tag.

maxLength32
account_id: str

Account identifier.

maxLength32
association_status: Literal["associating", "associated", "disassociating", "disassociated"]

The current state of the recipient relative to the share. The desired_association_status (not exposed in the response) tracks the target state set by the API; the background reconciliation workflow drives current_association_status toward it.

  • associating — The recipient was recently added; the workflow is pushing shared resources into the recipient account.
  • associated — Shared resources have been successfully applied to the recipient account.
  • disassociating — The recipient was removed (via DELETE or PUT replacement); the workflow is removing shared resources from the recipient account.
  • disassociated — Shared resources have been removed from the recipient account. The recipient record remains in the database.
One of the following:
"associating"
"associated"
"disassociating"
"disassociated"
created: datetime

When the share was created.

formatdate-time
modified: datetime

When the share was modified.

formatdate-time
resources: Optional[List[Resource]]
error: str

Share Recipient error message.

resource_id: str

Share Resource identifier.

maxLength32
resource_version: int

Resource Version.

terminal: bool

Whether the error is terminal or will be continually retried.

class RecipientCreateResponse:

A recipient of a share. The association_status field tracks the lifecycle of the shared resources in the recipient account. All recipients are returned by the list endpoint regardless of status; filter client-side if only active recipients are needed.

id: str

Share Recipient identifier tag.

maxLength32
account_id: str

Account identifier.

maxLength32
association_status: Literal["associating", "associated", "disassociating", "disassociated"]

The current state of the recipient relative to the share. The desired_association_status (not exposed in the response) tracks the target state set by the API; the background reconciliation workflow drives current_association_status toward it.

  • associating — The recipient was recently added; the workflow is pushing shared resources into the recipient account.
  • associated — Shared resources have been successfully applied to the recipient account.
  • disassociating — The recipient was removed (via DELETE or PUT replacement); the workflow is removing shared resources from the recipient account.
  • disassociated — Shared resources have been removed from the recipient account. The recipient record remains in the database.
One of the following:
"associating"
"associated"
"disassociating"
"disassociated"
created: datetime

When the share was created.

formatdate-time
modified: datetime

When the share was modified.

formatdate-time
resources: Optional[List[Resource]]
error: str

Share Recipient error message.

resource_id: str

Share Resource identifier.

maxLength32
resource_version: int

Resource Version.

terminal: bool

Whether the error is terminal or will be continually retried.

class RecipientDeleteResponse:

A recipient of a share. The association_status field tracks the lifecycle of the shared resources in the recipient account. All recipients are returned by the list endpoint regardless of status; filter client-side if only active recipients are needed.

id: str

Share Recipient identifier tag.

maxLength32
account_id: str

Account identifier.

maxLength32
association_status: Literal["associating", "associated", "disassociating", "disassociated"]

The current state of the recipient relative to the share. The desired_association_status (not exposed in the response) tracks the target state set by the API; the background reconciliation workflow drives current_association_status toward it.

  • associating — The recipient was recently added; the workflow is pushing shared resources into the recipient account.
  • associated — Shared resources have been successfully applied to the recipient account.
  • disassociating — The recipient was removed (via DELETE or PUT replacement); the workflow is removing shared resources from the recipient account.
  • disassociated — Shared resources have been removed from the recipient account. The recipient record remains in the database.
One of the following:
"associating"
"associated"
"disassociating"
"disassociated"
created: datetime

When the share was created.

formatdate-time
modified: datetime

When the share was modified.

formatdate-time
resources: Optional[List[Resource]]
error: str

Share Recipient error message.

resource_id: str

Share Resource identifier.

maxLength32
resource_version: int

Resource Version.

terminal: bool

Whether the error is terminal or will be continually retried.