---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API für AWA-Posteingangsaktionen

# API für AWA-Posteingangsaktionen {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 Minuten Lesedauer

Die AWA-Posteingangsaktionen Die API stellt Endpunkte bereit, um ein Arbeitselement im Namen eines Agenten zu akzeptieren oder abzulehnen. Diese API ruft auch Ablehnungsgründe für abgelehnte Arbeitselemente ab.

Diese API erfordert Erweiterte ArbeitszuweisungPlugin (com.Glide.awa) und Rolle „awa_Integration_user". Weitere Informationen finden Sie unter [Erweiterte Arbeitszuweisung](https://www.servicenow.com/docs/access?context=awa-overview&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

## AWA-Posteingangsaktionen -- GET /Awa/inbox/actions/ject_reasons/{Channel_ID} {#ariaid-title2}

Ruft die Ablehnungsgründe des Arbeitselements für einen angegebenen Servicekanal ab.

### URL-Format

Versionierte URL: /api/now/Awa/inbox/actions/ject_reasons/{Channel_ID}

Standard-URL: /api/now/{api_Version}/Awa/inbox/actions/ject_reasons/{Channel_ID}  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| channel_id | SYS_ID eines Servicekanals. Datentyp: Zeichenfolge Tabelle: Servicekanäle \[Awa_Service_Channel\] |
[Tabelle : 1. Pfad-Parameter]

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

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

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

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#awa-inbox-actions-GET-reasons__entry__16}{#awa-inbox-actions-GET-reasons__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

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

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Mögliche Gründe: * Der Anwender verfügt nicht über die Rolle „Awa_Integration_user".{#awa-inbox-actions-GET-reasons__li-403-role} * Der Wert der Eigenschaft „Glide.awa.enabled" ist nicht Wahr . Diese Eigenschaft wird in der Tabelle „Systemeigenschaft" \[sys_property\] aufgeführt, wenn das Plugin „Erweiterte Arbeitszuweisung" (com.Glide.awa) installiert ist. Weitere Informationen finden Sie unter [Komponenten mit erweiterter Arbeitszuweisung installiert](https://www.servicenow.com/docs/access?context=installed-with-awa&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). {#awa-inbox-actions-GET-reasons__li-403-awa-disabled} {#awa-inbox-actions-GET-reasons__ul_gch_n34_tsb} |
| 404 | Datensatz nicht gefunden Die angegebene Kanal-ID ist ungültig. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

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

| Name | Beschreibung |
|-|-|
| Display_value | Anzeigewert des Felds „Grund" in der Tabelle „Ablehnungsgründe" \[Awa_reject_reason\]. Datentyp: Zeichenfolge |
| Reihenfolge | Reihenfolge, in der die Ablehnungsgründe im Posteingang des Service Desk-Mitarbeiters aufgeführt werden. Datentyp: Zahl |
| Wert | Wert des Felds „Ablehnungsgrund", das in der Datenbank gespeichert ist. Datentyp: Zeichenfolge |
| SYS_ID | SYS_ID eines Ablehnungsgrunds für diesen Servicekanal. Datentyp: Zeichenfolge Tabelle: Ablehnungsgründe \[Awa_reject_reason\] |
[ ]

Das folgende Beispiel zeigt, wie Ablehnungsgründe für den Chat-Servicekanal abgerufen werden.

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

Antworttext, der abgelehnte Aufgaben mit Gründen für die Ablehnung anzeigt.

    {
      "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-Posteingangsaktionen: POSTEN /Awa/inbox/actions/accept {#ariaid-title3}

Akzeptiert ein Arbeitselement in Annahme Steht Aus status im Namen eines Service Desk-Mitarbeiters.

### URL-Format

Versionierte URL: /api/now/{api_Version}/Awa/inbox/actions/accept

Standard-URL: /api/now/Awa/inbox/actions/accept  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

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

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

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

| Name | Beschreibung |
|-|-|
| agent_id | SYS_ID des aufgelisteten Agenten. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Work_item_ID | SYS_ID des Arbeitselements. Das Arbeitselement muss die folgenden Kriterien erfüllen: * Arbeitselement muss dem angegebenen Service Desk-Mitarbeiter zugewiesen werden. * Arbeitselement muss sich in befinden Annahme Steht Aus status. {#awa-inbox-actions-POST-accept__ul_zcs_rh3_htb} Datentyp: Zeichenfolge Tabelle: AWA-Arbeitselement \[Awa_work_item\] |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#awa-inbox-actions-POST-accept__entry__16}{#awa-inbox-actions-POST-accept__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

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

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Agent-ID fehlt.{#awa-inbox-actions-POST-accept__li-404-reason-missing-agent-awa} {#awa-inbox-actions-POST-accept__li-404-reason-missing-agent-awa} * Arbeitselement-ID fehlt.{#awa-inbox-actions-POST-accept__li-404-reason-missing-workitem-awa} {#awa-inbox-actions-POST-accept__li-404-reason-missing-workitem-awa} * Arbeitselement ist einem anderen Service Desk-Mitarbeiter zugewiesen.{#awa-inbox-actions-POST-accept__li-404-reason-agent-assign-awa} {#awa-inbox-actions-POST-accept__li-404-reason-agent-assign-awa} * Arbeitselement befindet sich nicht im Status „Akzeptieren ausstehend".{#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 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Mögliche Gründe: * Der Anwender verfügt nicht über die Rolle „Awa_Integration_user".{#awa-inbox-actions-POST-accept__li-403-role} * Der Wert der Eigenschaft „Glide.awa.enabled" ist nicht Wahr . Diese Eigenschaft wird in der Tabelle „Systemeigenschaft" \[sys_property\] aufgeführt, wenn das Plugin „Erweiterte Arbeitszuweisung" (com.Glide.awa) installiert ist. Weitere Informationen finden Sie unter [Komponenten mit erweiterter Arbeitszuweisung installiert](https://www.servicenow.com/docs/access?context=installed-with-awa&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). {#awa-inbox-actions-POST-accept__li-403-awa-disabled} {#awa-inbox-actions-POST-accept__ul_gch_n34_tsb} |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

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

### Antworttext-Parameter (JSON oder XML)

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

| Name | Beschreibung |
|-|-|
| documentTable | Name der Tabelle, die das diesem Arbeitselement zugewiesene Dokument auflistet. Datentyp: Zeichenfolge |
| documentSysId | SYS_ID des Dokumentdatensatzes, der der Aufgabe zugewiesen ist. Datentyp: Zeichenfolge Tabelle: In der Tabelle, die in identifiziert wurde documentTableFeld. |
| Fehler | Details, die einen Fehler beschreiben, der während des Anforderungsprozesses aufgetreten ist. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Details des während des Anforderungsprozesses aufgetretenen Fehlers. Mögliche Werte: * Agent-ID fehlt : Die agent_idWurde im Anforderungstext nicht angegeben. * Arbeitselement-ID fehlt : Die work_item_idWurde im Anforderungstext nicht angegeben. * Arbeitselement ist einem anderen Service Desk-Mitarbeiter zugewiesen : Das angegebene Arbeitselement ist dem angegebenen Service Desk-Mitarbeiter nicht zugewiesen. * Falsche Arbeitselement-ID : Das im Anforderungstext angegebene Arbeitselement ist ungenau oder nicht vorhanden. * Arbeitselement befindet sich nicht im Status „Akzeptieren ausstehend" : Das im Anforderungstext angegebene Arbeitselement befindet sich in einem anderen Status als Annahme Steht Aus . {#awa-inbox-actions-POST-accept__ul_yqf_jk4_htb} Datentyp: Zeichenfolge |
| Fehler.Nachricht | Nachricht für den während des Anforderungsprozesses aufgetretenen Fehler.Die Beschreibung wird in bereitgestellt error.detailEigenschaft. Datentyp: Zeichenfolge |
| Status | Status einer nicht erfolgreichen Anforderung. Diese Eigenschaft ist nur in der Antwort enthalten, wenn ein Fehler auftritt. Gültiger Wert: Fehler Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie der Status des Arbeitselements eines ausgewählten Service Desk-Mitarbeiters in geändert wird Annahme Steht Aus Bis Akzeptiert .

    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'

Der Antworttext listet die sys_ID und die Tabelle des Dokuments auf, das sich auf das Arbeitselement bezieht.

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

## AWA-Posteingangsaktionen: POSTEN /Awa/inbox/actions/ject {#ariaid-title4}

Lehnt ein Arbeitselement in ab Annahme Steht Aus status im Namen eines Service Desk-Mitarbeiters. Bei Erfolg, Zugewiesen an Feld ist leer und der Wert von Abgelehnt Feld ist für das angegebene Arbeitselement „wahr".

### URL-Format

Versionierte URL: /api/now/{api_Version}/Awa/inbox/actions/ject

Standard-URL: /api/now/Awa/inbox/actions/ject  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfad-Parameter]

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

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Abfrageparameter]

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

| Name | Beschreibung |
|-|-|
| agent_id | SYS_ID des aufgelisteten Agenten. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Ablehnungsgrund_ID | SYS_ID eines Ablehnungsgrunds für diesen Servicekanal. Datentyp: Zeichenfolge Tabelle: Ablehnungsgründe \[Awa_reject_reason\] |
| Work_item_ID | SYS_ID des Arbeitselements. Das Arbeitselement muss die folgenden Kriterien erfüllen: * Arbeitselement muss dem angegebenen Service Desk-Mitarbeiter zugewiesen werden. * Arbeitselement muss sich in befinden Annahme Steht Aus status. {#awa-inbox-actions-POST-reject__ul_zcs_rh3_htb} Datentyp: Zeichenfolge Tabelle: AWA-Arbeitselement \[Awa_work_item\] |
[Tabelle : 15. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#awa-inbox-actions-POST-reject__entry__18}{#awa-inbox-actions-POST-reject__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 16. Anforderungskopfzeilen.]

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

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Gründe: * Agent-ID fehlt. * Arbeitselement-ID fehlt. * ID des Ablehnungsgrunds fehlt. * Arbeitselement ist einem anderen Service Desk-Mitarbeiter zugewiesen. * Arbeitselement befindet sich nicht im Status „Akzeptieren ausstehend". {#awa-inbox-actions-POST-reject__ul_khl_t2l_ntb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Mögliche Gründe: * Der Anwender verfügt nicht über die Rolle „Awa_Integration_user".{#awa-inbox-actions-POST-reject__li-403-role} * Der Wert der Eigenschaft „Glide.awa.enabled" ist nicht Wahr . Diese Eigenschaft wird in der Tabelle „Systemeigenschaft" \[sys_property\] aufgeführt, wenn das Plugin „Erweiterte Arbeitszuweisung" (com.Glide.awa) installiert ist. Weitere Informationen finden Sie unter [Komponenten mit erweiterter Arbeitszuweisung installiert](https://www.servicenow.com/docs/access?context=installed-with-awa&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). {#awa-inbox-actions-POST-reject__li-403-awa-disabled} {#awa-inbox-actions-POST-reject__ul_gch_n34_tsb} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. Mögliche Gründe: * Falsche Agent-ID: Für den angegebenen Anwender ist kein Datensatz vorhanden. * Falsche Ablehnungsgrund-ID: Für den angegebenen Ablehnungsgrund ist kein Datensatz vorhanden. * Falsche Arbeitselement-ID: Für das angegebene Arbeitselement ist kein Datensatz vorhanden. {#awa-inbox-actions-POST-reject__ul_g1r_43l_ntb} |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

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

| Name | Beschreibung |
|-|-|
| agent_id | SYS_ID des aufgelisteten Agenten. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Fehler | Details, die einen Fehler beschreiben, der während des Anforderungsprozesses aufgetreten ist. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Details des während des Anforderungsprozesses aufgetretenen Fehlers. Mögliche Werte: * Agent-ID fehlt -- Die agent_idWurde im Anforderungstext nicht angegeben. * Element-ID für Ablehnungsgrund fehlt -- Die reject_reason_idWurde im Anforderungstext nicht angegeben. * Arbeitselement-ID fehlt : Die work_item_idWurde im Anforderungstext nicht angegeben. * Es ist kein Datensatz vorhanden für „Awa_ject_reason: \<reason_sys_id\>" -- Die reject_reason_idDer im Anforderungstext angegebene Datensatz hat keinen übereinstimmenden Datensatz in der Tabelle „Ablehnungsgründe" \[Awa_ject_reason\]. * Es gibt keinen Datensatz für Awa_work_item: \<work_item_sys_id\> -- Die work_item_idDer im Anforderungstext angegebene Datensatz hat keinen übereinstimmenden Datensatz in der Tabelle „AWA-Arbeitselement" \[Awa_work_item\]. * Es ist kein Datensatz für sys_user vorhanden: \<agent_sys_id\> -- Die agent_idDer im Anforderungstext angegebene Datensatz hat keinen übereinstimmenden Datensatz in der Anwendertabelle \[sys_user\]. * Arbeitselement befindet sich nicht im Status „Akzeptieren ausstehend" : Das im Anforderungstext angegebene Arbeitselement befindet sich in einem anderen Status als Annahme Steht Aus . {#awa-inbox-actions-POST-reject__ul_o5m_22t_gtb} Datentyp: Zeichenfolge |
| Fehler.Nachricht | Nachricht für den während des Anforderungsprozesses aufgetretenen Fehler.Die Beschreibung wird in bereitgestellt error.detailEigenschaft. Datentyp: Zeichenfolge |
| Status | Status einer nicht erfolgreichen Anforderung. Diese Eigenschaft ist nur in der Antwort enthalten, wenn ein Fehler auftritt. Gültiger Wert: Fehler Datentyp: Zeichenfolge |
| Ablehnungsgrund_ID | SYS_ID eines Ablehnungsgrunds für diesen Servicekanal. Datentyp: Zeichenfolge Tabelle: Ablehnungsgründe \[Awa_reject_reason\] |
| Work_item_ID | SYS_ID des Arbeitselements. Datentyp: Zeichenfolge |
[ ]

Das folgende Beispiel zeigt, wie ein zugewiesenes Arbeitselement mit dem Grund „nicht meine Kompetenz" abgelehnt wird.

    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'

„Erfolgreiche Ausgabe" zeigt dasselbe Arbeitselement, denselben Ablehnungsgrund und dieselbe Anwender-ID an, die im Anforderungstext angegeben wurden. Das in der Tabelle „AWA-Arbeitselement" \[Awa_work_item\] angegebene Arbeitselement hat ein leeres Element Zugewiesen an Feld und der Wert von Abgelehnt Feld ist „wahr".

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


