Skip to content
English

Set user's out of office state

PUT
/domains/{domainID}/users/{userID}/oof
curl --request PUT \
--url https://example.com/api/v1/domains/1/users/1/oof \
--header 'Content-Type: application/json' \
--cookie grommunioAuthJwt=<grommunioAuthJwt> \
--data '{ "state": 0, "externalAudience": 0, "startTime": "example", "endTime": "example", "internalSubject": "Out of Office", "internalReply": "example", "externalSubject": "Out of Office", "externalReply": "example" }'
domainID
required
integer

ID of the domain

userID
required
integer

ID of the user

X-Csrf-Token
string

CSRF Token

Media typeapplication/json
object
state

Out-of-office state (0=Disabled, 1=Enabled, 2=Scheduled)

integer
Allowed values: 0 1 2
externalAudience

External audience setting (0=None, 1=Known, 2=All)

integer
Allowed values: 0 1 2
startTime

Date string with time

string
nullable /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/
endTime

Date string with time

string
nullable /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/
internalSubject

Subject for internal out-of-office reply

string
default: Out of Office nullable
internalReply

Internal out-of-office reply body

string
nullable
externalSubject

Subject for external out-of-office reply

string
default: Out of Office nullable
externalReply

External out-of-office reply body

string
nullable

Out-of-office state updated

Validation of input parameters failed

Media typeapplication/json
object
message
string
errors

List of errors encountered during validation

Array<string>
Examplegenerated
{
"message": "example",
"errors": [
"example"
]
}

The requested resource could not be found

Media typeapplication/json
object
message
string
Examplegenerated
{
"message": "example"
}

An error occurred while processing the request

Media typeapplication/json
object
message

String representation of the exception

string
Examplegenerated
{
"message": "example"
}

One of the required external services is unavailable

Media typeapplication/json
object
message

Description of the error

string
Examplegenerated
{
"message": "example"
}