Skip to main content

Workflow-Endpunkte

Workflow Endpoints and Parameters

Weitere Informationen zu Objektbeziehungen und deren Verwendung in der API finden Sie im Abschnitt Objektbeziehungen .

Weitere Informationen zu Workflows finden Sie auf der Hilfeseite Workflows .

Einen neuen Workflow hochladen

Um einen neuen Workflow hochzuladen, verwenden Sie den Endpunkt POST {baseURL}/v3/workflows .

Parameter

  • file (Datei): Erforderlich. Wählen Sie die vorliegende Datei, die Sie in das System hochladen möchten. Der Medientyp muss eine YXZP-Datei sein.

  • name (Zeichenfolge): Erforderlich. Geben Sie einen Workflow-Namen ein. Dies ist der Name des Workflows, der in der Server-Benutzeroberfläche angezeigt werden soll.

  • ownerId  (Zeichenfolge): Erforderlich. Geben Sie die ID des Besitzers ein.

  • workerTag  (Zeichenfolge): Optional. Geben Sie das in den Workern definierte Worker-Tag an, um Worker-Knoten Aufträge einfacher zuzuweisen. Weitere Informationen finden Sie auf der Hilfeseite zu Worker .

  • districtTags  (Zeichenfolge): Optional. Übermitteln Sie dies als Array im JSON-Format, z. B. ["id1", "id2"]. Verwenden Sie Bereiche, um freigegebene, öffentliche Workflows nach Tags zu gruppieren, damit Benutzer sie leicht finden können. Weitere Informationen finden Sie auf der Hilfeseite Bereiche .

  • comments  (Zeichenfolge): Optional. Geben Sie Ihre Kommentare ein.

  • isPublic  (boolescher Wert): Erforderlich. Wählen Sie „true“ aus, um den Workflow öffentlich verfügbar zu machen. Wählen Sie „false“ aus, um den Workflow privat zu machen, d. h., dass er öffentlich nicht verfügbar ist.

  • isReadyForMigration  (boolescher Wert): Erforderlich. Wählen Sie aus, ob der Workflow zur Migration bereit ist. Weitere Informationen zur Migration von einer Server-Umgebung in eine andere finden Sie auf der Hilfeseite Workflows für Migration aktivieren .

  • sourceAppId  (Zeichenfolge): Optional. Legt die Quell-App-ID für einen Workflows fest. Sie können diese als die Referenz „sourceId“ für den Endpunkt POST admin/v1/workflows verwenden. Die Angabe einer bereits vorhandenen „sourceAppId“ führt zu einer ungültigen Anforderung.

  • othersMayDownload  (boolescher Wert): Erforderlich. Geben Sie an, ob andere Benutzer diesen Workflow herunterladen dürfen.

  • othersCanExecute  (boolescher Wert): Erforderlich. Geben Sie an, ob andere Benutzer diesen Workflow ausführen dürfen.

  • executionMode  (Zeichenfolge): Erforderlich. Akzeptierte Werte sind „Safe“, „SemiSafe“ und „Standard“. Weitere Informationen zum Ausführungsmodus finden Sie auf der Hilfeseite Sichere und halbsichere Ausführungsmodi: gesperrte Tools, Ereignisse und Datenkonnektoren .

  • hasPrivateDataExemption  (boolescher Wert): Optional. Erteilen Sie eine Ausnahme, damit ein Workflow mit privaten Daten ausgeführt werden kann. Wählen Sie „true“ aus, um eine Ausnahme zuzulassen oder „false“, um eine Ausnahme zu verweigern. Weitere Informationen finden Sie auf der Hilfeseite Workflow-Optionen in Admin .

  • workflowCredentialType  (Zeichenfolge): Erforderlich. Akzeptierte Werte sind „Standard“, „Erforderlich“ und „Spezifisch“.

  • credentialId (Zeichenfolge): optional. Geben Sie die credentialId für diesen Workflow an.

  • collectionIds  (Zeichenfolge): Optional. Geben Sie die collectionId(s) ein, denen dieser Workflow hinzugefügt werden soll. Übermitteln Sie dies als Array im JSON-Format, z. B.: ["id1", "id2"].

