Skip to content
Bpanda
Esc
↑↓navigate↵open⌘Jpreview

List a single element by external ID.

List a single element by external ID. Get the architecture element an externalId means, among what the caller may read: the draft of its lineage, or else its newest published version. Where several lineages carry the externalId, a working draft wins over a published one, then the newest. Does the edition of the process space not include the type of that version, the newest version of the same lineage whose type it does include is answered instead - the one byElementIds hands out. Covers the edition no version of that lineage, the element is refused with 403; another lineage carrying the same externalId is not offered in its place, so byExternalIds can still answer where this route refuses.

Security: Any user holding a Bpanda licence for the process space.

GET/v1/warehouses/{warehouseId}/architectureElements/byExternalId/{externalId}
Authorization
AuthorizationBearer token (JWT) · headerrequired
BpmLicenseAPI key · headerrequired
Path parameters
warehouseIdstringrequired

Warehouse-Id

externalIdstringrequired

ArchitectureElement-ExternalId

Responses
200

Found ArchitectureElement

conceptualClassArchitectureElementTyperequired
Allowed:ApplicationCollaborationApplicationComponentApplicationEventApplicationFunctionApplicationInteractionApplicationInterfaceApplicationProcessApplicationServiceArchitectureElementArtifactAssessmentBusinessActorBusinessCollaborationBusinessEventBusinessFunctionBusinessInteractionBusinessInterfaceBusinessObjectBusinessProcessBusinessRoleBusinessServiceCapabilityCommunicationNetworkCommunicationPathConstraintContractCourseOfActionDataObjectDeliverableDeviceDistributionNetworkDriverEquipmentFacilityGapGoalGroupingImplementationEventLocationMaterialMeaningNodeOutcomePlateauPrincipleProductRepresentationRequirementResourceStakeholderSystemSoftwareTechnologyCollaborationTechnologyEventTechnologyFunctionTechnologyInteractionTechnologyInterfaceTechnologyProcessTechnologyServiceValueValueStreamWorkPackage
createdHistoryrequired
Show properties
atstringrequired
bystringrequired
elementIdstringrequired
externalIdstring
groupsArchitectureGroup[]required
Show properties
Array of ArchitectureGroup
corebooleanrequired
descriptionTranslatedString
Show properties
defaultLanguagestringrequired
translationsTranslation[]required
Show properties
Array of Translation
languagestringrequired
valuestringrequired
keystringrequired
labelTranslatedString
Show properties
defaultLanguagestringrequired
translationsTranslation[]required
hasPredecessorbooleanrequired
idstringrequired
lastValidationHistory
Show properties
atstringrequired
bystringrequired
layerArchitectureElementLayerrequired
Allowed:ApplicationLayerBusinessLayerGenericLayerImplementationAndMigrationLayerMotivationElementsStrategyLayerTechnologyLayer
modifiedHistory
Show properties
atstringrequired
bystringrequired
ownersEntityId[]required
Show properties
Array of EntityId
typeEntityIdTyperequired
Allowed:GroupIdOrgRoleIdOrgUnitIdUserId
valuestringrequired
principalIsOwnerbooleanrequired
propertiesArchitectureProperty[]required
Show properties
Array of ArchitectureProperty
enumKeystring
metaArchitectureMetaPropertyrequired
Show properties
corebooleanrequired
descriptionTranslatedString
groupstring
keystringrequired
labelTranslatedString
typeArchitecturePropertyTyperequired
Allowed:BBCodeBooleanDateDateTimeDecimalEnumIntegerStringTime
validationArchitecturePropertyValidation
Show properties
enumLiteralsArchitectureEnumLiteral[]
Show properties
Array of ArchitectureEnumLiteral
deprecatedbooleanrequired
keystringrequired
labelTranslatedStringrequired
literalsTranslatedString[]
lowerBoundstring
mandatorybooleanrequired
upperBoundstring
valueTranslatedString
Show properties
defaultLanguagestringrequired
translationsTranslation[]required
publishedHistory
Show properties
atstringrequired
bystringrequired
referencesArchitectureReference[]required
Show properties
Array of ArchitectureReference
metaArchitectureMetaReferencerequired
Show properties
corebooleanrequired
descriptionTranslatedString
groupstring
keystringrequired
labelTranslatedString
multiplicityArchitectureReferenceMultiplicityrequired
Allowed:ExactlyOneOneOrMoreZeroOrMoreZeroOrOne
targetClassesstring[]required
targetReference
Show properties
assignedArchitectureElementRefsArchitectureElementRef[]required
Show properties
Array of ArchitectureElementRef
conceptualClassArchitectureElementTyperequired
Allowed:ApplicationCollaborationApplicationComponentApplicationEventApplicationFunctionApplicationInteractionApplicationInterfaceApplicationProcessApplicationServiceArchitectureElementArtifactAssessmentBusinessActorBusinessCollaborationBusinessEventBusinessFunctionBusinessInteractionBusinessInterfaceBusinessObjectBusinessProcessBusinessRoleBusinessServiceCapabilityCommunicationNetworkCommunicationPathConstraintContractCourseOfActionDataObjectDeliverableDeviceDistributionNetworkDriverEquipmentFacilityGapGoalGroupingImplementationEventLocationMaterialMeaningNodeOutcomePlateauPrincipleProductRepresentationRequirementResourceStakeholderSystemSoftwareTechnologyCollaborationTechnologyEventTechnologyFunctionTechnologyInteractionTechnologyInterfaceTechnologyProcessTechnologyServiceValueValueStreamWorkPackage
elementIdstringrequired
referenceDirectionReferenceDirectionrequired
Allowed:BidirectionalNoneSourceTarget
referenceKindReferenceKindrequired
Allowed:AccessAggregationArchitectureReferenceAssignmentAssociationCompositionFlowInfluenceRealizationServingSpecializationTriggering
specializationstring
createdHistoryrequired
linkedElementsRefId[]required
modifiedHistory
propertiesArchitectureProperty[]required
relationshipIdstringrequired
representationRefId
Show properties
typestringrequired
specializationstring
validityStateArchitectureValidityStaterequired
Allowed:DraftInvalidNextUpcomingValid
visibilityVisibilityrequired
Show properties
lastChangeHistoryrequired
Show properties
atstringrequired
bystringrequired
visiblebooleanrequired
403

