Skip to content
API Reference/
/
List tasks by external_id

Augmented Operations Management API (1.0.0)

Overview

This API provides backend services for the Augmented Decision Making application, focusing on the efficient scheduling and assignment of tasks Operations to a given Resources.

The system models the following key entities:

  • Locations: Representing physical areas
  • Resources: Specific assignable assets within a location.
  • Tasks: Represent individual events, jobs. Tasks include detailed time information (planned, expected, actual) and model uncertainty using statistical parameters (sigma, skew factor, distribution mean/earliest/latest). Tasks also support versioning to track updates.
  • Operations: Represent a complete operation, linking an inbound task to an outbound task. Operations contain relevant metadata.
  • Assignments: Link an Operation to a specific Resource for a given time period.
  • Tags: Can be used to restrict possible assignments as well as indicate preferences or penalties.
  • Rules: Can be used to specify preferences or penalties in conjunction with the tagging mechanism.

Core Functionality

The API enables users and automated systems to:

  1. Manage Data: Perform CRUD operations on Locations, Resources, Tasks, Operations, and Assignments.
  2. Track Operations Times: Handle various time representations and update task details, including imposing delays. Task updates create new versions, preserving history.
  3. Assignments: Assign or reassign operation to resources.
  4. Detect Conflicts: Identify situations where an assigned conflicting (overlapping) with another based on their expected time windows.
  5. Resolve Conflicts: Offer mechanisms to resolve individual scheduling conflicts through AI.
  6. Optimize Globally: Offer global optimization of the schedule using various solvers to minimize conflicts and reassignments while optimizing for rules.
  7. AI Assistance: Interact with an AI agent (via the /agent/ endpoint) using natural language to query the schedule, identify conflicts, request moves, or trigger conflict resolution processes. The agent utilizes specialized tools to interact with the system's state.
  8. Real-time Updates: Delivers real-time notifications about changes to Assignments and Operations via WebSockets to subscribed clients.
  9. Virtual State Management: Allows temporary modifications to the schedule (virtual assignments) for "what-if" scenarios or agent-driven planning before potentially persisting changes.
Download OpenAPI description
schema.json
schema.yaml
Languages
Servers
Acceptance Environment
https://api.acc.adm.wearetransformers.nl

Users

User management (authentication, current user details).

Operations

Locations

Managing locations and viewing their associated resources.

Operations

Resources

Managing resources (CRUD, listing).

Operations

Operations

Managing operations. Includes CRUD and listing with time/version filters.

Operations

Tasks

Updating details (time, uncertainty) of individual tasks within operations.

Operations

List tasks by external_id

Request

List tasks for a planning filtered by external_id. The external_id parameter is required. Supports workspace overlay.

Security
tokenAuth
Path
idstring(uuid)required
Query
external_idstringrequired
curl -i -X GET \
  'https://api.acc.adm.wearetransformers.nl/v1/plannings/{id}/tasks/?external_id=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/jsonArray [
actualTimeActualtime (string) or Actualtime (null)(Actualtime)
Default null
Any of:
string(date-time)(Actualtime)
Default null
createdAtstring(date-time)(Createdat)required
expectedTimeExpectedtime (string) or Expectedtime (null)(Expectedtime)
Default null
Any of:
string(date-time)(Expectedtime)
Default null
expectedTimeP05Expectedtimep05 (string) or Expectedtimep05 (null)(Expectedtimep05)
Default null
Any of:
string(date-time)(Expectedtimep05)
Default null
expectedTimeP10Expectedtimep10 (string) or Expectedtimep10 (null)(Expectedtimep10)
Default null
Any of:
string(date-time)(Expectedtimep10)
Default null
expectedTimeP90Expectedtimep90 (string) or Expectedtimep90 (null)(Expectedtimep90)
Default null
Any of:
string(date-time)(Expectedtimep90)
Default null
expectedTimeP95Expectedtimep95 (string) or Expectedtimep95 (null)(Expectedtimep95)
Default null
Any of:
string(date-time)(Expectedtimep95)
Default null
expectedTimesSourceExpectedTimesSourceEnum (string) or null
Default null
Any of:
string(ExpectedTimesSourceEnum)
Default null
Enum"schedule""actual""manual""predicted""external"
externalIdExternalid (string) or Externalid (null)(Externalid)
Default null
Any of:
string(Externalid)
Default null
idstring(uuid)(Id)required
isMockIsmock (boolean) or Ismock (null)(Ismock)
Default null
Any of:
boolean(Ismock)
Default null
metadataAviationStandTaskMetadataSchema (object) or AviationStandDemoTaskMetadataSchema (object) or Metadata (null)(Metadata)
Default null
Any of:

