Namespace: microsoft.graph
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Create a new timeOffReason.
This API is available in the following national cloud deployments.
Global service |
US Government L4 |
US Government L5 (DOD) |
China operated by 21Vianet |
✅ |
❌ |
❌ |
❌ |
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
This API supports admin permissions. Users with admin roles can access teams that they aren't members of.
Permission type |
Permissions (from least to most privileged) |
Delegated (work or school account) |
Group.ReadWrite.All |
Delegated (personal Microsoft account) |
Not supported. |
Application |
Schedule.ReadWrite.All* |
HTTP request
POST /teams/{teamId}/schedule/timeOffReasons
Header |
Value |
Authorization |
Bearer {token}. Required. Learn more about authentication and authorization. |
Content-Type |
application/json. Required. |
MS-APP-ACTS-AS (deprecated) |
A user ID (GUID). Required only if the authorization token is an application token; otherwise, optional. The MS-APP-ACTS-AS header is deprecated and no longer required with application tokens. |
Response
If successful, this method returns a 201 Created
response code and a timeOffReason object in the response body.
Example
Request
The following example shows a request.
POST https://graph.microsoft.com/beta/teams/{teamId}/schedule/timeOffReasons
Content-type: application/json
{
"displayName": "Vacation",
"code": "VacationCode",
"iconType": "plane",
"isActive": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new TimeOffReason
{
DisplayName = "Vacation",
Code = "VacationCode",
IconType = TimeOffReasonIconType.Plane,
IsActive = true,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Schedule.TimeOffReasons.PostAsync(requestBody);
mgc-beta teams schedule time-off-reasons create --team-id {team-id} --body '{\
"displayName": "Vacation",\
"code": "VacationCode",\
"iconType": "plane",\
"isActive": true\
}\
'
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewTimeOffReason()
displayName := "Vacation"
requestBody.SetDisplayName(&displayName)
code := "VacationCode"
requestBody.SetCode(&code)
iconType := graphmodels.PLANE_TIMEOFFREASONICONTYPE
requestBody.SetIconType(&iconType)
isActive := true
requestBody.SetIsActive(&isActive)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
timeOffReasons, err := graphClient.Teams().ByTeamId("team-id").Schedule().TimeOffReasons().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TimeOffReason timeOffReason = new TimeOffReason();
timeOffReason.setDisplayName("Vacation");
timeOffReason.setCode("VacationCode");
timeOffReason.setIconType(TimeOffReasonIconType.Plane);
timeOffReason.setIsActive(true);
TimeOffReason result = graphClient.teams().byTeamId("{team-id}").schedule().timeOffReasons().post(timeOffReason);
const options = {
authProvider,
};
const client = Client.init(options);
const timeOffReason = {
displayName: 'Vacation',
code: 'VacationCode',
iconType: 'plane',
isActive: true
};
await client.api('/teams/{teamId}/schedule/timeOffReasons')
.version('beta')
.post(timeOffReason);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\TimeOffReason;
use Microsoft\Graph\Beta\Generated\Models\TimeOffReasonIconType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new TimeOffReason();
$requestBody->setDisplayName('Vacation');
$requestBody->setCode('VacationCode');
$requestBody->setIconType(new TimeOffReasonIconType('plane'));
$requestBody->setIsActive(true);
$result = $graphServiceClient->teams()->byTeamId('team-id')->schedule()->timeOffReasons()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Teams
$params = @{
displayName = "Vacation"
code = "VacationCode"
iconType = "plane"
isActive = $true
}
New-MgBetaTeamScheduleTimeOffReason -TeamId $teamId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.time_off_reason import TimeOffReason
from msgraph_beta.generated.models.time_off_reason_icon_type import TimeOffReasonIconType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = TimeOffReason(
display_name = "Vacation",
code = "VacationCode",
icon_type = TimeOffReasonIconType.Plane,
is_active = True,
)
result = await graph_client.teams.by_team_id('team-id').schedule.time_off_reasons.post(request_body)
Response
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-type: application/json
{
"id": "TOR_891045ca-b5d2-406b-aa06-a3c8921245d7",
"createdDateTime": "2019-03-12T22:10:38.242Z",
"lastModifiedDateTime": "2019-03-12T22:10:38.242Z",
"displayName": "Vacation",
"code": "VacationCode",
"iconType": "plane",
"isActive": true,
"lastModifiedBy": {
"application": null,
"device": null,
"conversation": null,
"user": {
"id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8",
"displayName": "John Doe"
}
}
}