Start and stop device sharing

Use these commands to request a sharing-state change for one authorized device. The provider and device UUIDs must refer to the same relationship as the device access token.

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/console/provider/$PROVIDER_UUID/device-management/$DEVICE_UUID/remote/start-sharing" \
  -u "$PROVIDER_UUID:$DEVICE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{}'

Read the acknowledgement#

{
  "status": "success",
  "result": {
    "accepted": true,
    "command": "start-sharing",
    "reason": "provider_api_start_sharing",
    "message": "Start sharing command accepted."
  }
}

This is an illustrative acknowledgement. accepted means the command was accepted for dispatch; it does not by itself prove that the device has transitioned, has a model loaded or is receiving work.

Verify the actual state#

1. Read the command response and handle a rejected request.
2. Check the device state and its sharing models in Console.
3. Use sessions and activity to verify what the device actually did.
4. If it stays unchanged, check connectivity, loaded models, device eligibility and the enabled Remote Control switches before retrying.

Stop carefully#

Use the same path with stop-sharing to request a stop. Keep already processed work distinct from the ability to receive future work. A stop request is not a refund or a deletion of session history.