Input schema for flights (task) metadata.

operationstring(uuid)(Operation)required
persistedboolean(Persisted)required
planningstring(uuid)(Planning)required
rolestring(RoleEnum)required
Enum"inbound""outbound"
scheduledTimeScheduledtime (string) or Scheduledtime (null)(Scheduledtime)
Default null
Any of:
string(date-time)(Scheduledtime)
Default null
tagsDetailsArray of objects(Tagsdetails)required
tagsDetails[].​uuidstring(uuid)read-onlyrequired
tagsDetails[].​categorystringrequired
tagsDetails[].​valuestringrequired
tagsDetails[].​requiredboolean
Default false
tagsDetails[].​colorstring or null
taskNameTaskname (string) or Taskname (null)(Taskname)
Default null
Any of:
string(Taskname)
Default null
validFromstring(date-time)(Validfrom)required
validToValidto (string) or Validto (null)(Validto)required
Any of:
string(date-time)(Validto)
versionIdstring(uuid)(Versionid)required
]
Response
application/json
[
  {
    "actualTime": null,
    "createdAt": "2019-08-24T14:15:22Z",
    "expectedTime": null,
    "expectedTimeP05": null,
    "expectedTimeP10": null,
    "expectedTimeP90": null,
    "expectedTimeP95": null,
    "expectedTimesSource": null,
    "externalId": null,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "isMock": null,
    "metadata": null,
    "operation": "fc63ceec-84f0-4df1-a7e8-77c5f8c0b283",
    "persisted": true,
    "planning": "2d429708-7857-4300-9552-6e473ce0d566",
    "role": "inbound",
    "scheduledTime": null,
    "tagsDetails": [ … ],
    "taskName": null,
    "validFrom": "2019-08-24T14:15:22Z",
    "validTo": "2019-08-24T14:15:22Z",
    "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7"
  }
]

Create task

Request

Create a task without an operation. The task can be linked to an operation later. Supports workspace overlay.

Security
tokenAuth
Bodyapplication/jsonrequired
externalIdstring or null
planningstring(uuid)
rolestring(RoleEnum)
Enum"inbound""outbound"
taskNamestringrequired
scheduledTimestring(date-time)required
expectedTimestring(date-time)required
expectedTimeP05string(date-time)
expectedTimeP10string(date-time)
expectedTimeP90string(date-time)
expectedTimeP95string(date-time)
expectedTimesSourcestring(ExpectedTimesSourceEnum)required
Enum"schedule""actual""manual""predicted""external"
actualTimestring or null(date-time)
isMockboolean
Default false
metadataAviationStandTaskMetadataSchema (object) or AviationStandDemoTaskMetadataSchema (object)
One of:

Input schema for flights (task) metadata.

tagsArray of strings(uuid)write-only
curl -i -X POST \
  https://api.acc.adm.wearetransformers.nl/v1/tasks/ \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "externalId": "string",
    "planning": "2d429708-7857-4300-9552-6e473ce0d566",
    "role": "inbound",
    "taskName": "string",
    "scheduledTime": "2019-08-24T14:15:22Z",
    "expectedTime": "2019-08-24T14:15:22Z",
    "expectedTimeP05": "2019-08-24T14:15:22Z",
    "expectedTimeP10": "2019-08-24T14:15:22Z",
    "expectedTimeP90": "2019-08-24T14:15:22Z",
    "expectedTimeP95": "2019-08-24T14:15:22Z",
    "expectedTimesSource": "schedule",
    "actualTime": "2019-08-24T14:15:22Z",
    "isMock": false,
    "metadata": {
      "kind": "aviation_stand",
      "airline": null,
      "airline_code": null,
      "od_code": null,
      "ac_reg": null,
      "aircraft_type": null,
      "cat": null,
      "ground_handler": null
    },
    "tags": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
  }'

Responses