The edition of this process space includes no version of this element's lineage

string
404

Warehouse not found or no readable element with this externalId

string
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://goto.bpanda.com/api/v1/warehouses/string/architectureElements/byExternalId/string' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'BpmLicense: YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "conceptualClass": "ApplicationCollaboration",
  "created": {
    "at": "string",
    "by": "string"
  },
  "elementId": "string",
  "externalId": "string",
  "groups": [
    {
      "core": true,
      "description": {
        "defaultLanguage": "string",
        "translations": [
          {
            "language": "string",
            "value": "string"
          }
        ]
      },
      "key": "string",
      "label": {
        "defaultLanguage": "string",
        "translations": [
          {
            "language": "string",
            "value": "string"
          }
        ]
      }
    }
  ],
  "hasPredecessor": true,
  "id": "string",
  "lastValidation": {
    "at": "string",
    "by": "string"
  },
  "layer": "ApplicationLayer",
  "modified": {
    "at": "string",
    "by": "string"
  },
  "owners": [
    {
      "type": "GroupId",
      "value": "string"
    }
  ],
  "principalIsOwner": true,
  "properties": [
    {
      "enumKey": "string",
      "meta": {
        "core": true,
        "description": {
          "defaultLanguage": "string",
          "translations": [
            {
              "language": "string",
              "value": "string"
            }
          ]
        },
        "group": "string",
        "key": "string",
        "label": {
          "defaultLanguage": "string",
          "translations": [
            {
              "language": "string",
              "value": "string"
            }
          ]
        },
        "type": "BBCode",
        "validation": {
          "enumLiterals": [
            {
              "deprecated": true,
              "key": "string",
              "label": {
                "defaultLanguage": "string",
                "translations": [
                  {
                    "language": "string",
                    "value": "string"
                  }
                ]
              }
            }
          ],
          "literals": [
            {
              "defaultLanguage": "string",
              "translations": [
                {
                  "language": "string",
                  "value": "string"
                }
              ]
            }
          ],
          "lowerBound": "string",
          "mandatory": true,
          "upperBound": "string"
        }
      },
      "value": {
        "defaultLanguage": "string",
        "translations": [
          {
            "language": "string",
            "value": "string"
          }
        ]
      }
    }
  ],
  "published": {
    "at": "string",
    "by": "string"
  },
  "references": [
    {
      "meta": {
        "core": true,
        "description": {
          "defaultLanguage": "string",
          "translations": [
            {
              "language": "string",
              "value": "string"
            }
          ]
        },
        "group": "string",
        "key": "string",
        "label": {
          "defaultLanguage": "string",
          "translations": [
            {
              "language": "string",
              "value": "string"
            }
          ]
        },
        "multiplicity": "ExactlyOne",
        "targetClasses": [
          "string"
        ]
      },
      "target": {
        "assignedArchitectureElementRefs": [
          {
            "conceptualClass": "ApplicationCollaboration",
            "elementId": "string",
            "referenceDirection": "Bidirectional",
            "referenceKind": "Access",
            "specialization": "string"
          }
        ],
        "created": {
          "at": "string",
          "by": "string"
        },
        "linkedElements": [
          {
            "type": "string"
          }
        ],
        "modified": {
          "at": "string",
          "by": "string"
        },
        "properties": [
          {
            "enumKey": "string",
            "meta": {
              "core": true,
              "description": {
                "defaultLanguage": "string",
                "translations": [
                  {
                    "language": "string",
                    "value": "string"
                  }
                ]
              },
              "group": "string",
              "key": "string",
              "label": {
                "defaultLanguage": "string",
                "translations": [
                  {
                    "language": "string",
                    "value": "string"
                  }
                ]
              },
              "type": "BBCode",
              "validation": {
                "enumLiterals": [
                  {
                    "deprecated": true,
                    "key": "string",
                    "label": {
                      "defaultLanguage": "string",
                      "translations": [
                        {
                          "language": "string",
                          "value": "string"
                        }
                      ]
                    }
                  }
                ],
                "literals": [
                  {
                    "defaultLanguage": "string",
                    "translations": [
                      {
                        "language": "string",
                        "value": "string"
                      }
                    ]
                  }
                ],
                "lowerBound": "string",
                "mandatory": true,
                "upperBound": "string"
              }
            },
            "value": {
              "defaultLanguage": "string",
              "translations": [
                {
                  "language": "string",
                  "value": "string"
                }
              ]
            }
          }
        ],
        "relationshipId": "string"
      }
    }
  ],
  "representation": {
    "type": "string"
  },
  "specialization": "string",
  "validityState": "Draft",
  "visibility": {
    "lastChange": {
      "at": "string",
      "by": "string"
    },
    "visible": true
  }
}