アプリ タスクの要求

アプリ タスクを要求する

アプリ タスクのメタデータとステータス情報を取得するには、次のエンドポイントを使用します。

アプリ タスクは、タスクを作成または表示するときに返される ID またはキーを使用して要求できます。

アプリ タスク ID に基づいて取得する

ID を使用してアプリ タスクを取得します。

GET

https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/tasks/AppTasks/GetAppTaskById

要求ヘッダー

キー	値 (Value)
認可	Bearer

応答コード

200 サクセス

応答本文

{
  "id": 58293,
  "key": "7b847a63-b4db-4c0a-a256-afd3b70f729f",
  "title": "Approve Purchase Request",
  "status": "Pending",
  "priority": "Normal",
  "type": "AppTask",
  "appTasksMetadata": {
    "appId": "myapp-12345",
    "appVersion": 3,
    "creationTime": "2024-01-11T10:20:30Z",
    "id": 58293
  }
}

アプリ タスク キーに基づいて取得する

一意のキーを使用してアプリ タスクを取得します。

GET

https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/tasks/AppTasks/GetAppTaskByKey

要求ヘッダー

キー	値 (Value)
認可	Bearer

応答コード

200 サクセス

応答本文

{
  "id": 58293,
  "key": "7b847a63-b4db-4c0a-a256-afd3b70f729f",
  "title": "Approve Purchase Request",
  "status": "Pending",
  "priority": "Normal",
  "type": "AppTask",
  "appTasksMetadata": {
    "appId": "myapp-12345",
    "appVersion": 3,
    "creationTime": "2024-01-11T10:20:30Z",
    "id": 58293
  }
}

新しいアプリ タスクを作成する

以前にデプロイしたアプリとタスク定義に基づいて新しいアプリ タスクを作成するには、次のエンドポイントを使用します。

GET

https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/tasks/AppTasks/CreateAppTask

要求ヘッダー

キー	値 (Value)
認可	Bearer

応答コード

201 Created

要求本文

{
  "appId": "myapp-12345",
  "appVersion": 3,
  "folderKey": "folder-12345-678910",
  "fpsContext": (),
  "runtime": "Serverless",
  "appType": "Custom",
  "appProcessKey": "key123-4567-8910",
  "isActionableMessageEnabled": false,
  "title": "Approve Purchase Request",
  "type": "AppTask",
  "title": "string",
  "priority": "Normal",
  "data": {
    "Amount": 2450,
    "Requester": "John Doe"
  }
}

応答本文

{
    "taskDefinitionPropertiesId": null,
    "appTasksMetadata": null,
    "actionLabel": null,
    "status": 0,
    "data": null,
    "action": null,
    "waitJobState": null,
    "organizationUnitFullyQualifiedName": null,
    "tags": [],
    "assignedToUser": null,
    "taskSlaDetails": null,
    "completedByUser": null,
    "taskAssignmentCriteria": "SingleUser",
    "taskAssignees": null,
    "isCurrentUserInAllUserAssignedGroup": null,
    "taskSource": null,
    "processingTime": null,
    "title": "string",
    "type": "AppTask",
    "priority": "Low",
    "assignedToUserId": null,
    "assignedToUserKey": null,
    "organizationUnitId": 1,
    "organizationUnitKey": "key-12345",
    "externalTag": null,
    "creatorJobKey": "00000000-0000-0000-0000-000000000000",
    "waitJobKey": null,
    "lastAssignedTime": null,
    "completionTime": null,
    "parentOperationId": null,
    "key": "f1ac-12345",
    "isDeleted": false,
    "deleterUserId": null,
    "deletionTime": null,
    "lastModificationTime": null,
    "lastModifierUserId": null,
    "creationTime": "2025-12-11T09:23:05.9915069Z",
    "creatorUserId": "user-12345",
    "id": 12345
}