---
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


---

# AWA-Weiterleitungs-API

# AWA-Weiterleitungs-API {#ariaid-title1}

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

Die AWA-Weiterleitung Die API stellt Endpunkte bereit, um ein Dokument an eine Warteschlange weiterzuleiten.
Diese API erfordert Erweiterte ArbeitszuweisungPlugin (com.Glide.awa) und die Rolle Awa_Integration_user.

## AWA-Weiterleitung -- /now/Awa/Queues/{Queue_sys_ID}/work_item VERÖFFENTLICHEN {#ariaid-title2}

Wenn ein aktives Arbeitselement vorhanden ist, leitet ein Dokument an eine Warteschlange weiter. Wenn für das angegebene Dokument kein aktives Arbeitselement vorhanden ist, wird ein Arbeitselement erstellt und seine Felder entsprechend festgelegt.

### URL-Format {#awa-POST-queues-work_item__section_qgh_xt3_2mb}

Versionierte URL: /api/now/{api_Version}/Awa/Warteschlangen/{Queue_sys_ID}/work_item

Standard-URL: /api/now/Awa/Queues/{Queue_sys_ID}/work_item  
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-POST-queues-work_item__entry__2}{#awa-POST-queues-work_item__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 |
| Warteschlange_sys_ID | SYS_ID des Warteschlangendatensatzes. Datentyp: Zeichenfolge Tabelle: Warteschlange \[Awa_Queue\] |
[Tabelle : 1. Pfad-Parameter]

{#awa-POST-queues-work_item__entry__8}

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

{#awa-POST-queues-work_item__entry__12}

| Name | Beschreibung |
|-|-|
| Document_sys_ID | SYS_ID des Dokuments, das an die Warteschlange weitergeleitet werden soll. Datentyp: Zeichenfolge |
| Document_table | Name der Tabelle, die dem Dokument zugeordnet ist, z. B. Incident. Datentyp: Zeichenfolge |
[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-POST-queues-work_item__entry__18}{#awa-POST-queues-work_item__accept-RESTAPI}{#awa-POST-queues-work_item__content_type-RESTAPI}

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

{#awa-POST-queues-work_item__entry__24}

| 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-POST-queues-work_item__entry__28}{#awa-POST-queues-work_item__entry-200-status-code}{#awa-POST-queues-work_item__entry-401-status-code}{#awa-POST-queues-work_item__entry-404-status-code}{#awa-POST-queues-work_item__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 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-POST-queues-work_item__entry__38}

| Name | Beschreibung |
|-|-|
| display_name | Name des Dokuments, das nach diesem Arbeitselement weitergeleitet werden soll, z. B. Falldatensatz. Datentyp: Zeichenfolge |
| Document_sys_ID | SYS_ID des Dokuments, das an die Warteschlange weitergeleitet werden soll. Datentyp: Zeichenfolge |
| Document_table | Name der Tabelle, die dem Dokument zugeordnet ist. Datentyp: Zeichenfolge |
| Warteschlange_sys_ID | SYS_ID der Warteschlange, in der ein Dokument weitergeleitet werden soll. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des Arbeitselements, das der Warteschlange zugewiesen ist. Datentyp: Zeichenfolge |
[ ]

### Beispiel für Curl-Anforderung

    curl -X POST \
      https://instance.servicenow.com/api/now/awa/queues/339eed3f3b892300a2bac9bb34efc4c3/work_item \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -u 'username':'password'
    -d '{
      "document_sys_id": "9c573169c611228700193229fff72400",
      "document_table": "incident"
    }'

    {
      "result": {
        "sys_id": "cd57f90ddbb26300db2051735e9619f0",
        "document_table": "incident",
        "document_sys_id": "9c573169c611228700193229fff72400",
        "queue_sys_id": "339eed3f3b892300a2bac9bb34efc4c3",
        "display_name": "Incident: INC0000001"
      }
    }


