JavaScript API - Adama Platform

Methods: InitSetupAccount, InitConvertGoogleUser, InitCompleteAccount, Deinit, AccountSetPassword, AccountGetPaymentPlan, AccountLogin, AccountSocialLogin, Probe, Stats, IdentityHash, IdentityStash, AuthorityCreate, AuthoritySet, AuthorityGet, AuthorityList, AuthorityDestroy, SpaceCreate, SpaceGenerateKey, SpaceGet, SpaceSet, SpaceRedeployKick, SpaceSetRxhtml, SpaceGetRxhtml, SpaceSetPolicy, PolicyGenerateDefault, SpaceGetPolicy, SpaceMetrics, SpaceDelete, SpaceSetRole, SpaceListDevelopers, SpaceReflect, SpaceList, PushRegister, DomainMap, DomainClaimApex, DomainRedirect, DomainConfigure, DomainReflect, DomainMapDocument, DomainList, DomainListBySpace, DomainGetVapidPublicKey, DomainUnmap, DomainGet, DocumentDownloadArchive, DocumentListBackups, DocumentForceBackup, DocumentDownloadBackup, DocumentListPushTokens, DocumentAuthorization, DocumentAuthorizationDomain, DocumentAuthorize, DocumentAuthorizeDomain, DocumentAuthorizeWithReset, DocumentAuthorizeDomainWithReset, DocumentCreate, DocumentDelete, DocumentList, MessageDirectSend, MessageDirectSendOnce, ConnectionCreate, ConnectionCreateViaDomain, ConnectionSend, ConnectionPassword, ConnectionSendOnce, ConnectionCanAttach, ConnectionAttach, ConnectionUpdate, ConnectionEnd, DocumentsCreateDedupe, DocumentsHashPassword, BillingConnectionCreate, FeatureSummarizeUrl, ReplicationCreate, ReplicationEnd, AttachmentStart, AttachmentStartByDomain, AttachmentAppend, AttachmentFinish

wire method:init/setup-account

This initiates developer machine via email verification.

name	required	type	documentation
email	yes	String	The email of an Adama developer.