Request Example: cURL
curl -X 'POST' \
  'http://localhost/webapi/v3/workflows' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@Workflow2.yxzp;type=application/yxzp' \
  -F 'name=Workflow2' \
  -F 'ownerId=66ebd0896e52ae73b4951072' \
  -F 'isPublic=true' \
  -F 'isReadyForMigration=true' \
  -F 'othersMayDownload=true' \
  -F 'othersCanExecute=false' \
  -F 'executionMode=Standard' \
  -F 'workflowCredentialType=Default'
Response Example

  • 200: OK

    "string"

  • 400: BadRequest

  • 401: Unauthorized

Eine neue Version in einen bestehenden Workflow hochladen

Um eine neue Version eines vorhandenen Workflows hochzuladen, verwenden Sie den Endpunkt POST {baseURL}/v3/workflows/{workflowId}/versions .

Parameter

  • workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, für die Sie eine neue Version hochladen möchten.

  • file (Datei): Erforderlich. Wählen Sie die tatsächliche Datei aus, die Sie als neue Version in das System hochladen möchten. Der Medientyp muss eine YXZP-Datei sein.

  • name (Zeichenfolge): Erforderlich. Geben Sie den Workflow-Namen ein. Dies ist der Name des Workflows, der in der Server-Benutzeroberfläche angezeigt werden soll.

  • ownerId (Zeichenfolge): erforderlich. Geben Sie die ID des Besitzers ein.

  • othersMayDownload  (boolescher Wert): Erforderlich. Die Standardeinstellung ist „true“.

  • othersCanExecute  (boolescher Wert): Erforderlich. Die Standardeinstellung ist „true“.

  • executionMode  (Zeichenfolge): Erforderlich. Akzeptierte Werte sind „Safe“, „SemiSafe“ und „Standard“. Weitere Informationen zum Ausführungsmodus finden Sie auf der Hilfeseite Sichere und halbsichere Ausführungsmodi: gesperrte Tools, Ereignisse und Datenkonnektoren .

  • hasPrivateDataExemption  (boolescher Wert): Optional. Erteilen Sie eine Ausnahme, damit ein Workflow mit privaten Daten ausgeführt werden kann. Wählen Sie „true“ aus, um eine Ausnahme zuzulassen oder „false“, um eine Ausnahme zu verweigern. Weitere Informationen finden Sie auf der Hilfeseite Workflow-Optionen in Admin .

  • comments  (Zeichenfolge): Optional. Geben Sie Ihre Kommentare ein.

  • makePublished  (boolescher Wert): Erforderlich. Die Standardeinstellung ist „true“. Mit dem Parameter „makePublished“ können Sie steuern, ob die neue Version eines Workflows, den Sie an Server senden, die veröffentlichte Version sein soll oder nicht. Sie können den Wert auf „false“ setzen, wenn Sie den Workflow an Server senden. In dem Fall können dann nur Sie ihn ausführen.

  • workflowCredentialType  (Zeichenfolge): Erforderlich. Geben Sie den Typ der Anmeldedaten ein, die für diesen Workflow verwendet werden sollen. Akzeptierte Werte sind „Standard“, „Erforderlich“ und „Spezifisch“.

  • credentialId (Zeichenfolge): optional. Geben Sie die ID für die Anmeldedaten für diesen Workflow an. Weitere Informationen zu Endpunkten mit Anmeldedaten finden Sie unter Endpunkte mit Anmeldedaten .

Request Example: cURL
curl -X 'POST' \
  'http://localhost/webapi/v3/workflows/66ebd18d6e52ae73b4951085/versions' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@Workflow3.yxzp;type=application/yxzp' \
  -F 'name=Workflow1_3' \
  -F 'ownerId=66ebd0896e52ae73b4951072' \
  -F 'othersMayDownload=true' \
  -F 'othersCanExecute=true' \
  -F 'executionMode=Standard' \
  -F 'makePublished=true' \
  -F 'workflowCredentialType=Default'
