client.absencesOperation methods
Parameter declarations below are taken from the pinned TypeScript source. Request fields and responses are summarized from the matching OpenAPI operation; follow the API link for every field, constraint, example, and error description.
/absencesabsences.list
Lists tenant-scoped absence metadata through product plan and membership policy. Foreign-user reads require delegated access.
client.absences.list(options: CalendarListOptions)- Return form
Promise- Operation ID
listAbsences- Required scopes
absences:read- Conditional scopes
absences:delegated:read- SDK parameters
options: CalendarListOptions- Query request fields
cursor?: stringlimit?: integerarchived?: booleanstart: stringend: stringuserId?: Array<string>- Success
200 Array<Absence> envelope
/absencesabsences.create
The cell-local App re-authenticates the credential, derives the acting user from the credential principal, and applies tenant, sharing, plan, idempotency, and provider-management policy.
client.absences.create(data: AbsenceCreate, options: MutationOptions = {})- Return form
Promise- Operation ID
createAbsence- Required scopes
absences:write- Conditional scopes
absences:admin:write- SDK parameters
data: AbsenceCreateoptions: MutationOptions- Header request fields
Idempotency-Key: string- Request body
AbsenceCreateapplication/json- Success
201 Absence envelope
/absences/{id}absences.get
Use this operation to get an absence. It returns the resource only when it belongs to the authenticated workspace and is visible to the credential. Required scopes, product permissions, sharing rules, workspace locks, and regional cell ownership are enforced for every request.
client.absences.get(id: string, options?: RequestOptions)- Return form
Promise- Operation ID
getAbsence- Required scopes
absences:read- Conditional scopes
absences:delegated:read- SDK parameters
id: stringoptions: RequestOptions- Path request fields
id: string- Success
200 Absence envelope
/absences/{id}absences.update
Requires the latest strong resource ETag. The cell-local App re-authenticates and atomically applies the tenant-bound revision before returning a fresh ETag.
client.absences.update(id: string, data: AbsenceUpdate, options: AbsenceMutationOptions)- Return form
Promise- Operation ID
updateAbsence- Required scopes
absences:write- Conditional scopes
absences:admin:write- SDK parameters
id: stringdata: AbsenceUpdateoptions: AbsenceMutationOptions- Path request fields
id: string- Header request fields
If-Match: string- Request body
AbsenceUpdateapplication/json- Success
200 Absence envelope
/absences/{id}absences.archive
Requires the latest strong resource ETag. The cell-local App re-authenticates and atomically applies the tenant-bound revision before returning a fresh ETag.
client.absences.archive(id: string, options: AbsenceMutationOptions)- Return form
Promise- Operation ID
archiveAbsence- Required scopes
absences:write- Conditional scopes
absences:admin:write- SDK parameters
id: stringoptions: AbsenceMutationOptions- Path request fields
id: string- Header request fields
If-Match: string- Success
200 Absence envelope
/absences/{id}/restoreabsences.restore
Requires the latest strong resource ETag. The cell-local App re-authenticates and atomically applies the tenant-bound revision before returning a fresh ETag.
client.absences.restore(id: string, options: AbsenceMutationOptions)- Return form
Promise- Operation ID
restoreAbsence- Required scopes
absences:write- Conditional scopes
absences:admin:write- SDK parameters
id: stringoptions: AbsenceMutationOptions- Path request fields
id: string- Header request fields
If-Match: string- Success
200 Absence envelope
Convenience helpers
These typed helpers compose mapped operations. They do not grant scopes or bypass API limits.
absences.pages
Iterate cursor pages with a bounded PaginationOptions policy.
client.absences.pages(options: CalendarListOptions, pagination?: PaginationOptions)AsyncGeneratorErrors and transport metadata
HTTP failures reject with TeamGridApiError, including the status, stable error documents, request ID, optional retry delay, and transport metadata. Local validation, routing, timeout, response-size, and pagination failures reject withTeamGridClientError and a stable client error code. Successful envelopes expose non-enumerable transport metadata.
See pagination and errors andclient configuration for handling guidance.