connection.InitSetupAccount(email, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

wire method:init/convert-google-user

The converts and validates a google token into an Adama token.

name	required	type	documentation
access-token	yes	String	A token from a third party authorization service.

connection.InitConvertGoogleUser(access-token, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

wire method:init/complete-account

This establishes a developer machine via email verification.

Copy the code from the email into this request.

The server will generate a key-pair and send the secret to the client to stash within their config, and the public key will be stored to validate future requests made by this developer machine.

A public key will be held onto for 30 days.

name	required	type	documentation
email	yes	String	The email of an Adama developer.
revoke	no	Boolean	A flag to indicate wiping out previously granted tokens.
code	yes	String	A randomly (secure) generated code to validate a user via 2FA auth (via email).

connection.InitCompleteAccount(email, revoke, code, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

wire method:deinit

This will destroy a developer account. We require all spaces to be deleted along with all authorities.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

connection.Deinit(identity, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

wire method:account/set-password

Set the password for an Adama developer.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
password	yes	String	The password for your account or a document

connection.AccountSetPassword(identity, password, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

wire method:account/get-payment-plan

Get the payment plan information for the developer.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

connection.AccountGetPaymentPlan(identity, {
  success: function(response) {
    // response.paymentPlan
    // response.publishableKey
  },
  failure: function(reason) {
  }
});

name	type	documentation
payment-plan	String	Payment plan name. The current default is "none" which can be upgraded to "public".
publishable-key	String	The public key from the merchant provider.

wire method:account/login

Sign an Adama developer in with an email and password pair.

name	required	type	documentation
email	yes	String	The email of an Adama developer.
password	yes	String	The password for your account or a document

connection.AccountLogin(email, password, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

wire method:account/social-login

Sign an Adama user in with an email and password pair.

name	required	type	documentation
email	yes	String	The email of an Adama developer.
password	yes	String	The password for your account or a document
scopes	yes	String	The scopes of a social login. For example, * is all scopes which is applicable for a Adama controlled property while another scope is $space1/*,$space2/$key1

connection.AccountSocialLogin(email, password, scopes, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

wire method:probe

This is useful to validate an identity without executing anything.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

connection.Probe(identity, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

wire method:stats

Get stats for the current connection This method has no parameters.

connection.Stats({
  next: function(payload) {
    // payload.statKey
    // payload.statValue
    // payload.statType
  },
  complete: function() {
  },
  failure: function(reason) {
  }
});

name	type	documentation
stat-key	String	A key for the stats
stat-value	String	The value for a stat
stat-type	String	The type of the stat.

wire method:identity/hash

Validate an identity and convert to a public and opaque base64 crypto hash.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

connection.IdentityHash(identity, {
  success: function(response) {
    // response.identityHash
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity-hash	String	A hash of an identity

wire method:identity/stash

Stash an identity locally in the connection as if it was a cookie

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
name	yes	String	An identifier to name the resource.

connection.IdentityStash(identity, name, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

wire method:authority/create

Create an authority. See Authentication for more details.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

name	type	documentation
authority	String	An authority is collection of third party users authenticated via a public keystore.

wire method:authority/set

Set the public keystore for the authority.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
authority	yes	String	An authority is collection of users held together via a key store.
key-store	yes	ObjectNode	A collection of public keys used to validate an identity within an authority.

This method simply returns void.

wire method:authority/get

Get the public keystore for the authority.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
authority	yes	String	An authority is collection of users held together via a key store.

name	type	documentation
keystore	ObjectNode	A bunch of public keys to validate tokens for an authority.

wire method:authority/list

List authorities for the given developer.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

name	type	documentation
authority	String	An authority is collection of third party users authenticated via a public keystore.

wire method:authority/destroy

Destroy an authority.

This is exceptionally dangerous as it will break authentication for any users that have tokens based on that authority.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
authority	yes	String	An authority is collection of users held together via a key store.

This method simply returns void.

wire method:space/create

Create a space.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
template	no	String	When creating a space, the template is a known special identifier for how to bootstrap the defaults. Examples: none (default when template parameter not present).

connection.SpaceCreate(identity, space, template, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

wire method:space/generate-key

Generate a secret key for a space.

First party and third party services require secrets such as api tokens or credentials.

These credentials must be encrypted within the Adama document using a public-private key, and the secret is derived via a key exchange. Here, the server will generate a public/private key pair and store the private key securely and give the developer a public key. The developer then generates a public/private key, encrypts the token with the private key, throws away the private key, and then embeds the key id, the developer's public key, and the encrypted credential within the adama source code.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'

name	type	documentation
key-id	Integer	Unique id of the private-key used for a secret.
public-key	String	A public key to decrypt a secret with key arrangement.

wire method:space/get

Get the deployment plan for a space.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'

name	type	documentation
plan	ObjectNode	A plan is a predictable mapping of keys to implementations. The core reason for having multiple concurrent implementations is to have a smooth and orderly deployment. See deployment plans for more information.

wire method:space/set

Set the deployment plan for a space.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
plan	yes	ObjectNode	This 'plan' parameter contains multiple Adama scripts all gated on various rules. These rules allow for a migration to happen slowly on your schedule. Note: this value will validated such that the scripts are valid, compile, and will not have any major regressions during role out.

This method simply returns void.

wire method:space/redeploy-kick

A diagnostic call to optimistically to refresh a space's deployment

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'

This method simply returns void.

wire method:space/set-rxhtml

Set the RxHTML forest for the space when viewed via a domain name.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
rxhtml	yes	String	A RxHTML forest which provides simplified web hosting.

This method simply returns void.

wire method:space/get-rxhtml

Get the RxHTML forest for the space when viewed via a domain name.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'

name	type	documentation
rxhtml	String	The RxHTML forest for a space.

wire method:space/set-policy

Set the access control policy for a space

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
access-policy	yes	ObjectNode	A policy to control who can do what against a space.

This method simply returns void.

wire method:policy/generate-default

Generate a default policy template for inspection and use

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

name	type	documentation
access-policy	ObjectNode	A policy to control who can do what against a space.

wire method:space/get-policy

Returns the policy for a specific space

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'

name	type	documentation
access-policy	ObjectNode	A policy to control who can do what against a space.

wire method:space/metrics

For regional proxies to emit metrics for a document

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
prefix	no	String	A prefix of a key used to filter results in a listing or computation
metric-query	no	ObjectNode	A metric query to override the behavior on aggregation for specific fields

name	type	documentation
metrics	ObjectNode	A metrics object is a bunch of counters/event-tally
count	Integer	The number of items considered/available.

wire method:space/delete

Delete a space.

This requires no documents to be within the space, and this removes the space from use until garbage collection ensures no documents were created for that space after deletion. A space may be reserved for 90 minutes until the system is absolutely sure no documents will leak.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'

connection.SpaceDelete(identity, space, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

wire method:space/set-role

Set the role of an Adama developer for a particular space.

Spaces can be shared among Adama developers.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
email	yes	String	The email of an Adama developer.
role	yes	String	The role of a user may determine their capabilities to perform actions.

This method simply returns void.

wire method:space/list-developers

List the developers with access to this space

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'

name	type	documentation
email	String	A developer email
role	String	Each developer has a role to a document.

wire method:space/reflect

Get a schema for the space.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation

connection.SpaceReflect(identity, space, key, {
  success: function(response) {
    // response.reflection
  },
  failure: function(reason) {
  }
});

name	type	documentation
reflection	ObjectNode	Schema of a document.

wire method:space/list

List the spaces available to the user.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
marker	no	String	A key to skip ahead a listing. When iterating, values will be returned that are after marker. To paginate an entire list, pick the last key or name returned and use it as the next marker.
limit	no	Integer	Maximum number of items to return during a streaming list.

connection.SpaceList(identity, marker, limit, {
  next: function(payload) {
    // payload.space
    // payload.role
    // payload.created
    // payload.enabled
    // payload.storageBytes
  },
  complete: function() {
  },
  failure: function(reason) {
  }
});

name	type	documentation
space	String	A space which is a collection of documents with a common Adama schema.
role	String	Each developer has a role to a document.
created	String	When the item was created.
enabled	Boolean	Is the item in question enabled.
storage-bytes	Long	The storage used.

wire method:push/register

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.
subscription	yes	ObjectNode	A push subscription which is an abstract package for push notifications
device-info	yes	ObjectNode	Information about a device

connection.PushRegister(identity, domain, subscription, device-info, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

Method: DomainMap

wire method:domain/map

Map a domain to a space.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
certificate	no	String	A TLS/SSL Certificate encoded as json.

This method simply returns void.

Method: DomainClaimApex

wire method:domain/claim-apex

Claim an apex domain to be used only by your account

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.

name	type	documentation
claimed	Boolean	Has the apex domain been claimed and validated?
txt-token	String	The TXT field to introduce under the domain to prove ownership

Method: DomainRedirect

wire method:domain/redirect

Map a domain to another domain

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.
destination-domain	yes	String	A domain name to forward to

This method simply returns void.

Method: DomainConfigure

wire method:domain/configure

Configure a domain with internal guts that are considered secret.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.
product-config	yes	ObjectNode	Product config for various native app and integrated features.

This method simply returns void.

Method: DomainReflect (JS)

wire method:domain/reflect

Get a schema for the domain

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.

connection.DomainReflect(identity, domain, {
  success: function(response) {
    // response.reflection
  },
  failure: function(reason) {
  }
});

name	type	documentation
reflection	ObjectNode	Schema of a document.

Method: DomainMapDocument

wire method:domain/map-document

Map a domain to a space.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
route	no	Boolean	A domain can route to the space or to a document's handler
certificate	no	String	A TLS/SSL Certificate encoded as json.

This method simply returns void.

Method: DomainList

wire method:domain/list

List the domains for the given developer

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

name	type	documentation
domain	String	A domain name.
space	String	A space which is a collection of documents with a common Adama schema.
key	String	The key.
route	Boolean	Does the domain route GET to the document or the space.
forward	String	Does the domain have a forwarding address
configured	Boolean	Is the domain configured?
apex_managed	Boolean	Is the domain managed by an apex domain?

Method: DomainListBySpace

wire method:domain/list-by-space

List the domains for the given developer

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'

name	type	documentation
domain	String	A domain name.
space	String	A space which is a collection of documents with a common Adama schema.
key	String	The key.
route	Boolean	Does the domain route GET to the document or the space.
forward	String	Does the domain have a forwarding address
configured	Boolean	Is the domain configured?
apex_managed	Boolean	Is the domain managed by an apex domain?

Method: DomainGetVapidPublicKey (JS)

wire method:domain/get-vapid-public-key

Get the public key for the VAPID

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.

connection.DomainGetVapidPublicKey(identity, domain, {
  success: function(response) {
    // response.publicKey
  },
  failure: function(reason) {
  }
});

name	type	documentation
public-key	String	A public key to decrypt a secret with key arrangement.

Method: DomainUnmap

wire method:domain/unmap

Unmap a domain

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.

This method simply returns void.

Method: DomainGet

wire method:domain/get

Get the domain mapping

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.

name	type	documentation
space	String	A space which is a collection of documents with a common Adama schema.

wire method:document/download-archive

Download a complete archive

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation

name	type	documentation
base64-bytes	String	Bytes encoded in base64.
chunk-md5	String	MD5 of a chunk

wire method:document/list-backups

List snapshots for a document

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation

name	type	documentation
backup-id	String	The id of a backup (encoded)
date	String	The date of a backup
seq	Integer	The sequencer for the item.

wire method:document/force-backup

Force a backup to occur

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation

name	type	documentation
backup-id	String	The id of a backup (encoded)

wire method:document/download-backup

Download a specific snapshot

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
backup-id	yes	String	The reason a backup was made

name	type	documentation
base64-bytes	String	Bytes encoded in base64.
chunk-md5	String	MD5 of a chunk

wire method:document/list-push-tokens

List push tokens for a given agent within a document

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
domain	yes	String	A domain name.
agent	yes	String	Agent within a principal

name	type	documentation
id	Long	a long id
subscription-info	ObjectNode	Subscription information for a push subscriber.
device-info	ObjectNode	Device information for a push subscriber.

wire method:document/authorization

Send an authorization request to the document

name	required	type	documentation
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
message	yes	JsonNode	The object sent to a document which will be the parameter for a channel handler.

connection.DocumentAuthorization(space, key, message, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

Method: DocumentAuthorizationDomain (JS)

wire method:document/authorization-domain

Send an authorization request to a document via a domain

name	required	type	documentation
domain	yes	String	A domain name.
message	yes	JsonNode	The object sent to a document which will be the parameter for a channel handler.

connection.DocumentAuthorizationDomain(domain, message, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

wire method:document/authorize

Authorize a username and password against a document.

name	required	type	documentation
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
username	yes	String	The username for a document authorization
password	yes	String	The password for your account or a document

connection.DocumentAuthorize(space, key, username, password, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

Method: DocumentAuthorizeDomain (JS)

wire method:document/authorize-domain

Authorize a username and password against a document via a domain

name	required	type	documentation
domain	yes	String	A domain name.
username	yes	String	The username for a document authorization
password	yes	String	The password for your account or a document

connection.DocumentAuthorizeDomain(domain, username, password, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

wire method:document/authorize-with-reset

Authorize a username and password against a document, and set a new password

name	required	type	documentation
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
username	yes	String	The username for a document authorization
password	yes	String	The password for your account or a document
new_password	yes	String	The new password for your account or document

connection.DocumentAuthorizeWithReset(space, key, username, password, new_password, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

Method: DocumentAuthorizeDomainWithReset (JS)

wire method:document/authorize-domain-with-reset

Authorize a username and password against a document, and set a new password

name	required	type	documentation
domain	yes	String	A domain name.
username	yes	String	The username for a document authorization
password	yes	String	The password for your account or a document
new_password	yes	String	The new password for your account or document

connection.DocumentAuthorizeDomainWithReset(domain, username, password, new_password, {
  success: function(response) {
    // response.identity
  },
  failure: function(reason) {
  }
});

name	type	documentation
identity	String	A private token used to authenticate to Adama.

wire method:document/create

Create a document.

The entropy allows the randomization of the document to be fixed at construction time.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
entropy	no	String	Each document has a random number generator. When 'entropy' is present, it will seed the random number generate such that the randomness is now deterministic at the start.
arg	yes	ObjectNode	The parameter for a document's @construct event.

connection.DocumentCreate(identity, space, key, entropy, arg, {
  success: function() {
  },
  failure: function(reason) {
  }
});

This method simply returns void.

wire method:document/delete

Delete a document (invokes the @delete document policy).

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation

This method simply returns void.

wire method:document/list

List documents within a space which are after the given marker.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
marker	no	String	A key to skip ahead a listing. When iterating, values will be returned that are after marker. To paginate an entire list, pick the last key or name returned and use it as the next marker.
limit	no	Integer	Maximum number of items to return during a streaming list.

connection.DocumentList(identity, space, marker, limit, {
  next: function(payload) {
    // payload.key
    // payload.created
    // payload.updated
    // payload.seq
    // payload.lastBackup
  },
  complete: function() {
  },
  failure: function(reason) {
  }
});

name	type	documentation
key	String	The key.
created	String	When the item was created.
updated	String	When the item was last updated.
seq	Integer	The sequencer for the item.
last-backup	String	The time of the last internal backup.

Method: MessageDirectSend (JS)

wire method:message/direct-send

Send a message to a document without a connection

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
channel	yes	String	Each document has multiple channels available to send messages too.
message	yes	JsonNode	The object sent to a document which will be the parameter for a channel handler.

connection.MessageDirectSend(identity, space, key, channel, message, {
  success: function(response) {
    // response.seq
  },
  failure: function(reason) {
  }
});

name	type	documentation
seq	Integer	The sequencer for the item.

Method: MessageDirectSendOnce (JS)

wire method:message/direct-send-once

Send a message to a document without a connection

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
dedupe	no	String	A key used to dedupe request such that at-most once processing is used.
channel	yes	String	Each document has multiple channels available to send messages too.
message	yes	JsonNode	The object sent to a document which will be the parameter for a channel handler.

connection.MessageDirectSendOnce(identity, space, key, dedupe, channel, message, {
  success: function(response) {
    // response.seq
  },
  failure: function(reason) {
  }
});

name	type	documentation
seq	Integer	The sequencer for the item.

wire method:connection/create

Create a connection to a document.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
viewer-state	no	ObjectNode	A connection to a document has a side-channel for passing information about the client's view into the evaluation of bubbles. This allows for developers to implement real-time queries and pagination.

connection.ConnectionCreate(identity, space, key, viewer-state, {
  next: function(payload) {
    // payload.delta
  },
  complete: function() {
  },
  failure: function(reason) {
  }
});

name	type	documentation
delta	ObjectNode	A json delta representing a change of data. See the delta format for more information.

Method: ConnectionCreateViaDomain (JS)

wire method:connection/create-via-domain

Create a connection to a document via a domain name.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.
viewer-state	no	ObjectNode	A connection to a document has a side-channel for passing information about the client's view into the evaluation of bubbles. This allows for developers to implement real-time queries and pagination.

connection.ConnectionCreateViaDomain(identity, domain, viewer-state, {
  next: function(payload) {
    // payload.delta
  },
  complete: function() {
  },
  failure: function(reason) {
  }
});

name	type	documentation
delta	ObjectNode	A json delta representing a change of data. See the delta format for more information.

wire method:connection/send

Send a message to the document on the given channel.

name	required	type	documentation
channel	yes	String	Each document has multiple channels available to send messages too.
message	yes	JsonNode	The object sent to a document which will be the parameter for a channel handler.

name	type	documentation
seq	Integer	The sequencer for the item.

wire method:connection/password

Set the viewer's password to the document; requires their old password.

name	required	type	documentation
username	yes	String	The username for a document authorization
password	yes	String	The password for your account or a document
new_password	yes	String	The new password for your account or document

This method simply returns void.

wire method:connection/send-once

Send a message to the document on the given channel with a dedupe key such that sending happens at most once.

name	required	type	documentation
channel	yes	String	Each document has multiple channels available to send messages too.
dedupe	no	String	A key used to dedupe request such that at-most once processing is used.
message	yes	JsonNode	The object sent to a document which will be the parameter for a channel handler.

name	type	documentation
seq	Integer	The sequencer for the item.

wire method:connection/can-attach

Ask whether the connection can have attachments attached.

name	required	type	documentation

name	type	documentation
yes	Boolean	The result of a boolean question.

wire method:connection/attach

This is an internal API used only by Adama for multi-region support.

Start an upload for the given document with the given filename and content type.

name	required	type	documentation
asset-id	yes	String	The id of an asset.
filename	yes	String	A filename is a nice description of the asset being uploaded.
content-type	yes	String	The MIME type like text/json or video/mp4.
size	yes	Long	The size of an attachment.
digest-md5	yes	String	The MD5 of an attachment.
digest-sha384	yes	String	The SHA384 of an attachment.

name	type	documentation
seq	Integer	The sequencer for the item.

wire method:connection/update

Update the viewer state of the document.

The viewer state is accessible to bubbles to provide view restriction and filtering. For example, the viewer state is how a document can provide real-time search or pagination.

name	required	type	documentation
viewer-state	no	ObjectNode	A connection to a document has a side-channel for passing information about the client's view into the evaluation of bubbles. This allows for developers to implement real-time queries and pagination.

This method simply returns void.

wire method:connection/end

Disconnect from the document.

name	required	type	documentation

This method simply returns void.

wire method:documents/create-dedupe

Ask the server to create a dedupe token This method has no parameters.

connection.DocumentsCreateDedupe({
  success: function(response) {
    // response.dedupe
  },
  failure: function(reason) {
  }
});

name	type	documentation
dedupe	String	A UUID dedupe string

wire method:documents/hash-password

For documents that want to hold passwords, then these passwords should not be stored plaintext.

This method provides the client the ability to hash a password for plain text transmission.

name	required	type	documentation
password	yes	String	The password for your account or a document

connection.DocumentsHashPassword(password, {
  success: function(response) {
    // response.passwordHash
  },
  failure: function(reason) {
  }
});

name	type	documentation
password-hash	String	The hash of a password.

wire method:billing-connection/create

Create a connection to the billing document of the given identity.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.

connection.BillingConnectionCreate(identity, {
  next: function(payload) {
    // payload.delta
  },
  complete: function() {
  },
  failure: function(reason) {
  }
});

name	type	documentation
delta	ObjectNode	A json delta representing a change of data. See the delta format for more information.

wire method:feature/summarize-url

Summarize a URL by parsing it's meta-data.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
url	yes	String	A http(s) URL that resolves to a HTML page.

connection.FeatureSummarizeUrl(identity, url, {
  success: function(response) {
    // response.summary
  },
  failure: function(reason) {
  }
});

name	type	documentation
summary	ObjectNode	A json summary of a URL

wire method:replication/create

Replicate low level data

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation

name	type	documentation
reset	Boolean	Signal that the associated delta should reset the entire state of the replication.
change	ObjectNode	A json change behind a replica.

wire method:replication/end

Stop replicating data

name	required	type	documentation

This method simply returns void.

wire method:attachment/start

Start an upload for the given document with the given filename and content type.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
space	yes	String	A 'space' is a collection of documents with the same schema and logic, and the 'space' parameter is used to denote the name of that collection. Spaces are lower case ASCII using the regex a-z[a-z0-9-]* to validation with a minimum length of three characters. The space name must also not contain a '--'
key	yes	String	Within a space, documents are organized within a map and the 'key' parameter will uniquely identify documents. Keys are lower case ASCII using the regex [a-z0-9._-]* for validation
filename	yes	String	A filename is a nice description of the asset being uploaded.
content-type	yes	String	The MIME type like text/json or video/mp4.

connection.AttachmentStart(identity, space, key, filename, content-type, {
  next: function(payload) {
    // payload.chunk_request_size
  },
  complete: function() {
  },
  failure: function(reason) {
  }
});

name	type	documentation
chunk_request_size	Integer	The attachment uploader is asking for a chunk size. Using the WebSocket leverages a flow control based uploader such that contention on the WebSocket is minimized.

Method: AttachmentStartByDomain (JS)

wire method:attachment/start-by-domain

Start an upload for the given document with the given filename and content type.

name	required	type	documentation
identity	yes	String	Identity is a token to authenticate a user.
domain	yes	String	A domain name.
filename	yes	String	A filename is a nice description of the asset being uploaded.
content-type	yes	String	The MIME type like text/json or video/mp4.

connection.AttachmentStartByDomain(identity, domain, filename, content-type, {
  next: function(payload) {
    // payload.chunk_request_size
  },
  complete: function() {
  },
  failure: function(reason) {
  }
});

name	type	documentation
chunk_request_size	Integer	The attachment uploader is asking for a chunk size. Using the WebSocket leverages a flow control based uploader such that contention on the WebSocket is minimized.

wire method:attachment/append

Append a chunk with an MD5 to ensure data integrity.

name	required	type	documentation
chunk-md5	yes	String	A md5 hash of a chunk being uploaded. This provides uploads with end-to-end data-integrity.
base64-bytes	yes	String	Bytes encoded in base64.

This method simply returns void.

wire method:attachment/finish

Finishing uploading the attachment upload.

name	required	type	documentation

name	type	documentation
asset-id	String	The id of an uploaded asset.

Adama Platform

API Reference

Method: InitSetupAccount (JS)

Parameters

JavaScript SDK Template

Method: InitConvertGoogleUser (JS)

Parameters

JavaScript SDK Template

Request response fields

Method: InitCompleteAccount (JS)

Parameters

JavaScript SDK Template

Request response fields

Method: Deinit (JS)

Parameters

JavaScript SDK Template

Method: AccountSetPassword (JS)

Parameters

JavaScript SDK Template

Method: AccountGetPaymentPlan (JS)

Parameters

JavaScript SDK Template

Request response fields

Method: AccountLogin (JS)

Parameters

JavaScript SDK Template

Request response fields

Method: AccountSocialLogin (JS)

Parameters

JavaScript SDK Template

Request response fields

Method: Probe (JS)

Parameters

JavaScript SDK Template

Method: Stats (JS)

JavaScript SDK Template

Streaming payload fields

Method: IdentityHash (JS)

Parameters

JavaScript SDK Template

Request response fields

Method: IdentityStash (JS)

Parameters

JavaScript SDK Template

Method: AuthorityCreate

Parameters

Request response fields

Method: AuthoritySet

Parameters

Method: AuthorityGet

Parameters

Request response fields

Method: AuthorityList

Parameters

Streaming payload fields

Method: AuthorityDestroy

Parameters

Method: SpaceCreate (JS)

Parameters

JavaScript SDK Template

Method: SpaceGenerateKey

Parameters

Request response fields

Method: SpaceGet

Parameters

Request response fields

Method: SpaceSet

Parameters

Method: SpaceRedeployKick

Parameters

Method: SpaceSetRxhtml

Parameters

Method: SpaceGetRxhtml

Parameters

Request response fields

Method: SpaceSetPolicy

Parameters

Method: PolicyGenerateDefault

Parameters

Request response fields