Response Example

  • 200: OK

    {
  "id": "string",
  "sourceAppId": "string",
  "dateCreated": "2024-09-19T07:33:01.072Z",
  "runCount": 0,
  "versions": [
    {
      "versionId": "string",
      "versionNumber": 0,
      "dateCreated": "2024-09-19T07:33:01.072Z",
      "uploadSource": "Designer",
      "uploadDate": "2024-09-19T07:33:01.072Z",
      "packageWorkflowType": "App",
      "published": true,
      "comments": "string",
      "runDisabled": true,
      "executionMode": "Safe",
      "workflowCredentialType": "Default",
      "credentialId": "string",
      "hasPrivateDataExemption": true,
      "othersMayDownload": true,
      "othersCanViewHistory": true,
      "details": {
        "isAmp": true,
        "fileName": "string",
        "author": "string",
        "copyright": "string",
        "description": "string",
        "name": "string",
        "noOutputFilesMessage": "string",
        "outputMessage": "string",
        "url": "string",
        "urlText": "string"
      }
    }
  ],
  "name": "string",
  "ownerId": "string",
  "workerTag": "string",
  "districtTags": [
    "string"
  ],
  "comments": "string",
  "isPublic": true,
  "isReadyForMigration": true,
  "publishedVersionId": "string",
  "othersMayDownload": true,
  "othersCanViewHistory": true,
  "othersCanExecute": true,
  "executionMode": "Safe",
  "hasPrivateDataExemption": true
}

  • 401: BadRequest

  • 401: Unauthorized

  • 404: Indicates that the workflowId in the path is invalid.

Alle Workflows abrufen

Um Informationen zu allen Workflow-Datensätzen abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/ .

Parameter

  • view (Zeichenfolge): optional. Wählen Sie aus, wie Sie die Workflow-Informationen anzeigen lassen möchten. Kann ohne Wert belassen werden. Sie können aus den folgenden Werten wählen: „Standard“ und „Vollständig“. Wenn dieser Parameter auf „Standard“ gesetzt ist, wird ein reduziertes Ansichtsobjekt zurückgegeben. Wenn keine Angaben gemacht werden, wird der Standardwert verwendet.

  • name (Zeichenfolge): Optional. Geben Sie den Namen des Workflows ein, falls Sie die Workflows nach Namen filtern möchten. Dies ist der Name des Workflows, der in der Server-Benutzeroberfläche angezeigt wird.

  • ownerId  (Zeichenfolge): Optional. Geben Sie die ID des Besitzers ein, falls Sie die Workflows nach dem jeweiligen Besitzer filtern möchten.

  • createdAfter  (Zeichenfolge): Optional. Geben Sie das Datum und die Uhrzeit ein, wonach der Workflow erstellt wurde. Geben Sie Datum und Uhrzeit im ISO8601-Format ein.

  • createdBefore  (Zeichenfolge): Optional. Geben Sie das Datum und die Uhrzeit ein, wovor der Workflow erstellt wurde. Geben Sie Datum und Uhrzeit im ISO8601-Format ein.

Anforderungsbeispiel: cURL

curl -X 'GET' \
  'http://localhost/webapi/v3/workflows' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

  • 200: OK

      {
    "id": "string",
    "sourceAppId": "string",
    "name": "string",
    "ownerId": "string",
    "dateCreated": "2024-08-15T11:14:56.965Z",
    "publishedVersionNumber": 0,
    "isAmp": true,
    "executionMode": "Safe"
  }
]

  • 400: BadRequest

  • 401: Unauthorized

Einen spezifischen Workflow-Datensatz abrufen

TUm Informationen über einen spezifischen Workflow abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/{workflowId} .

Anmerkung

Non-Curators can use the GET v3/workflows/{workflowId} endpoint for workflows they have access to. Previously, this endpoint was limited to Curators only.

