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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API für AWA-Posteingangsaktionen

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

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 Minuten Lesedauer

Die AWA-Posteingangsaktionen- API bietet Endpunkte, um ein Arbeitselement im Namen eines Service Desk-Mitarbeiters anzunehmen oder abzulehnen. Diese API ruft auch Ablehnungsgründe für abgelehnte Arbeitselemente ab.

Diese API erfordert das Plugin Erweiterte Arbeitszuweisung (com.glide.awa) und die Rolle awa_integration_user. Weitere Informationen finden Sie unter [Erweiterte Arbeitszuweisung](https://www.servicenow.com/docs/access?context=awa-overview&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

## AWA-Posteingangsaktionen -- GET /awa/inbox/actions/reject_reasons/{channel_id} {#ariaid-title2}

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

### URL-Format

URL mit Versionsnummer: /api/now/awa/inbox/actions/reject_reasons/{channel_id}

Standard-URL: /api/now/{api_version}/awa/inbox/actions/reject_reasons/{channel_id}

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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, der in der Tabelle „Servicekanäle" \[awa_service_channel\] aufgeführt ist. Informationen hierzu finden Sie unter . |
[Tabelle : 1. Pfadparameter]

{#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. Anforderungstextparameter (XML oder JSON)]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#awa-inbox-actions-GET-reasons__entry__16}{#awa-inbox-actions-GET-reasons__accept-RESTAPI}

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

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

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Mögliche Gründe: * Der Benutzer 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 „ true". 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 Mit der erweiterten Arbeitszuweisung installierte Komponenten](https://www.servicenow.com/docs/access?context=installed-with-awa&version=xanadu&pubname=xanadu-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. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Parameter des Antworttexts (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 |
| Bestellen | Reihenfolge, in der die Ablehnungsgründe im Posteingang des Service Desk-Mitarbeiters aufgelistet sind. 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. Die Gründe sind in der Tabelle „Ablehnungsgründe" \[awa_reject_reason\] aufgeführt. Datentyp: Zeichenfolge |
[ ]

Das folgende Beispiel zeigt, wie Ablehnungsgründe für den Servicekanal Chat 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: POST /awa/inbox/actions/accept {#ariaid-title3}

Akzeptiert im Namen eines Service Desk-Mitarbeiters ein Arbeitselement im Status „ Akzeptanz ausstehend ".

### URL-Format

URL mit Versionsnummer: /api/now/{api_version}/awa/inbox/actions/accept

Standard-URL: /api/now/awa/inbox/actions/accept

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#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 in der Benutzertabelle \[sys_user\] aufgeführten Agents. Datentyp: Zeichenfolge |
| work_item_id | Sys_id des in der Tabelle „AWA-Arbeitselement" \[awa_work_item\] aufgeführten Arbeitselements. Das Arbeitselement muss die folgenden Kriterien erfüllen: * Das Arbeitselement muss dem angegebenen Service Desk-Mitarbeiter zugewiesen werden. * Das Arbeitselement muss sich im Status „ Akzeptanz ausstehend " befinden. {#awa-inbox-actions-POST-accept__ul_zcs_rh3_htb} Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstextparameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#awa-inbox-actions-POST-accept__entry__16}{#awa-inbox-actions-POST-accept__accept-RESTAPI}

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

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

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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: * Fehlende Agent-ID.{#awa-inbox-actions-POST-accept__li-404-reason-missing-agent-awa} {#awa-inbox-actions-POST-accept__li-404-reason-missing-agent-awa} * Fehlende Arbeitselement-ID.{#awa-inbox-actions-POST-accept__li-404-reason-missing-workitem-awa} {#awa-inbox-actions-POST-accept__li-404-reason-missing-workitem-awa} * Das 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} * Das Arbeitselement weist nicht den Status „Akzeptanz ausstehend" auf.{#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 Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Mögliche Gründe: * Der Benutzer 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 „ true". 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 Mit der erweiterten Arbeitszuweisung installierte Komponenten](https://www.servicenow.com/docs/access?context=installed-with-awa&version=xanadu&pubname=xanadu-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. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

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

### Parameter des Antworttexts (JSON oder XML)

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

| Name | Beschreibung |
|-|-|
| documentTable | Name der Tabelle mit dem Dokument, das diesem Arbeitselement zugewiesen ist. Datentyp: Zeichenfolge |
| documentSysId | Sys_id des Dokumentdatensatzes, der der Aufgabe zugewiesen ist. Befindet sich in der Tabelle mit dem Namen im Feld documentTable. Datentyp: Zeichenfolge |
| Fehler | Details, die einen während des Anforderungsprozesses aufgetretenen Fehler beschreiben. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Details des Fehlers, der während des Anforderungsprozesses aufgetreten ist. Mögliche Werte: * Fehlende Agent-ID: agent_id wurde nicht im Anforderungstext angegeben. * Fehlende Arbeitselement-ID: work_item_id wurde 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 „Akzeptanz ausstehend" : Das im Anforderungstext bereitgestellte Arbeitselement weist einen anderen Status als „Akzeptanz ausstehend"auf. {#awa-inbox-actions-POST-accept__ul_yqf_jk4_htb} Datentyp: Zeichenfolge |
| Fehlernachricht | Meldung für den Fehler, der während des Anforderungsprozesses aufgetreten ist. Die Beschreibung wird in der Eigenschaft error.detail angegeben. Datentyp: Zeichenfolge |
| status | Status einer nicht erfolgreichen Anforderung. Diese Eigenschaft ist nur in der Antwort enthalten, wenn ein Fehler vorliegt. Gültiger Wert: Fehler Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Das folgende Beispiel zeigt, wie Sie den Status des Arbeitselements eines ausgewählten Service Desk-Mitarbeiters von Akzeptanz steht aus in Akzeptiertändern.

    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: POST /awa/inbox/actions/reject {#ariaid-title4}

Lehnt im Namen eines Service Desk-Mitarbeiters ein Arbeitselement im Status „ Akzeptanz steht aus" ab. Bei Erfolg ist das Feld Zugewiesen an leer und der Wert des Felds Abgelehnt ist wahr für das angegebene Arbeitselement.

### URL-Format

URL mit Versionsnummer: /api/now/{api_version}/awa/inbox/actions/reject

Standard-URL: /api/now/awa/inbox/actions/reject

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#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 in der Benutzertabelle \[sys_user\] aufgeführten Agents. Datentyp: Zeichenfolge |
| „reject_reason_id" | Sys_id eines Ablehnungsgrunds für diesen Servicekanal. Die Gründe sind in der Tabelle „Ablehnungsgründe" \[awa_reject_reason\] aufgeführt. Datentyp: Zeichenfolge |
| work_item_id | Sys_id des in der Tabelle „AWA-Arbeitselement" \[awa_work_item\] aufgeführten Arbeitselements. Das Arbeitselement muss die folgenden Kriterien erfüllen: * Das Arbeitselement muss dem angegebenen Service Desk-Mitarbeiter zugewiesen werden. * Das Arbeitselement muss sich im Status „ Akzeptanz ausstehend " befinden. {#awa-inbox-actions-POST-reject__ul_zcs_rh3_htb} Datentyp: Zeichenfolge |
[Tabelle : 15. Anforderungstextparameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#awa-inbox-actions-POST-reject__entry__18}{#awa-inbox-actions-POST-reject__accept-RESTAPI}

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

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

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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: * Fehlende Agent-ID. * Fehlende Arbeitselement-ID. * Ablehnungsgrund-ID fehlt. * Das Arbeitselement ist einem anderen Service Desk-Mitarbeiter zugewiesen. * Das Arbeitselement weist nicht den Status „Akzeptanz ausstehend" auf. {#awa-inbox-actions-POST-reject__ul_khl_t2l_ntb} |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Mögliche Gründe: * Der Benutzer 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 „ true". 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 Mit der erweiterten Arbeitszuweisung installierte Komponenten](https://www.servicenow.com/docs/access?context=installed-with-awa&version=xanadu&pubname=xanadu-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. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Parameter des Antworttexts (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 in der Benutzertabelle \[sys_user\] aufgeführten Agents. Datentyp: Zeichenfolge |
| Fehler | Details, die einen während des Anforderungsprozesses aufgetretenen Fehler beschreiben. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Details des Fehlers, der während des Anforderungsprozesses aufgetreten ist. Mögliche Werte: * Fehlende Agent-ID : agent_id wurde im Anforderungstext nicht angegeben. * Fehlende Element-ID für Ablehnungsgrund -- reject_reason_id wurde im Anforderungstext nicht angegeben. * Fehlende Arbeitselement-ID: work_item_id wurde im Anforderungstext nicht angegeben. * Es gibt keinen Datensatz für awa_reject_reason: \<reason_sys_id\> -- Der im Anforderungstext angegebene reject_reason_id hat keinen übereinstimmenden Datensatz in der Tabelle „Ablehnungsgründe" \[awa_reject_reason\]. * Es gibt keinen Datensatz für awa_work_item: \<work_item_sys_id\> -- Der im Anforderungstext angegebene work_item_id hat keinen übereinstimmenden Datensatz in der Tabelle „AWA-Arbeitselement" \[awa_work_item\]. * Es gibt keinen Datensatz für sys_user: \<agent_sys_id\> -- Der im Anforderungstext angegebene agent_id hat keinen übereinstimmenden Datensatz in der Benutzertabelle \[sys_user\]. * Arbeitselement befindet sich nicht im Status „Akzeptanz ausstehend": Das im Anforderungstext bereitgestellte Arbeitselement weist einen anderen Status als „Akzeptanz ausstehend"auf. {#awa-inbox-actions-POST-reject__ul_o5m_22t_gtb} Datentyp: Zeichenfolge |
| Fehlernachricht | Meldung für den Fehler, der während des Anforderungsprozesses aufgetreten ist. Die Beschreibung wird in der Eigenschaft error.detail angegeben. Datentyp: Zeichenfolge |
| status | Status einer nicht erfolgreichen Anforderung. Diese Eigenschaft ist nur in der Antwort enthalten, wenn ein Fehler vorliegt. Gültiger Wert: Fehler Datentyp: Zeichenfolge |
| „reject_reason_id" | Sys_id eines Ablehnungsgrunds für diesen Servicekanal. Die Gründe sind in der Tabelle „Ablehnungsgründe" \[awa_reject_reason\] aufgeführt. Datentyp: Zeichenfolge |
| work_item_id | Sys_id des in der Tabelle „AWA-Arbeitselement" \[awa_work_item\] aufgeführten Arbeitselements. Datentyp: Zeichenfolge |
[ ]

Das folgende Beispiel zeigt, wie Sie ein zugewiesenes Arbeitselement mit dem Grund „not my skill" (nicht meine Kompetenz) ablehnen.

    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'

Bei einer erfolgreichen Ausgabe werden dasselbe Arbeitselement, der Ablehnungsgrund und die Anwender-ID wie im Anforderungstext angezeigt. Das in der Tabelle „AWA-Arbeitselement" \[awa_work_item\] angegebene Arbeitselement hat ein leeres Feld Zugewiesen an, und der Wert des Felds Abgelehnt ist wahr.

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