PUT/users/{userId}/mail/mailfolders/{folderId}

조건에 해당하는 메일함의 이름을 변경한다.

주의

  • 시스템 메일함(folderId가 100 이하인 경우)은 이름을 변경할 수 없다.
  • 계층 구조에서 하위 메일함의 이름을 변경하려면 변경할 메일함 이름을 지정할 때 상위 메일함을 포함해야 계층 구조가 유지된다. 예를 들어, 아래와 같은 계층 구조에서 ChildFolder 메일함 이름을 변경하려면 요청 파라미터인 folderName에 "ParentFolder/newChildFolder"와 같이 지정한다.
ParentFolder   ChildFolder

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증를 참고한다.

Scope

mail

HTTP Request

PUThttps://www.worksapis.com/v1.0/users/{userId}/mail/mailfolders/{folderId}

Path Parameters

ParameterTypeDescription
userId string 

구성원 ID (URL인코딩하여 사용)

  • User ID
  • Login ID(email)
  • 자기자신(me)

required
example : me 
folderId string 

메일함 ID


required
example : 1 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required
example : application/json 

Request Body

PropertyTypeDescription
folderName string 

메일함 이름


required
minLength : 1
maxLength : 100 

Request Example

example

1{2  "folderName": "newFolderName"3}

Response

HTTP 200

OK

PropertyTypeDescription
folderName string 

메일함 이름


required
minLength : 1 
folderId integer 

메일함 ID


required
format : int32 

Response Example

example

1{2  "folderId": 10001,3  "folderName": "test"4}