Parameter

  • workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, um Informationen zu diesem Workflow abzurufen.

Anforderungsbeispiel: cURL

curl -X 'GET' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

  • 200: OK

    {
  "id": "string",
  "sourceAppId": "string",
  "dateCreated": "2024-09-05T10:42:53.360Z",
  "runCount": 0,
  "versions": [
    {
      "versionId": "string",
      "versionNumber": 0,
      "dateCreated": "2024-09-05T10:42:53.360Z",
      "uploadSource": "Designer",
      "uploadDate": "2024-09-05T10:42:53.360Z",
      "packageWorkflowType": "App",
      "published": true,
      "comments": "string",
      "runDisabled": true,
      "executionMode": "Safe",
      "workflowCredentialType": "Default",
      "credentialId": "string",
      "hasPrivateDataExemption": true,
      "othersMayDownload": true,
      "othersCanViewHistory": true,
      "details": {
        "isAmp": true,
        "fileName": "string",
        "author": "string",
        "copyright": "string",
        "description": "string",
        "name": "string",
        "noOutputFilesMessage": "string",
        "outputMessage": "string",
        "url": "string",
        "urlText": "string"
      }
    }
  ],
  "name": "string",
  "ownerId": "string",
  "workerTag": "string",
  "districtTags": [
    "string"
  ],
  "comments": "string",
  "isPublic": true,
  "isReadyForMigration": true,
  "publishedVersionId": "string",
  "othersMayDownload": true,
  "othersCanViewHistory": true,
  "othersCanExecute": true,
  "executionMode": "Safe",
  "hasPrivateDataExemption": true
}

  • 401: Unauthorized

  • 404: NotFound

Einen vorhandenen Workflow aktualisieren

m Informationen zu einem vorhandenen Workflow zu ändern, verwenden Sie den Endpunkt PUT {baseURL}/v3/workflows/{workflowId} .

Anmerkung

Only Curators can use this API endpoint.

Um die „ownerId“ zu ändern, muss sich der neue Besitzer im selben Abonnement wie der aktuelle Besitzer befinden.