Bodyapplication/json
actualTimeActualtime (string) or Actualtime (null)(Actualtime)
Default null
Any of:
string(date-time)(Actualtime)
Default null
createdAtstring(date-time)(Createdat)required
expectedTimeExpectedtime (string) or Expectedtime (null)(Expectedtime)
Default null
Any of:
string(date-time)(Expectedtime)
Default null
expectedTimeP05Expectedtimep05 (string) or Expectedtimep05 (null)(Expectedtimep05)
Default null
Any of:
string(date-time)(Expectedtimep05)
Default null
expectedTimeP10Expectedtimep10 (string) or Expectedtimep10 (null)(Expectedtimep10)
Default null
Any of:
string(date-time)(Expectedtimep10)
Default null
expectedTimeP90Expectedtimep90 (string) or Expectedtimep90 (null)(Expectedtimep90)
Default null
Any of:
string(date-time)(Expectedtimep90)
Default null
expectedTimeP95Expectedtimep95 (string) or Expectedtimep95 (null)(Expectedtimep95)
Default null
Any of:
string(date-time)(Expectedtimep95)
Default null
expectedTimesSourceExpectedTimesSourceEnum (string) or null
Default null
Any of:
string(ExpectedTimesSourceEnum)
Default null
Enum"schedule""actual""manual""predicted""external"
externalIdExternalid (string) or Externalid (null)(Externalid)
Default null
Any of:
string(Externalid)
Default null
idstring(uuid)(Id)required
isMockIsmock (boolean) or Ismock (null)(Ismock)
Default null
Any of:
boolean(Ismock)
Default null
metadataAviationStandTaskMetadataSchema (object) or AviationStandDemoTaskMetadataSchema (object) or Metadata (null)(Metadata)
Default null
Any of:

Input schema for flights (task) metadata.

operationstring(uuid)(Operation)required
persistedboolean(Persisted)required
planningstring(uuid)(Planning)required
rolestring(RoleEnum)required
Enum"inbound""outbound"
scheduledTimeScheduledtime (string) or Scheduledtime (null)(Scheduledtime)
Default null
Any of:
string(date-time)(Scheduledtime)
Default null
tagsDetailsArray of objects(Tagsdetails)required
tagsDetails[].​uuidstring(uuid)read-onlyrequired
tagsDetails[].​categorystringrequired
tagsDetails[].​valuestringrequired
tagsDetails[].​requiredboolean
Default false
tagsDetails[].​colorstring or null
taskNameTaskname (string) or Taskname (null)(Taskname)
Default null
Any of:
string(Taskname)
Default null
validFromstring(date-time)(Validfrom)required
validToValidto (string) or Validto (null)(Validto)required
Any of:
string(date-time)(Validto)
versionIdstring(uuid)(Versionid)required
Response
application/json
{
  "actualTime": null,
  "createdAt": "2019-08-24T14:15:22Z",
  "expectedTime": null,
  "expectedTimeP05": null,
  "expectedTimeP10": null,
  "expectedTimeP90": null,
  "expectedTimeP95": null,
  "expectedTimesSource": null,
  "externalId": null,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "isMock": null,
  "metadata": null,
  "operation": "fc63ceec-84f0-4df1-a7e8-77c5f8c0b283",
  "persisted": true,
  "planning": "2d429708-7857-4300-9552-6e473ce0d566",
  "role": "inbound",
  "scheduledTime": null,
  "tagsDetails": [
    { … }
  ],
  "taskName": null,
  "validFrom": "2019-08-24T14:15:22Z",
  "validTo": "2019-08-24T14:15:22Z",
  "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7"
}

Retrieve Task

Request

Get a single task by ID.

Security
tokenAuth
Path
idstring(uuid)required
curl -i -X GET \
  'https://api.acc.adm.wearetransformers.nl/v1/tasks/{id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
actualTimeActualtime (string) or Actualtime (null)(Actualtime)
Default null
Any of:
string(date-time)(Actualtime)
Default null
createdAtstring(date-time)(Createdat)required
expectedTimeExpectedtime (string) or Expectedtime (null)(Expectedtime)
Default null
Any of:
string(date-time)(Expectedtime)
Default null
expectedTimeP05Expectedtimep05 (string) or Expectedtimep05 (null)(Expectedtimep05)
Default null
Any of:
string(date-time)(Expectedtimep05)
Default null
expectedTimeP10Expectedtimep10 (string) or Expectedtimep10 (null)(Expectedtimep10)
Default null
Any of:
string(date-time)(Expectedtimep10)
Default null
expectedTimeP90Expectedtimep90 (string) or Expectedtimep90 (null)(Expectedtimep90)
Default null
Any of:
string(date-time)(Expectedtimep90)
Default null
expectedTimeP95Expectedtimep95 (string) or Expectedtimep95 (null)(Expectedtimep95)
Default null
Any of:
string(date-time)(Expectedtimep95)
Default null
expectedTimesSourceExpectedTimesSourceEnum (string) or null
Default null
Any of:
string(ExpectedTimesSourceEnum)
Default null
Enum"schedule""actual""manual""predicted""external"
externalIdExternalid (string) or Externalid (null)(Externalid)
Default null
Any of:
string(Externalid)
Default null
idstring(uuid)(Id)required
isMockIsmock (boolean) or Ismock (null)(Ismock)
Default null
Any of:
boolean(Ismock)
Default null
metadataAviationStandTaskMetadataSchema (object) or AviationStandDemoTaskMetadataSchema (object) or Metadata (null)(Metadata)
Default null
Any of:

Input schema for flights (task) metadata.

operationstring(uuid)(Operation)required
persistedboolean(Persisted)required
planningstring(uuid)(Planning)required
rolestring(RoleEnum)required
Enum"inbound""outbound"
scheduledTimeScheduledtime (string) or Scheduledtime (null)(Scheduledtime)
Default null
Any of:
string(date-time)(Scheduledtime)
Default null
tagsDetailsArray of objects(Tagsdetails)required
tagsDetails[].​uuidstring(uuid)read-onlyrequired
tagsDetails[].​categorystringrequired
tagsDetails[].​valuestringrequired
tagsDetails[].​requiredboolean
Default false
tagsDetails[].​colorstring or null
taskNameTaskname (string) or Taskname (null)(Taskname)
Default null
Any of:
string(Taskname)
Default null
validFromstring(date-time)(Validfrom)required
validToValidto (string) or Validto (null)(Validto)required
Any of:
string(date-time)(Validto)
versionIdstring(uuid)(Versionid)required
Response
application/json
{
  "actualTime": null,
  "createdAt": "2019-08-24T14:15:22Z",
  "expectedTime": null,
  "expectedTimeP05": null,
  "expectedTimeP10": null,
  "expectedTimeP90": null,
  "expectedTimeP95": null,
  "expectedTimesSource": null,
  "externalId": null,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "isMock": null,
  "metadata": null,
  "operation": "fc63ceec-84f0-4df1-a7e8-77c5f8c0b283",
  "persisted": true,
  "planning": "2d429708-7857-4300-9552-6e473ce0d566",
  "role": "inbound",
  "scheduledTime": null,
  "tagsDetails": [
    { … }
  ],
  "taskName": null,
  "validFrom": "2019-08-24T14:15:22Z",
  "validTo": "2019-08-24T14:15:22Z",
  "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7"
}

Update Task

Request

Update task fields (expected times, tags, etc.). Supports workspace overlay.

Security
tokenAuth
Path
idstring(uuid)required
Bodyapplication/json
externalIdstring or null
planningstring(uuid)
rolestring(RoleEnum)
Enum"inbound""outbound"
taskNamestring
scheduledTimestring(date-time)
expectedTimestring(date-time)
expectedTimeP05string(date-time)
expectedTimeP10string(date-time)
expectedTimeP90string(date-time)
expectedTimeP95string(date-time)
expectedTimesSourcestring(ExpectedTimesSourceEnum)
Enum"schedule""actual""manual""predicted""external"
actualTimestring or null(date-time)
isMockboolean
Default false
metadataAviationStandTaskMetadataSchema (object) or AviationStandDemoTaskMetadataSchema (object)
One of:

Input schema for flights (task) metadata.

tagsArray of strings(uuid)write-only
curl -i -X PATCH \
  'https://api.acc.adm.wearetransformers.nl/v1/tasks/{id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "externalId": "string",
    "planning": "2d429708-7857-4300-9552-6e473ce0d566",
    "role": "inbound",
    "taskName": "string",
    "scheduledTime": "2019-08-24T14:15:22Z",
    "expectedTime": "2019-08-24T14:15:22Z",
    "expectedTimeP05": "2019-08-24T14:15:22Z",
    "expectedTimeP10": "2019-08-24T14:15:22Z",
    "expectedTimeP90": "2019-08-24T14:15:22Z",
    "expectedTimeP95": "2019-08-24T14:15:22Z",
    "expectedTimesSource": "schedule",
    "actualTime": "2019-08-24T14:15:22Z",
    "isMock": false,
    "metadata": {
      "kind": "aviation_stand",
      "airline": null,
      "airline_code": null,
      "od_code": null,
      "ac_reg": null,
      "aircraft_type": null,
      "cat": null,
      "ground_handler": null
    },
    "tags": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
  }'

Responses

