client.jobs.put_shares_users

A method of the Jobs endpoint.

put_shares_users(id: int, user_ids: List[int], permission_level: str, *, share_email_body: str = None, send_shared_email: bool = None) → Response

Set the permissions users have on this object

API URL: PUT /jobs/{id}/shares/users

import civis
client = civis.APIClient()
response = client.jobs.put_shares_users(...)

Parameters:

idint

The ID of the resource that is shared.

user_idsList[int]

An array of one or more user IDs.

permission_levelstr

Options are: “read”, “write”, or “manage”.

share_email_bodystr, optional

Custom body text for e-mail sent on a share.

send_shared_emailbool, optional

Send email to the recipients of a share.

Returns:

civis.Response

• readerscivis.Response

  • usersList[civis.Response]

    • id : int

    • name : str

  • groupsList[civis.Response]

    • id : int

    • name : str

• writerscivis.Response

  • usersList[civis.Response]

    • id : int

    • name : str

  • groupsList[civis.Response]

    • id : int

    • name : str

• ownerscivis.Response

  • usersList[civis.Response]

    • id : int

    • name : str

  • groupsList[civis.Response]

    • id : int

    • name : str

• total_user_sharesint

  For owners, the number of total users shared. For writers and readers, the number of visible users shared.

• total_group_sharesint

  For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.