Parameter

  • workflowId (Zeichenfolge): erforderlich. Geben Sie die ID des Workflows ein, den Sie aktualisieren möchten.

  • updateWorkflowContract  (Text): Erforderlich. Geben Sie die zu aktualisierenden Workflowinformationen ein.

    • name (string): Required. Enter the workflow name. This is the name of the workflow to display in Server UI.

    • versionId (string): Required. Enter the version ID.

    • makePublished (boolean): Optional. When not specified, the value stays the same as before. The makePublished parameter is a way to control whether the new version of a workflow that you push to Server should be the published version or not. You can set the value to "false" when you push the workflow to Server, and then only you will have the ability to run it.

    • ownerId (string): Required. Enter the owner ID.

    • workerTag (string): Required. When there is no workerTag, use "" instead.

    • districtTags (string): Required. Enter the district tags. Use districts to group shared, public workflows by tags so that users can easily find them. For more information, visit the Districts help page.

    • comments (string): Required. Enter your comments.

    • isPublic (boolean): Optional. When not specified, the value stays the same as before.

    • isReadyForMigration (boolean): Optional. When not specified, the value stays the same as before.

    • othersMayDownload (boolean): Optional. When not specified, the value stays the same as before. When set to "false" for a public workflow, the workflow will be unusable.

    • othersCanExecute (boolean): Optional. When not specified, the value stays the same as before. When set to "false" for a public workflow, the workflow will be unusable.

    • executionMode (string): Optional. Accepted values are "Safe", "SemiSafe", "Standard". For more information about the execution mode, see the Safe and Semi-safe Run Modes: Blocked Tools, Events, and Data Connectors help page.

    • hasPrivateDataExemption (boolean): Optional. Give an exemption to allow a workflow with private data to run. Select "true" to allow an exemption or "false" to deny an exemption. When not specified, the value stays the same as before. For more information, visit the Workflow Options in Admin page.

    • workflowCredentialType (string): Optional. Accepted values are "Default", "Required", and "Specific".

    • credentialId (string): Optinal. Specify the credentialId for this workflow.

  • Example value of updateWorkflowContract:

    {
  "name": "string",
  "versionId": "string",
  "makePublished": true,
  "ownerId": "string",
  "workerTag": "string",
  "districtTags": [
    "string"
  ],
  "comments": "string",
  "isPublic": true,
  "isReadyForMigration": true,
  "othersMayDownload": true,
  "othersCanExecute": true,
  "executionMode": "Safe",
  "hasPrivateDataExemption": true,
  "workflowCredentialType": "Default",
  "credentialId": "string"
}
Request Example: cURL
curl -X 'PUT' \
  'http://localhost/webapi/v3/workflows/66ebd18d6e52ae73b4951085' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Workflow_3_4",
  "versionId": "66ebd18d3d6200007e000d89",
  "makePublished": true,
  "ownerId": "66ebd0896e52ae73b4951072",
  "workerTag": "",
  "districtTags": [],
  "comments": "nothing",
  "isPublic": true,
  "isReadyForMigration": true,
  "othersMayDownload": true,
  "othersCanExecute": true,
  "executionMode": "Safe",
  "hasPrivateDataExemption": true,
  "workflowCredentialType": "Default",
  "credentialId": ""
}'
Response Example

  • 200: OK

    {
  "id": "string",
  "sourceAppId": "string",
  "dateCreated": "2024-08-15T11:20:45.231Z",
  "runCount": 0,
  "versions": [
    {
      "versionId": "string",
      "versionNumber": 0,
      "dateCreated": "2024-08-15T11:20:45.231Z",
      "uploadSource": "Designer",
      "uploadDate": "2024-08-15T11:20:45.231Z",
      "packageWorkflowType": "App",
      "published": true,
      "comments": "string",
      "runDisabled": true,
      "executionMode": "Safe",
      "workflowCredentialType": "Default",
      "credentialId": "string",
      "hasPrivateDataExemption": true,
      "othersMayDownload": true,
      "othersCanViewHistory": true,
      "details": {
        "isAmp": true,
        "fileName": "string",
        "author": "string",
        "copyright": "string",
        "description": "string",
        "name": "string",
        "noOutputFilesMessage": "string",
        "outputMessage": "string",
        "url": "string",
        "urlText": "string"
      }
    }
  ],
  "name": "string",
  "ownerId": "string",
  "workerTag": "string",
  "districtTags": [
    "string"
  ],
  "comments": "string",
  "isPublic": true,
  "isReadyForMigration": true,
  "publishedVersionId": "string",
  "othersMayDownload": true,
  "othersCanViewHistory": true,
  "othersCanExecute": true,
  "executionMode": "Safe",
  "hasPrivateDataExemption": true
}

  • 400: BadRequest

  • 401: Unauthorized

  • 404: NotFound

Workflow-Paket herunterladen

Um ein Workflowpaket herunterzuladen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/{workflowId}/package .

Parameter

  • workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, für die Sie das Paket herunterladen möchten.

  • versionId (Zeichenfolge): Optional. Geben Sie die spezifische Versions-ID eines Workflows ein. Wenn Sie keine Version angeben, wird die veröffentlichte Version heruntergeladen.

    Anmerkung

    Wenn die VersionID zweistellig ist, kann die Größenbeschränkung erreicht werden, und Sie erhalten möglicherweise den Fehler „414 - URI Too Long“. In diesem Fall parsen Sie die JSON-VersionID-Zeichenfolge, und schneiden Sie sie nur auf die neueste Version zu. Dadurch wird die Feldlänge unter Kontrolle gehalten.

Anforderungsbeispiel: cURL

curl -X GET --header 'Accept: application/octet-stream' --header 'Authorization: Bearer BearerTokenGoesHere' 'http://localhost/webapi/v3/workflows/635a4be7dc6e24bb8ff0/package'