Bodyapplication/json
actualTimeActualtime (string) or Actualtime (null)(Actualtime)
Default null
Any of:
string(date-time)(Actualtime)
Default null
createdAtstring(date-time)(Createdat)required
expectedTimeExpectedtime (string) or Expectedtime (null)(Expectedtime)
Default null
Any of:
string(date-time)(Expectedtime)
Default null
expectedTimeP05Expectedtimep05 (string) or Expectedtimep05 (null)(Expectedtimep05)
Default null
Any of:
string(date-time)(Expectedtimep05)
Default null
expectedTimeP10Expectedtimep10 (string) or Expectedtimep10 (null)(Expectedtimep10)
Default null
Any of:
string(date-time)(Expectedtimep10)
Default null
expectedTimeP90Expectedtimep90 (string) or Expectedtimep90 (null)(Expectedtimep90)
Default null
Any of:
string(date-time)(Expectedtimep90)
Default null
expectedTimeP95Expectedtimep95 (string) or Expectedtimep95 (null)(Expectedtimep95)
Default null
Any of:
string(date-time)(Expectedtimep95)
Default null
expectedTimesSourceExpectedTimesSourceEnum (string) or null
Default null
Any of:
string(ExpectedTimesSourceEnum)
Default null
Enum"schedule""actual""manual""predicted""external"
externalIdExternalid (string) or Externalid (null)(Externalid)
Default null
Any of:
string(Externalid)
Default null
idstring(uuid)(Id)required
isMockIsmock (boolean) or Ismock (null)(Ismock)
Default null
Any of:
boolean(Ismock)
Default null
metadataAviationStandTaskMetadataSchema (object) or AviationStandDemoTaskMetadataSchema (object) or Metadata (null)(Metadata)
Default null
Any of:

Input schema for flights (task) metadata.

operationstring(uuid)(Operation)required
persistedboolean(Persisted)required
planningstring(uuid)(Planning)required
rolestring(RoleEnum)required
Enum"inbound""outbound"
scheduledTimeScheduledtime (string) or Scheduledtime (null)(Scheduledtime)
Default null
Any of:
string(date-time)(Scheduledtime)
Default null
tagsDetailsArray of objects(Tagsdetails)required
tagsDetails[].​uuidstring(uuid)read-onlyrequired
tagsDetails[].​categorystringrequired
tagsDetails[].​valuestringrequired
tagsDetails[].​requiredboolean
Default false
tagsDetails[].​colorstring or null
taskNameTaskname (string) or Taskname (null)(Taskname)
Default null
Any of:
string(Taskname)
Default null
validFromstring(date-time)(Validfrom)required
validToValidto (string) or Validto (null)(Validto)required
Any of:
string(date-time)(Validto)
versionIdstring(uuid)(Versionid)required
Response
application/json
{
  "actualTime": null,
  "createdAt": "2019-08-24T14:15:22Z",
  "expectedTime": null,
  "expectedTimeP05": null,
  "expectedTimeP10": null,
  "expectedTimeP90": null,
  "expectedTimeP95": null,
  "expectedTimesSource": null,
  "externalId": null,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "isMock": null,
  "metadata": null,
  "operation": "fc63ceec-84f0-4df1-a7e8-77c5f8c0b283",
  "persisted": true,
  "planning": "2d429708-7857-4300-9552-6e473ce0d566",
  "role": "inbound",
  "scheduledTime": null,
  "tagsDetails": [
    { … }
  ],
  "taskName": null,
  "validFrom": "2019-08-24T14:15:22Z",
  "validTo": "2019-08-24T14:15:22Z",
  "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7"
}

Delete Task

Request

Soft-delete a task by marking its state as deleted. Supports workspace overlay.

Security
tokenAuth
Path
idstring(uuid)required
curl -i -X DELETE \
  'https://api.acc.adm.wearetransformers.nl/v1/tasks/{id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

No response body

Response
No content

Assignments

Managing the assignment of operations to resources (CRUD, bulk operations, deactivation, listing per operation).

Operations

Conflict Resolution

Resolving specific scheduling conflicts using heuristic search methods (streaming and non-streaming).

Operations

Optimization

Globally optimizing the schedule using one of the solvers to minimize conflicts and reassignments while optimizing for rules.

Operations

Organizations & Planning

Managing the plannings and organizations you have access to.

Operations

AI Agent

Interacting with the conversational AI assistant for planning and queries.

Operations

Utility

Utility endpoints, such as generating schedule visualizations.

Operations

Token

API authentication token management (e.g., obtaining auth tokens).

Tags

Our mechanism for indicating constraints, penalties or preferences.

Operations

Rules

Can be used together with Tags to specify preferences or penalties.

Operations

Authentication

Operations

Entity History

Operations

Operation Groups

Operations

Assignment History

Operations

Plannings

Operations

Workspaces

Operations
Copyright © Transformers Group