AccountService
AccountService identifies the caller and reports the caller's storage.
Caller operations derive authority from credentials, never request account ids. GetPublicProfile publishes only identity fields for a namespace, without credentials. Conventions and error codes: see common.proto.
CreatePurchase
/rpc/uno.kit.v1.AccountService/CreatePurchaseCreates or refreshes an Agent purchase, never pays. Same key and inputs returns the result, the unexpired quote, or a fresh quote under the same purchase after quote expiry. Changed inputs are INVALID_ARGUMENT. Writers default off; no payment challenge or offer is issued.
Header Parameters
Request Body
application/jsonResponses
objectReturned only after authenticating the purchase owner. Possession of a purchase ID, Payment credential, or payer wallet grants no owner authority.
objectThe same authoritative owner observation is used by GetStorage, GetQuota, and storage refusals. Never include this message in an anonymous payer view.
objectOwner-only Agent write guidance and typed payment error/pending detail. Codes are Connect code literals; reason is also carried by google.rpc.ErrorInfo (domain uno.kit.v1). On success code and reason are absent. next_action is required for errors and pending work. Storage is current; the receipt retains the original write identity.
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
CreateVideoUpload
/rpc/uno.kit.v1.AccountService/CreateVideoUploadGrants one presigned PUT for the source file of a video. The owner comes from the credential, which must belong to a claimed Uno account. The key carries the tag of the owner. The URL signs the exact Content-Length. RESOURCE_EXHAUSTED when no video minute is free.
Header Parameters
Request Body
Responses
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
GetCapabilities
/rpc/uno.kit.v1.AccountService/GetCapabilitiesThe effective limits this server enforces today: staging, read and payment ceilings with their units, names and enforcement operations. A client preflights against these values and reads the same names back in LimitExceeded error details. A raise is a server configuration change that every client picks up.
Header Parameters
Request Body
application/jsonResponses
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
GetPublicProfile
/rpc/uno.kit.v1.AccountService/GetPublicProfileReturns the public identity linked to a namespace. Unknown, unclaimed, and deleted accounts have no profile. An unverified account has a profile with its username and unverified set. This call needs no credential.
Header Parameters
Request Body
Responses
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
GetPurchase
/rpc/uno.kit.v1.AccountService/GetPurchaseOwner credentials return the owner projection; no credential returns only the anonymous projection. Another authenticated owner gets NOT_FOUND. Owner point reads are served. Anonymous projection is not yet served.
Header Parameters
Request Body
Responses
objectReturned only after authenticating the purchase owner. Possession of a purchase ID, Payment credential, or payer wallet grants no owner authority.
objectSafe for anyone possessing the opaque purchase link: terms, payment status, and receipts only. No usage, reservations, per-Kit data, or owner capabilities.
objectOwner-only Agent write guidance and typed payment error/pending detail. Codes are Connect code literals; reason is also carried by google.rpc.ErrorInfo (domain uno.kit.v1). On success code and reason are absent. next_action is required for errors and pending work. Storage is current; the receipt retains the original write identity.
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
GetQuota
/rpc/uno.kit.v1.AccountService/GetQuotaReturns the caller's storage quota and payment links. Maps the MCP tool uno_quota.
Header Parameters
Request Body
Responses
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
GetStorage
/rpc/uno.kit.v1.AccountService/GetStorageComplete owner storage observation, including paginated Kit sizes and recoverable open and paid purchases. Authority comes from credentials.
Header Parameters
Request Body
Responses
objectThe same authoritative owner observation is used by GetStorage, GetQuota, and storage refusals. Never include this message in an anonymous payer view.
object[]Owner lookup needs no purchase ID or originating runtime journal. Includes quoted, pending, settled, failed and expired purchases, not only open ones.
objectOwner-only Agent write guidance and typed payment error/pending detail. Codes are Connect code literals; reason is also carried by google.rpc.ErrorInfo (domain uno.kit.v1). On success code and reason are absent. next_action is required for errors and pending work. Storage is current; the receipt retains the original write identity.
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
GetVideoJob
/rpc/uno.kit.v1.AccountService/GetVideoJobReads the state of one video job of the caller. A job of another owner is NOT_FOUND, the same as an unknown job.
Header Parameters
Request Body
Responses
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
Pay
/rpc/uno.kit.v1.AccountService/PayBuys or renews hosting with an MPP Payment credential. Missing payment returns an HTTP 402 challenge. No wallet is charged by this RPC alone. A pending or uncertain payment excludes only its own purchase. Provider attempts remain fixed until settlement or a definitive failure.
Header Parameters
Request Body
application/jsonbooleanRenew an active 30-day term. False adds storage during an active term. A purchase after expiry starts a fresh term with either flag.
stringA challenge to replay. A paid Tempo charge returns its original receipt.
An unpaid charge answers HTTP 402 with this challenge, or a fresh one
for the same purchase after expiry. tempo request sends the challenge
in the body, then pays it and retries. A subscription plan selector is refused.
booleanRead the original receipt for challenge without admitting or refreshing a purchase. Requires only challenge, with no credential or other purchase fields. An unpaid purchase answers NOT_FOUND with reason PURCHASE_NOT_PAID.
objectAgent purchase action. Exclusive of fields 1-7; its response contains only the anonymous purchase projection, even when a Bearer is supplied. Currently UNIMPLEMENTED, before any legacy payment processing.
Responses
stringThe hash of the settled payment transaction, as 0x-prefixed hex. Empty when this call issued a challenge instead of settling a payment.
string <int64>Nonzero when this hash bought extra time for an already-paid purchase.
objectFor the Agent purchase action only. All legacy owner/subscription fields above are unset. Never attach a StorageSnapshot to this payer response.
objectOwner-only Agent write guidance and typed payment error/pending detail. Codes are Connect code literals; reason is also carried by google.rpc.ErrorInfo (domain uno.kit.v1). On success code and reason are absent. next_action is required for errors and pending work. Storage is current; the receipt retains the original write identity.
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
Header Parameters
Request Body
Responses
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
SubmitVideo
/rpc/uno.kit.v1.AccountService/SubmitVideoHolds video minutes for one uploaded source and starts its vidx job in the same call.
The owner comes from the credential, which must belong to a claimed Uno account. Over quota
is RESOURCE_EXHAUSTED and holds nothing. A repeat with the same source key returns the same
job id. NOT_FOUND when the source is absent or belongs to another owner.
Header Parameters
Request Body
Responses
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
WhoAmI
/rpc/uno.kit.v1.AccountService/WhoAmIReturns the caller's account and the server's public endpoints. Maps the MCP tool uno_whoami.
Header Parameters
Request Body
application/jsonResponses
stringEmpty until claimed. Claiming preserves the namespace and signing owner. It holds the Uno account id.
stringThe status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
canceledunknowninvalid_argumentdeadline_exceedednot_foundstringA developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.