How to: Change the Container state

3min
﻿
Before you can containerize a child Container, must set the parent and child containers to the appropriate lifecycle state. For more information about Lifecycle States, see the 'Lifecycle of a Container' in Container﻿.
The parent Container must be in the opened state, and the child container must be in the closed state.
By default, the state of a new Container is created. To set a Container to opened, you must specify an event code of E-025 and a reason code of R-0001 in the request body.
To set the parent container to opened, call the Apply Event on Container﻿ endpoint and pass a request body similar to the following:

JSON
{
  "eventCode": "E-025",
  "timestamp": 1661375504,
  "reasonCode":"R-0001",
  "data": {
  },
  "source": {
    "appId": "sid3",
    "userId": "sid2",
    "locId":"sid2"
  }
}
{
  "eventCode": "E-025",
  "timestamp": 1661375504,
  "reasonCode":"R-0001",
  "data": {
  },
  "source": {
    "appId": "sid3",
    "userId": "sid2",
    "locId":"sid2"
  }
}
﻿

The response body will look similar to the following:

JSON
{
    "data": {
        "id": "pallet1:11dafb08-f309-5b1d-8d31-7761a75c99ee",
        "state": "opened:opened"
    },
    "request": {
        "uri": "/core/api/v2/containers/boxtwo:11dafb08-f309-5b1d-8d31-7761a75c99ee/state/event",
        "method": "PUT",
        "queryString": "{}",
        "body": {
            "eventCode": "E-025",
            "timestamp": 1661375504,
            "reasonCode": "R-0001",
            "data": {},
            "source": {
                "appId": "sid3",
                "userId": "sid2",
                "locId": "sid2"
            },
            "propagate": false
        }
    }
}
{
    "data": {
        "id": "pallet1:11dafb08-f309-5b1d-8d31-7761a75c99ee",
        "state": "opened:opened"
    },
    "request": {
        "uri": "/core/api/v2/containers/boxtwo:11dafb08-f309-5b1d-8d31-7761a75c99ee/state/event",
        "method": "PUT",
        "queryString": "{}",
        "body": {
            "eventCode": "E-025",
            "timestamp": 1661375504,
            "reasonCode": "R-0001",
            "data": {},
            "source": {
                "appId": "sid3",
                "userId": "sid2",
                "locId": "sid2"
            },
            "propagate": false
        }
    }
}
﻿
App ID is required and should be set to the Client ID of your App. For information about registering an App and retrieving the Client ID, see the "Register an App" section of Getting started with building Apps﻿.
A leaf container must be in the closed state to be containerized. States are sequential. A new Container is in the created state, you must set the Container to opened and then to closed.
To set the child box Container to opened, call the Apply Event on Container﻿ endpoint and pass a request body similar to the following:

JSON
{
    "data": {
        "id": "pallet1:1a3057a3-fc75-40ed-ac28-989c9d3d1551",
        "state": "opened:opened",
        "event": {
            "eventCode": "E-026",
            "reasonCode": "R-0001",
            "timestamp": 1661375504,
            "propagate": false,
            "data": {},
            "source": {
                "appId": "sid3",
                "userId": "sid2",
                "locId": "sid2"
            }
        },
        "stateChange": true
    }
}
{
    "data": {
        "id": "pallet1:1a3057a3-fc75-40ed-ac28-989c9d3d1551",
        "state": "opened:opened",
        "event": {
            "eventCode": "E-026",
            "reasonCode": "R-0001",
            "timestamp": 1661375504,
            "propagate": false,
            "data": {},
            "source": {
                "appId": "sid3",
                "userId": "sid2",
                "locId": "sid2"
            }
        },
        "stateChange": true
    }
}
﻿

To set the child box Container to closed, call the Apply Event on Container﻿ endpoint and pass a request body that specifies an event code of E-026:

JSON
{
  "eventCode": "E-026",
  "timestamp": 1661375504,
  "reasonCode":"R-0001",
  "data": {
  },
  "source": {
    "appId": "sid3",
    "userId": "sid2",
    "locId":"sid2"
  }
}
{
  "eventCode": "E-026",
  "timestamp": 1661375504,
  "reasonCode":"R-0001",
  "data": {
  },
  "source": {
    "appId": "sid3",
    "userId": "sid2",
    "locId":"sid2"
  }
}
﻿
﻿
Updated 16 Aug 2023
Did this page help you?
How to: Create a Container
How to: Containerize a child Container