/startAdministrativeSession

1 min

POST

Calling this request is used to start a new MPC Driven admin session. Only one request per machine (cold/MPC) can exist at a time.

Request Example:

    .. code-block::

        startAdministrativeSession(
          SnapshotId="1773570326332099007",
          request_extra_data={
                 "MessageNumber": 1,
                 "SessionId": "73a7a9ce-80af-4297-a2a4-e570373e1375"
              }
        )

    ----

    **Response Example:**

    .. code-block::

        {
            "FunctionData": {
                "StatusCode": 0,
                "StatusCodeDescription": "Session started successfully"
            },
            "Meta": {
                  "AccessToken": "58f08df6e369fa4d126e1ba5c7f66cf85c9c79df32d05fee8f3c542121c87cf5",
                  "Destination": "044fd7dc60304b8aceeb662ce41bf9d9cc132278c0871c0a72fb4f3cecbabb25a86e43ae28dab21a95c64e2db76abdcfffb9bfdeec67a21399cfa5f555f01d054b",
                  "Source": "be1f60e490b8ccabcc02a4595817b8edf45905d24944e87b8e3cae27f158df63843bfc4b09d37a5e752017b74ea2d136af272bea210f059e768e1ea8777aaf21e9",
                  "Time": "2025-10-19 15:04:13.129"
                }
        }

    ----

Error Responses

Error Type	Http Code	GK8 error code	Reason / Description	Example Response
Backend Response	400	1	Session ID already exists	"StatusCode": 1
Backend Response	400	2	Incorrect snapshot ID	"StatusCode": 2 , "SnapshotId": "timestamp"
Backend Response	400	3	Session already running	"StatusCode": 3 , "UserId": "[email protected]"
Backend Response	400	4	Cosigners snapshot update in progress	"StatusCode": 4 , "Machine": "MPC"
Backend Response	400	5	Invalid system approval workflow in use	"StatusCode": 5 , "ApprovalWorkflowIds": ["123", "435"]

snapshot_idstringA timestamp of the last known snapshot for the MPC in nanoseconds

request_extra_dataobjectadditional data for the administrative request

acceptstringGenerated from available response content types

bodyobject

200success

curl --request POST \
     --url '/startAdministrativeSession?snapshot_id=1646713200000000000&request_extra_data=%22None%22' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "FunctionData": {
     "SnapshotId": "timestamp",
     "RequestExtraData": {
     "MessageNumber": 5,
     "SessionId": "3478593863424051983840947"
     }
     },
     "Meta": {
     "FunctionName": "startAdministrativeSession",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'