---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# AWA 받은 편지함 작업 API

# AWA 받은 편지함 작업 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 14분

AWA 받은 편지함 작업 API는 에이전트를 대신하여 작업 항목을 수락하거나 거부할 수 있는 엔드포인트를 제공합니다. 이 API는 거부된 작업 항목의 거부 사유도 검색합니다.

이 API에는 (com.glide.awa) 플러그인과 awa_integration_user 역할이 고급 작업 할당 필요합니다. 자세한 내용은 [고급 작업 할당](https://www.servicenow.com/docs/access?context=awa-overview&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)을 참조하십시오.

## AWA 받은 편지함 작업 -- GET /awa/inbox/actions/reject_reasons/{channel_id} {#ariaid-title2}

지정된 서비스 채널에 대한 작업 항목 거부 사유를 가져옵니다.

### URL 형식

버전이 지정된 URL: /api/now/awa/inbox/actions/reject_reasons/{channel_id}

기본 URL: /api/now/{api_version}/awa/inbox/actions/reject_reasons/{channel_id}  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#awa-inbox-actions-GET-reasons__entry__2}{#awa-inbox-actions-GET-reasons__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| channel_id | 서비스 채널의 Sys_id입니다. 데이터 유형: 문자열 테이블: 서비스 채널 \[awa_service_channel\] |
[표 1. 경로 매개변수]

{#awa-inbox-actions-GET-reasons__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 2. 쿼리 매개변수]

{#awa-inbox-actions-GET-reasons__entry__12}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#awa-inbox-actions-GET-reasons__entry__16}{#awa-inbox-actions-GET-reasons__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]

{#awa-inbox-actions-GET-reasons__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#awa-inbox-actions-GET-reasons__entry__24}{#awa-inbox-actions-GET-reasons__entry-200-status-code}{#awa-inbox-actions-GET-reasons__entry-400-status-code}{#awa-inbox-actions-GET-reasons__entry-401-status-code}{#awa-inbox-actions-GET-reasons__entry-403-status-code-awa}{#awa-inbox-actions-GET-reasons__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 403 | 금지되었습니다. 가능한 이유: * 사용자에게 awa_integration_user 역할이 없습니다.{#awa-inbox-actions-GET-reasons__li-403-role} * glide.awa.enabled 속성 값이 예가 아닙니다. 고급 작업 할당(com.glide.awa) 플러그인이 설치된 경우 이 속성은 시스템 속성 \[sys_property\] 테이블에 나열됩니다. 자세한 내용은 [고급 작업 할당과 함께 설치되는 구성요소를](https://www.servicenow.com/docs/access?context=installed-with-awa&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US) 참조하십시오.{#awa-inbox-actions-GET-reasons__li-403-awa-disabled} {#awa-inbox-actions-GET-reasons__ul_gch_n34_tsb} |
| 404 | 기록 없음 제공된 채널 ID가 잘못되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#awa-inbox-actions-GET-reasons__entry__38}

| 이름 | 설명 |
|-|-|
| display_value | 거부 사유 \[awa_reject_reason\] 테이블의 이유 필드 값을 표시합니다. 데이터 유형: 문자열 |
| 순서 | 에이전트 받은 편지함에 거부 사유가 나열되는 순서입니다. 데이터 유형: 숫자 |
| 값 | 데이터베이스에 저장된 거부 사유 필드의 값입니다. 데이터 유형: 문자열 |
| Sys_id | 이 서비스 채널에 대한 거부 사유 Sys_id입니다. 데이터 유형: 문자열 테이블: 거부 사유 \[awa_reject_reason\] |
[ ]

다음 예는 채팅 서비스 채널의 거부 사유를 검색하는 방법을 보여줍니다.

    curl "https://instance.service-now.com/api/now/awa/inbox/actions/reject_reasons/27f675e3739713004a905ee515f6a7c3" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

거부 사유와 함께 거부된 작업을 표시하는 응답 본문입니다.

    {
      "result": [
        {
          "order": 2,
          "value": "Not my expertise",
          "display_value": "Not my expertise",
          "sys_id": "31e3fa29b38023002e7b6e5f26a8dc17"
        },
        {
          "order": 1,
          "value": "Busy",
          "display_value": "Busy",
          "sys_id": "4e93fa29b38023002e7b6e5f26a8dc20"
        }
      ]
    }

## AWA 받은 편지함 작업 -- POST /awa/inbox/actions/accept {#ariaid-title3}

에이전트를 대신하여 수락 보류 중 상태의 작업 항목을 수락합니다.

### URL 형식

버전이 지정된 URL: /api/now/{api_version}/awa/inbox/actions/accept

기본 URL: /api/now/awa/inbox/actions/accept  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#awa-inbox-actions-POST-accept__entry__2}{#awa-inbox-actions-POST-accept__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 7. 경로 매개변수]

{#awa-inbox-actions-POST-accept__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 8. 쿼리 매개변수]

{#awa-inbox-actions-POST-accept__entry__10}{#awa-inbox-actions-POST-accept__awa-api-ph-work_item_id}

| 이름 | 설명 |
|-|-|
| agent_id | 나열된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| work_item_id | 작업 항목의 Sys_id입니다. 작업 항목은 다음 기준을 충족해야 합니다. * 지정된 에이전트에 작업 항목을 할당해야 합니다. * 작업 항목이 수락 보류 중 상태여야 합니다. {#awa-inbox-actions-POST-accept__ul_zcs_rh3_htb} 데이터 유형: 문자열 테이블: AWA 작업 항목 \[awa_work_item\] |
[표 9. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#awa-inbox-actions-POST-accept__entry__16}{#awa-inbox-actions-POST-accept__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 10. 요청 헤더]

{#awa-inbox-actions-POST-accept__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#awa-inbox-actions-POST-accept__table_qsk_1hj_mtb__entry__2}{#awa-inbox-actions-POST-accept__entry-200-status-code}{#awa-inbox-actions-POST-accept__ph-404-status-code-awa}{#awa-inbox-actions-POST-accept__entry-401-status-code}{#awa-inbox-actions-POST-accept__entry-403-status-code-awa}{#awa-inbox-actions-POST-accept__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 가능한 이유: * 에이전트 ID가 없습니다.{#awa-inbox-actions-POST-accept__li-404-reason-missing-agent-awa} {#awa-inbox-actions-POST-accept__li-404-reason-missing-agent-awa} * 작업 항목 ID가 누락되었습니다.{#awa-inbox-actions-POST-accept__li-404-reason-missing-workitem-awa} {#awa-inbox-actions-POST-accept__li-404-reason-missing-workitem-awa} * 작업 항목이 다른 에이전트에 할당되었습니다.{#awa-inbox-actions-POST-accept__li-404-reason-agent-assign-awa} {#awa-inbox-actions-POST-accept__li-404-reason-agent-assign-awa} * 작업 항목이 수락 보류 중 상태가 아닙니다.{#awa-inbox-actions-POST-accept__li-404-reason-wrkitm-not-pend-awa} {#awa-inbox-actions-POST-accept__li-404-reason-wrkitm-not-pend-awa} {#awa-inbox-actions-POST-accept__ul_khl_t2l_ntb} |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 403 | 금지되었습니다. 가능한 이유: * 사용자에게 awa_integration_user 역할이 없습니다.{#awa-inbox-actions-POST-accept__li-403-role} * glide.awa.enabled 속성 값이 예가 아닙니다. 고급 작업 할당(com.glide.awa) 플러그인이 설치된 경우 이 속성은 시스템 속성 \[sys_property\] 테이블에 나열됩니다. 자세한 내용은 [고급 작업 할당과 함께 설치되는 구성요소를](https://www.servicenow.com/docs/access?context=installed-with-awa&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US) 참조하십시오.{#awa-inbox-actions-POST-accept__li-403-awa-disabled} {#awa-inbox-actions-POST-accept__ul_gch_n34_tsb} |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

{#awa-inbox-actions-POST-accept__table_qsk_1hj_mtb}

### 응답 본문 매개변수(JSON 또는 XML)

{#awa-inbox-actions-POST-accept__entry__36}{#awa-inbox-actions-POST-accept__ordr-row-error}

| 이름 | 설명 |
|-|-|
| documentTable | 이 작업 항목에 할당된 문서를 나열하는 테이블의 이름입니다. 데이터 유형: 문자열 |
| documentSysId | 작업에 할당된 문서 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 필드에서 documentTable 식별된 테이블 |
| 오류 | 요청 프로세스 중에 발생한 오류를 설명하는 상세 정보입니다. 데이터 유형: 객체 "error": { "detail": "String", "message": "String" } |
| 오류.상세 정보 | 요청 프로세스 중에 발생한 오류에 대한 상세 정보입니다. 가능한 값: * 에이전트 ID 누락: agent_id 요청 본문에 제공되지 않았습니다. * 작업 항목 ID 누락: work_item_id 요청 본문에 제공되지 않았습니다. * 작업 항목이 다른 에이전트에 할당됨: 지정된 작업 항목이 지정된 에이전트에 할당되지 않았습니다. * 잘못된 작업 항목 ID: 요청 본문에 제공된 작업 항목이 잘못되었거나 존재하지 않습니다. * 작업 항목이 수락 보류 중 상태가 아님: 요청 본문에 제공된 작업 항목이 수락 보류 중이 아닌 상태입니다. {#awa-inbox-actions-POST-accept__ul_yqf_jk4_htb} 데이터 유형: 문자열 |
| 오류.메시지 | 요청 프로세스 중에 발생한 오류에 대한 메시지입니다. 설명은 속성에 error.detail 제공됩니다. 데이터 유형: 문자열 |
| 상태 | 실패한 요청의 상태입니다. 이 속성은 오류가 있는 경우에만 응답에 포함됩니다. 유효한 값: 실패 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 예는 선택한 에이전트의 작업 항목 상태를 수락 보류 중에서수락됨으로 변경하는 방법을 보여줍니다.

    curl "https://instance.service-now.com/api/now/awa/inbox/actions/accept" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
     \"agent_id\":\"46c9e158a9fe198101d44d0d22cb640d\",
     \"work_item_id\":\"fd69abfc878b01101ae365b83cbb35fe\"
    }" \
    --user 'username':'password'

응답 본문에는 작업 항목과 관련된 문서의 sys_id과 테이블이 나열됩니다.

    {
      "result": {
        "documentSysId": "57af7aec73d423002728660c4cf6a71c",
        "documentTable": "incident"
      }
    }

## AWA 받은 편지함 작업 -- POST /awa/inbox/actions/reject {#ariaid-title4}

에이전트를 대신하여 수락 보류 중 상태의 작업 항목을 거부합니다. 성공하면 할당 대상 필드가 비어 있고 지정된 작업 항목에 대한 거부됨 필드의 값이 예입니다.

### URL 형식

버전이 지정된 URL: /api/now/{api_version}/awa/inbox/actions/reject

기본 URL: /api/now/awa/inbox/actions/reject  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#awa-inbox-actions-POST-reject__entry__2}{#awa-inbox-actions-POST-reject__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 13. 경로 매개변수]

{#awa-inbox-actions-POST-reject__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 14. 쿼리 매개변수]

{#awa-inbox-actions-POST-reject__entry__10}{#awa-inbox-actions-POST-reject__awa-api-ph-work_item_id}

| 이름 | 설명 |
|-|-|
| agent_id | 나열된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| reject_reason_id | 이 서비스 채널에 대한 거부 사유 Sys_id입니다. 데이터 유형: 문자열 테이블: 거부 사유 \[awa_reject_reason\] |
| work_item_id | 작업 항목의 Sys_id입니다. 작업 항목은 다음 기준을 충족해야 합니다. * 지정된 에이전트에 작업 항목을 할당해야 합니다. * 작업 항목이 수락 보류 중 상태여야 합니다. {#awa-inbox-actions-POST-reject__ul_zcs_rh3_htb} 데이터 유형: 문자열 테이블: AWA 작업 항목 \[awa_work_item\] |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#awa-inbox-actions-POST-reject__entry__18}{#awa-inbox-actions-POST-reject__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 16. 요청 헤더]

{#awa-inbox-actions-POST-reject__entry__22}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#awa-inbox-actions-POST-reject__entry__26}{#awa-inbox-actions-POST-reject__entry-200-status-code}{#awa-inbox-actions-POST-reject__entry-401-status-code}{#awa-inbox-actions-POST-reject__entry-403-status-code-awa}{#awa-inbox-actions-POST-reject__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 가능한 이유: * 에이전트 ID가 없습니다. * 작업 항목 ID가 누락되었습니다. * 거부 사유 ID가 누락되었습니다. * 작업 항목이 다른 에이전트에 할당되었습니다. * 작업 항목이 수락 보류 중 상태가 아닙니다. {#awa-inbox-actions-POST-reject__ul_khl_t2l_ntb} |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 403 | 금지되었습니다. 가능한 이유: * 사용자에게 awa_integration_user 역할이 없습니다.{#awa-inbox-actions-POST-reject__li-403-role} * glide.awa.enabled 속성 값이 예가 아닙니다. 고급 작업 할당(com.glide.awa) 플러그인이 설치된 경우 이 속성은 시스템 속성 \[sys_property\] 테이블에 나열됩니다. 자세한 내용은 [고급 작업 할당과 함께 설치되는 구성요소를](https://www.servicenow.com/docs/access?context=installed-with-awa&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US) 참조하십시오.{#awa-inbox-actions-POST-reject__li-403-awa-disabled} {#awa-inbox-actions-POST-reject__ul_gch_n34_tsb} |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. 가능한 이유: * 잘못된 에이전트 ID -- 지정된 사용자에 대한 기록이 없습니다. * 잘못된 거부 사유 ID - 지정된 거부 사유에 대한 기록이 없습니다. * 잘못된 작업 항목 ID -- 지정된 작업 항목에 대한 기록이 없습니다. {#awa-inbox-actions-POST-reject__ul_g1r_43l_ntb} |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#awa-inbox-actions-POST-reject__entry__40}{#awa-inbox-actions-POST-reject__ordr-row-error}

| 이름 | 설명 |
|-|-|
| agent_id | 나열된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| 오류 | 요청 프로세스 중에 발생한 오류를 설명하는 상세 정보입니다. 데이터 유형: 객체 "error": { "detail": "String", "message": "String" } |
| 오류.상세 정보 | 요청 프로세스 중에 발생한 오류에 대한 상세 정보입니다. 가능한 값: * 에이전트 ID 누락 - agent_id 요청 본문에 제공되지 않았습니다. * 누락된 거부 사유 항목 ID - reject_reason_id 요청 본문에 제공되지 않았습니다. * 작업 항목 ID 누락: work_item_id 요청 본문에 제공되지 않았습니다. * awa_reject_reason에 대한 기록이 없습니다. \<reason_sys_id\> -- 요청 본문에 제공된 내용 reject_reason_id 에 거부 사유 \[awa_reject_reason\] 테이블에 일치하는 기록이 없습니다. * awa_work_item에 대한 기록이 없습니다. \<work_item_sys_id\> -- 요청 본문에 제공된 내용 work_item_id 에 AWA 작업 항목 \[awa_work_item\] 테이블에 일치하는 기록이 없습니다. * sys_user에 대한 기록이 없습니다. \<agent_sys_id\> -- 요청 본문에 제공된 항목 agent_id 에 사용자 \[sys_user\] 테이블에 일치하는 기록이 없습니다. * 작업 항목이 수락 보류 중 상태가 아님: 요청 본문에 제공된 작업 항목이 수락 보류 중이 아닌 상태입니다. {#awa-inbox-actions-POST-reject__ul_o5m_22t_gtb} 데이터 유형: 문자열 |
| 오류.메시지 | 요청 프로세스 중에 발생한 오류에 대한 메시지입니다. 설명은 속성에 error.detail 제공됩니다. 데이터 유형: 문자열 |
| 상태 | 실패한 요청의 상태입니다. 이 속성은 오류가 있는 경우에만 응답에 포함됩니다. 유효한 값: 실패 데이터 유형: 문자열 |
| reject_reason_id | 이 서비스 채널에 대한 거부 사유 Sys_id입니다. 데이터 유형: 문자열 테이블: 거부 사유 \[awa_reject_reason\] |
| work_item_id | 작업 항목의 Sys_id입니다. 데이터 유형: 문자열 |
[ ]

다음 예제에서는 "내 전문 지식이 아님"을 이유로 할당된 작업 항목을 거부하는 방법을 보여줍니다.

    curl "https://instance.service-now.com/api/now/awa/inbox/actions/reject" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"agent_id\":\"46c9e158a9fe198101d44d0d22cb640d\",
        \"work_item_id\":\"3ed5df4d87cf01101ae365b83cbb35af\",
        \"reject_reason_id\":\"31e3fa29b38023002e7b6e5f26a8dc17\"
    }" \
    --user 'username':'password'

성공적인 출력은 요청 본문에 제공된 것과 동일한 작업 항목, 거부 사유 및 사용자 ID를 표시합니다. AWA 작업 항목 \[awa_work_item\] 테이블의 지정된 작업 항목에 할당 대상 필드가 비어 있으며 거부됨 필드의 값이 예입니다.

    {
      "result": {
        "work_item_id": "3ed5df4d87cf01101ae365b83cbb35af",
        "reject_reason_id": "31e3fa29b38023002e7b6e5f26a8dc17",
        "agent_id": "46c9e158a9fe198101d44d0d22cb640d"
      }
    }