Equinix Fabric API v4 | Equinix Product Documentation

Update Loa

Request

The API provides capability to update Loa details by Loa ID

Security

BearerAuth

Path

loaIdstring, (uuid)required

Loa UUID

Example:29cc7878-54e3-4e1a-8651-87a61354bac2

Bodyapplication/json-patch+jsonrequired

Array [

opstring(LoaOpEnum)required

Operation to be performed

Enum:"replace""add""remove"

pathstring(LoaPath)required

A JSON Pointer path.

/name - Name of the Loa
/description - Description of the Loa
/requestor/email - Email of the requestor contact
/requestor/orgName - Organization name of the requestor
/issuer/email - Email of the issuer contact
/issuer/orgName - Organization name of the issuer
/demarcationPoint/patchPanelId - Patch Panel Identifier
/demarcationPoint/patchPanelPortA - Patch Panel Port A
/demarcationPoint/patchPanelPortB - Patch Panel Port B
/demarcationPoint/connectorType - Connector Type
/demarcationPoint/cageUniqueSpaceId - Cage Unique Space Identifier
/expirationDateTime - Expiration date and time of the Loa
/location/ibxCode - IBX code of the Eligible location

valueanyrequired

New value for updated parameter

]

Payload

[
  {
    "op": "replace",
    "path": "/demarcationPoint/patchPanelId",
    "value": "CP:Demarc:1259685"
  }
]

Responses

Successful operation

Bodyapplication/json

hrefstring, (uri)

URI of this LOA resource.

Example:"https://api.equinix.com/fabric/v4/loas/29cc7878-54e3-4e1a-8651-87a61354bac2"

uuidstring, (uuid)

Unique identifier of this LOA.

Example:"29cc7878-54e3-4e1a-8651-87a61354bac2"

typestring(LoaType)

Type of Letter of Authorization

Enum:"CAGE_LOA""PATCH_PANEL_LOA""PATCH_PANEL_PORT_LOA"

Example:"PATCH_PANEL_PORT_LOA"

namestring

A short, descriptive name for this LOA

Example:"LOA-Equinix-SV1-2026"

descriptionstring

Additional context about this LOA

Example:"Authorization for patch panel port access to Equinix at SV1"

authorizedProductTypestring(LoaProductType)

Product type associated with this LOA.
XC - Cross Connect
XF_PORT - Fabric Port
VD - Network Edge

Enum:"XC""XF_PORT""VD"

Example:"XC"

statestring(LoaState)

Current lifecycle state of the LOA.

Enum:"PENDING""FAILED""PENDING_AUTHORIZATION""PENDING_ACCEPTANCE""CANCELLED""INACTIVE""ACTIVE""EXPIRED"

Example:"ACTIVE"

operationobject

requestorobject(LoaRequestor)

Requestor

issuerobject(LoaIssuer)

Issuer

demarcationPointobject(LoaDemarcationPoint)

Specifies the demarcation point.
For CAGE_LOA - cageUniqueSpaceId is required.
For PATCH_PANEL_LOA - patchPanelId is required.
For PATCH_PANEL_PORT_LOA - patchPanelId, patchPanelPortA, patchPanelPortB and connectorType is required.

locationobject(LoaLocation)

Eligible location where LOA can be issued.

expirationDateTimestring, (date-time)(LoaExpiration)

Date and time when this LOA expires.
Default to 3 months from the creation date

Example:"2026-11-06T07:00:00Z"

changeLogobject(LoaChangelog)

Change log

Response

{
  "href": "https://api.equinix.com/fabric/v4/loas/29cc7878-54e3-4e1a-8651-87a61354bac2",
  "uuid": "29cc7878-54e3-4e1a-8651-87a61354bac2",
  "type": "PATCH_PANEL_PORT_LOA",
  "name": "LOA-Equinix-SV1-2026",
  "description": "Authorization for cage access to Equinix at SV1",
  "authorizedProductType": "XC",
  "state": "INACTIVE",
  "operation": {
    "consumersCount": 1
  },
  "requestor": {
    "email": "user@org1.com",
    "orgId": 95900,
    "orgName": "organizationName1"
  },
  "issuer": {
    "email": "user@org2.com",
    "orgId": 95901,
    "orgName": "organizationName2"
  },
  "demarcationPoint": {
    "patchPanelId": "CP:Demarc:1259684",
    "patchPanelPortA": 23,
    "patchPanelPortB": 23,
    "connectorType": "SC"
  },
  "location": {
    "ibxCode": "SV1"
  },
  "changeLog": {
    "createdDateTime": "2026-07-24T06:50:46Z",
    "createdBy": "user",
    "createdByEmail": "user@org2.com"
  }
}