Response Example

  • 200: The download stream of the YXZP file.

  • 400: Invalid VersionId

  • 401: Unauthorized

  • 403: The authenticated user does not have permission to download the workflow, or the workflow is not allowed to be downloaded directly.

  • 404: NotFound

Frageninformationen für einen Workflow abrufen

Um Frageinformationen zu einem Workflow abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/{workflowId}/questions .

Parameter

  • workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, für die Sie die Informationen abrufen möchten.

  • versionId (Zeichenfolge): Optional. Geben Sie die spezifische Versions-ID eines Workflows ein. Wenn Sie keine Version angeben, wird die veröffentlichte Version verwendet.

Anforderungsbeispiel: cURL

curl -X 'GET' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/questions' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

  • 200: OK

    [
  {
    "name": "string",
    "questionType": "string",
    "description": "string",
    "value": "string",
    "multiple": true,
    "items": [
      {
        "key": "string",
        "value": "string"
      }
    ]
  }
]

  • 400: BadRequest

  • 401: Unauthorized

  • 403: The authenticated user does not have access to the workflow or questions.

  • 404: NotFound

Informationen zu Aufträgen für einen spezifischen Workflow abrufen

Um Informationen über Aufträge für einen spezifischen Workflow abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/{workflowId}/jobs .

Anmerkung

A job might be returned as Completed even if the query status is Error. This indicates an error occurred during execution, but the workflow was run.

Parameter

  • workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, für die Sie die Informationen abrufen möchten.

  • sortField (Zeichenfolge): Optional.

  • direction (Zeichenfolge): Optional.

  • offset (Zeichenfolge): Optional.

  • limit (Zeichenfolge): Optional.

  • status (string): Optional. The overall status of the job execution. A completed job might still have failed. Accepted values are: "Complete", "Error", "Running", and "Queued".

  • resultCode (string): Optional. The result code of the execution of a workflow. This indicates a failed workflow, but a successful job. Accepted values are: "Success", "Warning", and "Error".

Anforderungsbeispiel: cURL

curl -X 'GET' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/jobs' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

  • 200: OK

    [
  {
    "id": "string",
    "createDate": "2024-08-15T11:29:53.357Z",
    "status": "Created",
    "priority": "string",
    "workerTag": "string",
    "runWithE2": true
  }
]

  • 400: BadRequest

  • 401: Unauthorized

  • 404: NotFound

Workflow löschen

Um einen spezifischen Workflow zu löschen, verwenden Sie den Endpunkt DELETE {baseURL}/v3/workflows/{workflowId} .

Anmerkung

Only Curators can use this API endpoint.

Parameter

  • workflowId (Zeichenfolge): erforderlich. Geben Sie die zu löschende Workflow-ID ein.

  • force  (boolescher Wert): Optional. Wenn Sie diese Option nicht ausgewählt haben, lautet der Standardwert „false“. Wenn ein Workflow geplant ist, werden durch den auf „true“ gesetzten Parameter alle Zeitpläne gelöscht, bevor der Workflow gelöscht wird.

Anforderungsbeispiel: cURL

curl -X 'DELETE' \
  'http://localhost/webapi/v3/workflows/670ce95bf10214f22a665bc4' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'

Response Example

  • 200: OK

  • 400: BadRequest

  • 401: Unauthorized

  • 404: NotFound

Neuen Auftrag erstellen

Um einen neuen Auftrag zu erstellen und ihn der Warteschlange hinzuzufügen, verwenden Sie den Endpunkt POST /v3/workflows/{workflowId}/jobs .

