Automate Etherpad
HumDay reads Etherpad’s own published API description and derives 96 operations from it. Describe the outcome you want in plain words — you get a program that is written, proven on real data, and run for you.
What Etherpad is
Etherpad is a real-time collaborative editor scalable to thousands of simultaneous real time users. It provides full data export capabilities, and runs on your server, under your control.
API host: etherpad.local
What HumDay can do in Etherpad
48 documented operations change something in Etherpad.
- POSTreturns the list of users that are currently editing this pad
/padUsers - POSTcreates a new (non-group) pad.
/createPad - POSTcreates a new group
/createGroup - POSTcreates a new author
/createAuthor - POSTcreates a new session.
/createSession - POSTcreates a new pad in this group
/createGroupPad - POSTsends a custom message of type msg to the pad
/sendClientsMessage - POSTreturns the chatHead (chat-message) of the pad
/getChatHead - POSTlist all the pads
/listAllPads - POSTreturns the number of user that are currently editing this pad
/padUsersCount - POSTappends a chat message
/appendChatMessage - POSTreturns the text of a pad formatted as HTML
/getHTML - POSTreturns the text of a pad
/getText - POSTsets the text of a pad with HTML
/setHTML - POSTsets the text of a pad
/setText - POSTreturns all pads of this group
/listPads - POSTdeletes a pad
/deletePad - POSTreturns ok when the current api token is valid
/checkToken - POSTdeletes a group
/deleteGroup - POSTdeletes a session
/deleteSession - POSTReturns the Author Name of the author
/getAuthorName - POSTreturns the timestamp of the last revision of the pad
/getLastEdited - POSTreturns the read only link of a pad
/getReadOnlyID - POSTreturns the chat history
/getChatHistory - POSTreturns informations about a session
/getSessionInfo - POSTreturn true of false
/getPublicStatus - POSTsets a boolean for the public status of a pad
/setPublicStatus - POSTreturns an array of authors who contributed to this pad
/listAuthorsOfPad - POSTreturns an array of all pads this author contributed to
/listPadsOfAuthor - POSTreturns the number of revisions of this pad
/getRevisionsCount - POSTreturns all sessions of an author
/listSessionsOfAuthor - POSTthis functions helps you to map your application group ids to Etherpad group ids
/createGroupIfNotExistsFor - POSTthis functions helps you to map your application author ids to Etherpad author ids
/createAuthorIfNotExistsFor - POSTUpdate copyPad
/copyPad - POSTUpdate movePad
/movePad - POSTUpdate getPadID
/getPadID - POSTUpdate getStats
/getStats - POSTUpdate appendText
/appendText - POSTUpdate saveRevision
/saveRevision - POSTUpdate listAllGroups
/listAllGroups - POSTUpdate createDiffHTML
/createDiffHTML - POSTUpdate restoreRevision
/restoreRevision - POSTUpdate getAttributePool
/getAttributePool - POSTUpdate listSavedRevisions
/listSavedRevisions - POSTUpdate listSessionsOfGroup
/listSessionsOfGroup - POSTUpdate getRevisionChangeset
/getRevisionChangeset - POSTUpdate copyPadWithoutHistory
/copyPadWithoutHistory - POSTUpdate getSavedRevisionsCount
/getSavedRevisionsCount
What HumDay can read from Etherpad
These are the operations a schedule or a trigger can watch.
- GETreturns the list of users that are currently editing this pad
/padUsers - GETcreates a new (non-group) pad.
/createPad - GETcreates a new group
/createGroup - GETcreates a new author
/createAuthor - GETcreates a new session.
/createSession - GETcreates a new pad in this group
/createGroupPad - GETsends a custom message of type msg to the pad
/sendClientsMessage - GETreturns the chatHead (chat-message) of the pad
/getChatHead - GETlist all the pads
/listAllPads - GETreturns the number of user that are currently editing this pad
/padUsersCount - GETappends a chat message
/appendChatMessage - GETreturns the text of a pad formatted as HTML
/getHTML - GETreturns the text of a pad
/getText - GETsets the text of a pad with HTML
/setHTML - GETsets the text of a pad
/setText - GETreturns all pads of this group
/listPads - GETdeletes a pad
/deletePad - GETreturns ok when the current api token is valid
/checkToken - GETdeletes a group
/deleteGroup - GETdeletes a session
/deleteSession - GETReturns the Author Name of the author
/getAuthorName - GETreturns the timestamp of the last revision of the pad
/getLastEdited - GETreturns the read only link of a pad
/getReadOnlyID - GETreturns the chat history
/getChatHistory - GETreturns informations about a session
/getSessionInfo - GETreturn true of false
/getPublicStatus - GETsets a boolean for the public status of a pad
/setPublicStatus - GETreturns an array of authors who contributed to this pad
/listAuthorsOfPad - GETreturns an array of all pads this author contributed to
/listPadsOfAuthor - GETreturns the number of revisions of this pad
/getRevisionsCount - GETreturns all sessions of an author
/listSessionsOfAuthor - GETthis functions helps you to map your application group ids to Etherpad group ids
/createGroupIfNotExistsFor - GETthis functions helps you to map your application author ids to Etherpad author ids
/createAuthorIfNotExistsFor - GETRead copyPad
/copyPad - GETRead movePad
/movePad - GETRead getPadID
/getPadID - GETRead getStats
/getStats - GETRead appendText
/appendText - GETRead saveRevision
/saveRevision - GETRead listAllGroups
/listAllGroups - GETRead createDiffHTML
/createDiffHTML - GETRead restoreRevision
/restoreRevision - GETRead getAttributePool
/getAttributePool - GETRead listSavedRevisions
/listSavedRevisions - GETRead listSessionsOfGroup
/listSessionsOfGroup - GETRead getRevisionChangeset
/getRevisionChangeset - GETRead copyPadWithoutHistory
/copyPadWithoutHistory - GETRead getSavedRevisionsCount
/getSavedRevisionsCount
How automating Etherpad works
- Describe the outcome. Say what you want to happen, in your own words. No node graphs, no field mapping.
- Approve the contract. HumDay writes down exactly what it will do, what it will touch, and what it will never do. You approve it before anything is built.
- See it proven. The program runs and shows you the result before it is allowed near your live Etherpad account.
- Grant access, then go live. You approve the specific Etherpad operations it may use — and only those.
Automate Etherpad with these
- OData for namespace microsoft.graph11412 operations
- GitHub811 operations
- Atlassian The Jira Cloud platform474 operations
- Gitlab358 operations
- JIRA 7.6.1324 operations
- Appcenter App Center Client323 operations
- Gitea .321 operations
- Bitbucket292 operations
- Keycloak Admin281 operations
- Apple App Store Connect251 operations
- Files.com222 operations
- Vmware vRealize Network Insight Reference161 operations
Categories
Questions about Etherpad automation
- Can HumDay connect to Etherpad?
- Yes. HumDay reads Etherpad's own published API description and derives the operations from it, so there is no hand-built connector to wait for. 96 operations are documented.
- Do I need to write code to automate Etherpad?
- No. You describe the outcome you want in plain words. HumDay agrees a contract with you, writes the program, and shows you a test run before anything touches your Etherpad account.
- What can HumDay do in Etherpad?
- 48 of the 96 documented operations change something in Etherpad, and 48 read from it. HumDay only ever uses the specific operations your approved contract needs.
- Is my Etherpad account safe?
- Your credentials are stored encrypted and are never shown in chat, code, or logs. Every run is limited to the operations you explicitly approved, and anything that writes to Etherpad is held behind that approval.
Where this came from
The operations above are read from a published API description for Etherpad at pads.mro.name/api/openapi.json. Descriptions are the provider’s own words, not ours. Last published 2021-01-07.