# 브랜드 운영자 권한 부여 ## Request ## 브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다.
> 브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다. \ > \+ \*\*계정 권한 : 마스터\*\*\ > \+ \*\*브랜드 권한 : 브랜드 대표운영자\*\*
```json {"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"PersonId":{"name":"personId","in":"path","description":"maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.\n","schema":{"type":"string","maxLength":20},"required":true},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegPrivilegeInfo":{"type":"object","description":"브랜드의 권한 정보 객체입니다.\n","required":["privilegeType","id"],"properties":{"privilegeType":{"type":"string","description":"권한은 다음과 같이 구분됩니다. \n\n - Manager : 대표운영자 \n - SubManager : 운영자(기업의 마스터 또는 매니저)\n - Agency : 운영자(대행사)\n","enum":["Agency","SubManager","Manager"]},"id":{"description":"maxLength: 20 - 마스터, 매니저 또는 대행사의 ID입니다.\n","type":"string","maxLength":20}}}}},"paths":{"/corp/{personId}/brand/{brandId}/privilege":{"post":{"summary":"브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다.\n","description":"브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다. \n + **계정 권한 : 마스터**\n + **브랜드 권한 : 브랜드 대표운영자**\n","parameters":[{"$ref":"#/components/parameters/PersonId"},{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"description":"+ privilegeType이 SubManager 인 경우, 소속된 기업 내 다른 마스터, 매니저 계정을 운영자로 지정할 수\n있습니다. \n\n+ privilegeType이 Agency 인 경우, 별도의 RCS 발송 계약을 맺은 대행사를 운영자로 지정합니다. \n","content":{"application/json":{"schema":{"properties":{"regPrivileges":{"type":"array","items":{"$ref":"#/components/schemas/RegPrivilegeInfo"}}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}} ``` ### ❖ request body sample {% tabs %} {% tab title="SubManager 권한부여" %} 
{
    "regPrivileges": [
        {
            "privilegeType": "SubManager",
            "id": "lng04152"
        }
    ]
}
{% endtab %} {% tab title="Agency 권한부여" %} ``` { "regPrivileges": [ { "privilegeType": "Agency", "id": "lng04152" } ] } ``` {% endtab %} {% endtabs %} ## Response
필드명타입길이필수여부기본값설명
resultarray<object>O브랜드의 권한 정보 객체입니다.
codestring5O20000000
statusinteger3O200
descstringO
### result - array\
필드명타입길이필수여부기본값설명
privilegeTypestringO

권한은 다음과 같이 구분됩니다.

  • Manager : 브랜드 관리자(=마스터)
  • SubManager : 브랜드 부관리자(=마스터, 매니저)
  • Agency : 브랜드 대행사
idstring20O마스터, 매니저 또는 대행사의 ID입니다.
statusstringO

권한 처리 상태를 표시합니다.

  • Waiting : RCS Biz Center 웹에서 제공되는 기능인 '브랜드 운영권한 신청'을 이용하여 신청 후 대기 브랜드 관리자의 승인을 대기 중인 상태입니다. Waiting 상태의 대상은 POST를 이용하여 등록하면 승인이 되고 Ok 상태로 변경됩니다.
  • Processing : 권한 정보를 이통3사에 동기화 중인 경우 processing 상태로 표시됩니다. Processing 상태가 짧은 시간 동안 발생할 수 있으며 지속될 경우 RCS Biz Center에 문의하시기 바랍니다.
  • Ok : 권한 상태가 정상적인 경우 표시됩니다.
### ❖ response body sample {% tabs %} {% tab title="200" %} ``` { "code": "20000000", "desc": null, "result": [ { "privilegeType": "Manager", "id": "hong", "contracts": [], "status": "Ok" }, { "privilegeType": "SubManager", "id": "hozzy59", "contracts": [], "status": "Ok" } ], "status": 200 } ``` {% endtab %} {% tab title="400" %} ``` { "error": { "code": "64104", "message": "Invalid personId on path parameter" }, "status": 400 } { "error": { "code": "64348", "message": "hozzy59 is already registered." }, "status": 400 } { "error": { "code": "64336", "message": "required value: [privilegeType]" }, "status": 400 } { "error": { "code": "64338", "message": "invalid value: [privilegeType], SubManager or Agency (case sensitive)" }, "status": 400 } { "error": { "code": "64346", "message": "user not found: hozzy59" }, "status": 400 } ``` {% endtab %} {% tab title="401" %} ``` { "error": { "code": "61003", "message": "Invalid token" }, "status": 401 } ``` {% endtab %} {% tab title="403" %} ``` { "error": { "code": "63001", "message": "No Brand Permission" }, "status": 403 } ``` {% endtab %} {% endtabs %} {% hint style="warning" %} error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code.md#rcs-biz-center-response-body-error-code) 참조 {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://apidocs.rcsbizcenter.com/rbc-api/brand/post_brand_privilege.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.