Add a Connection. Requires login.

• string fromnodeid
• string fromroleid
• string linktypeid
• string tonodeid
• string toroleid
• string private optional, can be Y or N, defaults to users preferred setting

• return: Connection or Error

Add a new group. Requires login.

• string groupname

• return: Group or Error

Add a group to a Connection. Requires login, user must be the connection owner and member of the group.

• string connid
• string groupid

• return: Connection or Error

Add a group to a node. Requires login, user must be the node owner and member of the group.

• string nodeid
• string groupid

• return: Node or Error

Add a linktype (will return the existing one if it's already in the db).

Requires login.

• string label
• string linktypegroup

• return: LinkType or Error

Adds nodes. Requires login.

Purpose of this function is to allow the importing of another users nodes into the users workspace, and more than one at a time can be added

• string nodeids

• return: Result or Error

Add new tag - if the tag already exists then this existing tag object will be returned. Login required.

• string tagname

• return: Role or Error

Add the given tag labels to the given node ids

• $tags tags the comma separated list of tags to add
• $nodeids nodeids the comma separated list of node id to add tags to

Add to the log

• string action
• string type
• string id

• return: Result or Error

Add a URL. Requires login

• string url
• string title
• string desc
• string private optional, can be Y or N, defaults to users preferred setting
• string clip (optional);
• string clippath (optional) - only used by Firefox plugin
• string cliphtml (optional) - only used by Firefox plugin

• return: URL or Error

Go and try and automatically retrieve the title and descritpion for the given url.

• string url

• return: URL or Error

Copy a Connection. Requires login

• string connid

• return: Connection or Error

Deletes a set of connections. Requires login and user must be owner of each connection.

• string connids (comma separated list of connids)

• return: Result or Error

Delete item from users cache (bookmarks). Login required.

• string idea the id of the idea to delete

• return: UserCache or Error

Delete a linktype. Requires login and user must be owner of the linktype

• string linktypeid

• return: Result or Error

Deletes a set of nodes. Requires login and user must be owner of each node.

• string nodeids (comma separated list of nodeids)

• return: Result or Error

Delete the search with the given id

• string searchid

• return: Result or Error

Delete a tag. Requires login and user must be owner of the tag.

• string tagid

• return: Result or Error

Edit a Connection. Requires login and user must be owner of the connection

• string connid
• string fromnodeid
• string fromroleid
• string linktypeid
• string tonodeid
• string toroleid
• string private optional, can be Y or N, defaults to users preferred setting

• return: Connection or Error

Edit a node. Requires login and user must be owner of the node.

• string private optional, can be Y or N, defaults to users preferred setting
• string nodetypeid optional, the id of the nodetype this node is, defaults to 'Idea' node type id.
• string imageurlid optional, the urlid of the url for the image that is being used as this node's icon
• string imagethumbnail optional, the local server path to the thumbnail of the image used for this node
• string nodeid nodeid
• string name name
• string desc desc

• return: Node or Error

Edit a tag. If that tag name already exists for this user, return an error.

Requires login and user must be owner of the tag

• string tagid
• string tagname

• return: Tag or Error

Change whether or not the feed is regularly updated. Requires login and user must be owner of the feed.

• string feedid
• string regular

• return: Feed or Error

Get the users with the most ideas (excludes groups)

• integer start (optional - default: 0)
• integer max (optional - default: 20)
• String style (optional - default 'long') may be 'short' or 'long' - how much of a users details to load (long includes: tags and groups).

• return: UserSet or Error

Get all roles

• return: RoleSet or Error

Get the urls with clips for given url (note that this uses the actual URL rather than the urlid)

• string url
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a urls details to load (long includes: tags, groups).

• return: URLSet or Error

Get nodes which are connected to other nodes

• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'nodeid', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get the connections whose from idea labels are the same as the label of the node with the given node id

• string nodeid
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• string filtergroup (optional, either 'all','selected','positive','negative' or 'neutral', default: 'all' - to filter the results by the link type group of the connection)
• string filterlist (optional, comma separated strings of the connection labels to filter the results by, to have any effect filtergroup must be set to 'selected')
• String style (optional - default 'long') may be 'short' or 'long'

• return: ConnectionSet or Error

Get the connections by link type

• string linktypelabel = linktype label to search on - exact full label matching
• string scope (either 'all' or 'my')
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long'

• return: ConnectionSet or Error

Get the connections for the given netowrk search paramters from the given node.

• string nodeid the id of the node to search outward from.
• string linklabels the string of link types.
• string userid optional for searching only a specified user's data. (only used if scope is 'all') - NOT USED AT PRESENT
• string scope (either 'all' or 'my')
• string linkgroup (optional, either Positive, Negative, or Neutral - default: empty string);
• integer depth (optional, 1-7, or 7 for full depth;
• string direction (optional, 'outgoing', 'incmong', or 'both - default: 'both',
• string labelmatch (optional, 'true', 'false' - default: false;
• String style (optional - default 'long') may be 'short' or 'long'

• return: ConnectionSet or Error

Search connections by thier tags splits on commas and searches OR on elements

• string q
• string scope (either 'all' or 'my')
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• string filtergroup (optional, either 'all','selected','positive','negative' or 'neutral', default: 'all' - to filter the results by the link type group of the connection)
• string filterlist (optional, comma separated strings of the connection labels to filter the results by, to have any effect filtergroup must be set to 'selected')
• String style (optional - default 'long') may be 'short' or 'long'

• return: ConnectionSet or Error

Get the connections for given url

• string url
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• string filtergroup (optional, either 'all','selected','positive','negative' or 'neutral', default: 'all' - to filter the results by the link type group of the connection)
• string filterlist (optional, comma separated strings of the connection labels to filter the results by, to have any effect filtergroup must be set to 'selected')
• String style (optional - default 'long') may be 'short' or 'long'

• return: ConnectionSet or Error

Gets all feeds for user. If userid not specified then the current user is assumed.

• string userid

• return: Feed or Error

Get a linktype

• string ltid

• return: LinkType or Error

Get nodes which are most connected to other nodes

• string scope (optional, either 'all' or 'my' - default 'all' )
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get groups that current user is an admin for. Requires login.

• return: GroupSet or Error

Get a node

• string nodeid
• string style (optional - default 'long') may be 'short' or 'long'

• return: Node or Error

Searches nodes by node name based on the first chartacters

• string q the query term(s)
• string scope (optional, either 'all' or 'my' - default: 'my')
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'nodeid', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get the nodes for given name

• string name
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'nodeid', 'name', 'connectedness' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Search nodes.

If in speech marks searches LIKE match on phrase, else splits on spaces and searches OR on elements

• string q the query term(s)
• string scope (optional, either 'my' or 'all' - default: 'all')
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'nodeid', 'name', 'connectedness' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get the nodes for given tagname

• string tagname
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'nodeid', 'name', 'connectedness' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get the nodes for given url (note that this uses the actual URL rather than the urlid)

• string url
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'nodeid', 'name', 'connectedness' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get the nodes for given user

• string userid
• integer start (optional - default: 0)
• integer max (optional - default: 20), -1 means all
• string orderby (optional, either 'date', 'nodeid', 'name', 'connectedness' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get the recent connections

• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long'

• return: ConnectionSet or Error

Get the recent visitors (excludes groups)

• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a users details to load (long includes: tags and groups).

• return: UserSet or Error

Get a role (by name)

• string rolename

• return: Role or Error

Get a tag (by id)

• string tagid

• return: Tag or Error

Searches tags by node name based on the first chartacters

• string q the query term(s)
• string scope (optional, either 'all' or 'my' - default: 'my')

• return: TagSet or Error

Get nodes not connected to other nodes

• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'nodeid', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get the urls for given group

• string groupid
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• string filterusers (optional, a list of user ids to filter by)
• String style (optional - default 'long') may be 'short' or 'long' - how much of a urls details to load (long includes: tags, groups).

• return: URLSet or Error

Search urls If in speech marks searches LIKE match on phrase, else splits on spaces and searches OR on elements

• string q the query term(s)
• string scope (either 'all' or 'my')
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a urls details to load (long includes: tags, groups).

• return: URLSet or Error

Get the urls for given url (note that this uses the actual URL rather than the urlid)

• string url
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a urls details to load (long includes: tags, groups).

• return: URLSet or Error

Get a user

• string userid
• string format (optional - default 'long') may be 'short' or 'long'

• return: User or Error

Searches user cache nodes (bookmarks). Login required.

• string q the query term(s)
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'nodeid', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a nodes details to load (long includes: description, tags, groups and urls).

• return: NodeSet or Error

Get the current user's roles. Login required.

• return: RoleSet or Error

Get the users for nodes with the node label of the given nodeid

• string nodeid
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a user's details to load (long includes: tags and groups).

• return: UserSet or Error

Search users by their tags and by the nodes they have tagged splits on commas and searches OR on elements

• string q the query term(s)
• string scope (must be 'all' or 'my')
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a user's details to load (long includes: tags, groups).

• return: NodeSet or Error

Get the users for given user (bascially means any groups they are in)

• string userid
• integer start (optional - default: 0)
• integer max (optional - default: 20)
• string orderby (optional, either 'date', 'name' or 'moddate' - default: 'date')
• string sort (optional, either 'ASC' or 'DESC' - default: 'DESC')
• String style (optional - default 'long') may be 'short' or 'long' - how much of a user's details to load (long includes: tags and groups).

• return: UserSet or Error

Get the current user's tags. Login required.

• return: TagSet or Error

Run the agent associated with this network search

• string searchid the id of the search whose agent to run
• string runid the run id of the run to load.

• return: ConnectionSet or Error

Make a user an admin of the group. Requires login and user must be an admin for the group.

• string groupid
• string userid

• return: Group or Error

Remove all groups from a Connection. Requires login, user must be the connection owner.

• string connid

• return: Result or Error

Remove all URLs from a node. Requires login, user must be owner of the node

• string nodeid

• return: Result or Error

Remove a group from a Connection. Requires login, user must be the connection owner and member of the group.

• string connid
• string groupid

• return: Result or Error

Remove a group from a node. Requires login, user must be the node owner and member of the group.

• string nodeid
• string groupid

• return: Node or Error

Remove a user from a group. Requires login and user must be an admin for the group.

• string groupid
• string userid

• return: Group or Error

Run the agent associated with this network search

• string searchid the id of the search whose agent to run
• String type type, who requested this run, the user themselves through an interface button push or an automated process like a nightly cron: values = 'user' or 'auto'; default = 'user';

• return: Result or Error

Tweet the idea with the given nodeid to the current user's twitter accounts, if setup.

• $nodeid nodeid the id of the idea to tweet.

update a node location. Requires login and user must be owner of the node.

• string location optional
• string loccountry optional
• string nodeid nodeid

• return: Node or Error

Check that the session is active and valid for the user passed.

• string userid

• return: User or Error