Groups

class Group(...)

delete()

Delete the resource. Requires the respective permission.

last_request_age_s()

Returns:: time in seconds since the last request
Return type:: float | None

reload(expand=False)

Update the object properties by requesting the current data from the server.

Parameters:: expand – if True the properties will contain additional information.

Note

if EXPANDED_ATTRIBUTES contains '*' expand will always be True

update(**kwargs)

Update the resource properties.

Parameters:: kwargs – values to be updated (depending on the resource)
Returns:: a new instance of the updated resource
Return type:: same as object

view()

returns a mapping view of the objects internal properties as returned by the REST API.

EXPANDED_ATTRIBUTES = ('created_by', 'email_address', 'signature', 'updated_by', 'users')

active

created_at: datetime

created_by: User

email_address: str

id

name

note

parent: Groups

property parent_group: Group | None: available since Zammad version 6.2

shared_drafts: bool

signature: str

updated_at: datetime

updated_by: User

url: the API endpoint URL

users: List[User]

class Groups(...)

create(name, **kwargs)

Create a new group.

Parameters:

name (str) – group identifier name
kwargs – additional group properties

Returns:

the newly created object

Return type:

Group

iter(*args, **params)

Iterate through all objects.

With params you can also override the pagination defaults set in Client.pagination

The returned iterable can be used in for loops or fill a Python container like list or tuple.

items = tuple(resource.iter(...))

for item in resource.iter(page=5, page_size=20, expand=True):
    print(item)

Parameters:

args – additional endpoint arguments
params – additional pagination options like page, page_size, extend

DEFAULT_CACHE_SIZE = -1

controls the LRU cache behaviour

LRU disabled, cache unbounded (-1)

disable caching (0)

limited LRU caching (>0)

cache: resource LRU cache

property client: Client

endpoint: str

url