ShareAI Platform Docs

Back to ShareAI API Reference

EN

Console

Read device sessions and task history

List ShareAI device sessions and inspect a session’s task history using a device-specific Remote Control token.

View as Markdown

On this page

GET https://api.shareai.now/api/v1/console/provider/{provider_uuid}/device-management/{device_uuid}/remote/sessions

List sessions for this device relationship.

Base URL: https://api.shareai.now
Authentication: HTTP Basic: provider UUID and device access token

Connection and activity help distinguish setup from actual sharing.

Connection and activity help distinguish setup from actual sharing.

Use page, limit and order for session pagination. Read the returned page information and identifiers; do not assume every session fits in the first page.

cURL

curl --fail-with-body \
  "https://api.shareai.now/api/v1/console/provider/$PROVIDER_UUID/device-management/$DEVICE_UUID/remote/sessions?page=1&limit=20&order=desc" \
  -u "$PROVIDER_UUID:$DEVICE_ACCESS_TOKEN"

Inspect one session#

GET

https://api.shareai.now/api/v1/console/provider/{provider_uuid}/device-management/{device_uuid}/remote/session/{session_id}

Read a session and its paginated tasks.

Base URL: https://api.shareai.now
Authentication: HTTP Basic: provider UUID and device access token

cURL

curl --fail-with-body \
  "https://api.shareai.now/api/v1/console/provider/$PROVIDER_UUID/device-management/$DEVICE_UUID/remote/session/$SESSION_ID?tasks_page=1&tasks_limit=20&tasks_order=desc" \
  -u "$PROVIDER_UUID:$DEVICE_ACCESS_TOKEN"

Keep session and task pagination separate#

The detail endpoint uses tasks_page, tasks_limit and tasks_order for its task list. Start from a session identifier returned for the same device; a session from another relationship is not accessible with this credential.

Operational use#

Use sessions to correlate a connectivity interval with observed activity. An empty page can mean no activity in that interval. It is not proof that the device is permanently offline or that every model is unavailable.

Access prerequisites#

The same connection and Remote Control checks apply to reads and sharing commands. Review Device API authentication when a request returns 403.

Last updated September 15, 2026

Color theme: {theme}LightDarkSystemMatching articles: {count}Copied {identifier}Remove {label} filterServerlessAccessProvidersTrainingRetentionHeadquartersGPU Cluster / DatacenterPoliciesAccess · RecommendedCreditsUse ShareAI credits to support GPU owners in exchange for the computing power they are not using.Your credits reward the people and companies sharing idle compute. We recommend this option to support more sustainable use of existing hardware.ShareAI combines technical safeguards with provider agreements to help protect your data.Token exchangeShareAI providers can serve inference for others and earn input and output tokens for the work they contribute. They can then use those tokens for their own inference when they need it.Like energy prosumers who both produce and consume electricity, you can become an AI prosumer: contribute compute when it is idle and use the network when you need it.Fun factIn March 2025, ShareAI became the world’s first platform for AI prosumers. Offset your own AI usage through token exchange, or earn payouts at month-end through paid contributions.CommunityCommunity providers are individuals who share their computing power in exchange for credits or tokens through token exchange.They put otherwise unused compute to work for others across the ShareAI network.ShareAI takes steps to protect your data, and every provider, Community or Company, signs an agreement. For sensitive workloads, we recommend Company providers.CompanyEvery Company provider signs a rigorous agreement. ShareAI’s safeguards extend beyond code to the company’s accountability and reputation.We review where the company is headquartered, who formed it and its ownership structure to understand the ultimate beneficial owners behind it.Region & your personal dataPersonal-data rules differ between countries and regions. A provider can remain subject to the laws of the country where it is established, even when its datacenters are elsewhere.Hosting data in another region does not automatically remove those obligations. Rules where the data is processed, and protections that apply to you, may also matter.Check the provider’s legal entity, processing locations and privacy policy before sharing personal data.Close region informationClose explanationSearching…Explore documentationNo articles found. Try another search or knowledge base.Search is unavailable. Please try again.Copied!Page copied.Copy failedCopy failed. Select the page text to copy it manually.Copy pagePage link copied.Could not copy the link. Copy it from the address bar.Preparing Markdown…Could not copy. Try again or open View as Markdown.Copy identifierCopiedCopy model identifierCopy from providerCopy prefixCopy failed. Select the prefix to copy it manually.Model identifier copiedCopied {prefix}. Add the model identifier after the slash.Could not copy. Select this identifier: {identifier}Verification could not load. Please retry or open a ticket from your ShareAI account.Verification could not load. Please try again.Please complete the verification before sending your message.Your message has been sent. Thank you — the ShareAI team will reply by email.We could not confirm delivery. Please check your connection before trying again.Sending…We could not send your message. Please try again.Please send this form from ShareAI.Your message is too long. Please keep it under 10,000 characters.Please enter a valid email address.Enter a valid email address.Please enter a message of up to 10,000 characters.Please shorten your name or subject.Please complete the verification.Complete the verification.Please check this field.Verification failed. Please try again.Please check your details and try again.We could not confirm delivery. Please try again later or open a support ticket.{date}: {uptime}. Online {online}, offline {offline}, unobserved {unknown}.No observations{percent} observed uptime{percent} uptimeObserved daily uptime and recording coverage for {days} days. Missing observations are gaps, not zero uptime. Use the arrow keys or daily details controls to explore.Recording coverageOnlineOfflineUnobservedObserved uptime{percent} of this period coveredOf the recorded timeWaiting for observationsDisconnected during checksNo history available yetLast {days} daysHistory is buildingNo observations in this period{date} is the first recorded day in this view.Recorded checks will appear here as they arrive.Showing the last {days} days. {details}Online observedOffline observedClose navigationOpen navigationUse the form to send your message.Form not found.Unsupported form data.Invalid form data.