Solicitações de tarefas de aplicativo

Pontos de extremidade de API para recuperar metadados e status de Tarefas de aplicativo por ID ou chave.

Solicitação de tarefas de aplicativo

Use os seguintes pontos de extremidade para recuperar metadados e informações de status de Tarefas de aplicativo.

Você pode solicitar Tarefas de aplicativo usando o ID ou a Chave retornada ao criar ou listar tarefas.

De acordo com o ID da Tarefa do aplicativo

Recuperar uma Tarefa de aplicativo usando seu ID.

Obter

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/tasks/AppTasks/GetAppTaskById

Cabeçalhos de solicitação.

Chave	Valor
Autorização	O portador

Código de resposta

200 Sucesso

Corpo da Resposta

{
  "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
  }
}

De acordo com a chave da Tarefa do aplicativo

Recuperar uma Tarefa de aplicativo usando sua chave exclusiva.

Obter

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/tasks/AppTasks/GetAppTaskByKey

Cabeçalhos de solicitação.

Chave	Valor
Autorização	O portador

Código de resposta

200 Sucesso

Corpo da Resposta

{
  "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
  }
}

Crie uma nova Tarefa de aplicativo

Use este ponto de extremidade para criar uma nova Tarefa de aplicativo com base em um Aplicativo e Definição de tarefa implantados anteriormente.

Obter

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/tasks/AppTasks/CreateAppTask

Cabeçalhos de solicitação.

Chave	Valor
Autorização	O portador

Código de resposta

201 criado

Corpo da Solicitação

{
  "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"
  }
}

Corpo da Resposta

{
    "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
}