Parameter

  • workflowId (Zeichenfolge): erforderlich. Geben Sie eine Workflow-ID ein, die geplant werden soll.

  • contract (Text): Geben Sie die folgenden Parameter an, um einen neuen Auftrag zu erstellen:

    • workerTag  (Zeichenfolge): Optional. Geben Sie den zugewiesenen Worker an. Wenn keine Angabe gemacht wird, ist der Wert „none“.

    • credentialId  (Zeichenfolge): Optional. Geben Sie die ID für die Anmeldedaten für diesen Workflow an.

    • questions  (Zeichenfolge): Optional. Geben Sie bei einer analytischen App die Fragen und Antworten zur Ausführung des Workflows an.

      • name (string): Optional.

      • value (string): Optional.

    • priority  (Zeichenfolge): Optional. Geben Sie die Priorität für die Ausführung des Zeitplans an. Wählen Sie aus den folgenden Optionen aus: „Low“, „Medium“, „High“ und „Critical“. Wenn keine Angabe gemacht wird, ist der Standardwert „Low“.

Example value of contract:

{
  "workerTag": "string",
  "credentialId": "string",
  "questions": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "priority": "Default"
}

Request Example: cURL

Example of a request to create a job:

curl -X 'POST' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/jobs' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "workerTag": "",
  "credentialId": "",
  "priority": "Low"
}'

Response Example

  • 200: OK

    {
  "id": "string",
  "appId": "string",
  "createDateTime": "2024-09-05T11:13:04.586Z",
  "status": "string",
  "disposition": "string",
  "outputs": [
    {
      "id": "string",
      "availableFormats": [
        "string"
      ],
      "fileName": "string"
    }
  ],
  "messages": [
    {
      "status": 0,
      "text": "string",
      "toolId": 0
    }
  ],
  "priority": "Default",
  "workerTag": "string",
  "runWithE2": true
}

  • 400: BadRequest

  • 401: Unauthorized

  • 403: The authenticated user does not have access to execute the workflow.

  • 404: NotFound

Transfer Workflows and Schedules to a Specified Owner

To transfer a specific workflow to a specific owner, together with schedules if desired, use the PUT {baseURL}/v3/workflows/{workflowId}/transfer endpoint.

Anmerkung

  • Only Curators can use this API endpoint.

  • If any of the workflows require DCM connections, Server connections, or specific run as credentials to run, these items need to be updated before the workflow can run.

  • If users are not in the same studio and when a workflow is transferred to the new studio, all other users in the new owner's studio will also receive access to the workflow, and all users from the old studio will lose access.

  • Workflows can only be transferred to a user with the Artisan or Curator role.

  • If transferring schedules, the new owner must have access to the scheduled workflow, otherwise you won’t be able to transfer that workflow to the new owner.

  • If transferring schedules, the new owner must have permission to schedule workflows.

  • If the user is deleted, it returns a list of schedule Ids that will be broken or disabled after transfer.

Parameters

  • workflowId (string): Required. Specify the Id of the workflow to transfer.

  • contract (body): Required. Specify the following information:

    • ownerId (string): Required. Specify the Id of the new owner.

    • transferSchedules (Boolean): Required. Specify whether the schedules should be transferred to a new owner together with the workflow. Only the schedules owned by the current workflow owner will be transferred to the new owner.

Example value of contract:

{
  "ownerId": "string",
  "transferSchedules": true
}

Request Example: cURL

curl -X 'PUT' \
  'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/transfer' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere' \
  -H 'Content-Type: application/json' \
  -d '{
  "ownerId": "670ceafbf10214f22a666c76",
  "transferSchedules": true
}'

Response Example

  • 200: OK

  • 400: BadRequest

    "string"

  • 401: Unauthorized

  • 403: Forbidden

    "string"

  • 404: NotFound

    "string"

  • 500: InternalServerError

Objektbeziehungen

Wenn Sie einen Workflow hochladen, können Sie erstellte Objekte wie folgt verwenden:

Objekt erstellt: " workflowId " (z. B. "id": "7917969784f84bd0942f66996ecb8f3")

Sie können sie wie folgt verwenden:

Beispiele für eine Postman-Anforderung

GET /v3/workflows/{workflowId}

Use GET /v3/workflows/{workflowId} endpoint.

Weitere Informationen zu Postman-Anforderungen finden Sie auf der Hilfeseite Postman verwenden .

In diesem Abschnitt: