Overview
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.
Etherpad API is a development API from etherpad.local. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 96 endpoints.
At a glance
- Authentication
- API key
- HTTPS
- Yes
- CORS
- Unknown
- Category
- Development
- Base URL
http://etherpad.local- Version
- 1.2.15
- Endpoints
- 96
- OpenAPI
- Specification ↗
- Spec updated
- 2021-01-07
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "http://etherpad.local/appendChatMessage" \
-H "Accept: application/json" \
-H "X-API-Key: YOUR_API_KEY"const response = await fetch("http://etherpad.local/appendChatMessage", {
method: "GET",
headers: {
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY",
},
});
const data = await response.json();
console.log(data);import requests
response = requests.request(
"GET",
"http://etherpad.local/appendChatMessage",
headers={
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY",
},
timeout=30,
)
print(response.json())Endpoints
| Method | Path | What it does |
|---|---|---|
| GET | /appendChatMessage | appends a chat message |
| POST | /appendChatMessage | appends a chat message |
| GET | /appendText | appendTextUsingGET |
| POST | /appendText | appendTextUsingPOST |
| GET | /checkToken | returns ok when the current api token is valid |
| POST | /checkToken | returns ok when the current api token is valid |
| GET | /copyPad | copyPadUsingGET |
| POST | /copyPad | copyPadUsingPOST |
| GET | /copyPadWithoutHistory | copyPadWithoutHistoryUsingGET |
| POST | /copyPadWithoutHistory | copyPadWithoutHistoryUsingPOST |
| GET | /createAuthor | creates a new author |
| POST | /createAuthor | creates a new author |
| GET | /createAuthorIfNotExistsFor | this functions helps you to map your application author ids to Etherpad author ids |
| POST | /createAuthorIfNotExistsFor | this functions helps you to map your application author ids to Etherpad author ids |
| GET | /createDiffHTML | createDiffHTMLUsingGET |
| POST | /createDiffHTML | createDiffHTMLUsingPOST |
| GET | /createGroup | creates a new group |
| POST | /createGroup | creates a new group |
| GET | /createGroupIfNotExistsFor | this functions helps you to map your application group ids to Etherpad group ids |
| POST | /createGroupIfNotExistsFor | this functions helps you to map your application group ids to Etherpad group ids |
| GET | /createGroupPad | creates a new pad in this group |
| POST | /createGroupPad | creates a new pad in this group |
| GET | /createPad | creates a new (non-group) pad. Note that if you need to create a group Pad, you should call createGroupPad |
| POST | /createPad | creates a new (non-group) pad. Note that if you need to create a group Pad, you should call createGroupPad |
| GET | /createSession | creates a new session. validUntil is an unix timestamp in seconds |
| POST | /createSession | creates a new session. validUntil is an unix timestamp in seconds |
| GET | /deleteGroup | deletes a group |
| POST | /deleteGroup | deletes a group |
| GET | /deletePad | deletes a pad |
| POST | /deletePad | deletes a pad |
| GET | /deleteSession | deletes a session |
| POST | /deleteSession | deletes a session |
| GET | /getAttributePool | getAttributePoolUsingGET |
| POST | /getAttributePool | getAttributePoolUsingPOST |
| GET | /getAuthorName | Returns the Author Name of the author |
| POST | /getAuthorName | Returns the Author Name of the author |
| GET | /getChatHead | returns the chatHead (chat-message) of the pad |
| POST | /getChatHead | returns the chatHead (chat-message) of the pad |
| GET | /getChatHistory | returns the chat history |
| POST | /getChatHistory | returns the chat history |
| GET | /getHTML | returns the text of a pad formatted as HTML |
| POST | /getHTML | returns the text of a pad formatted as HTML |
| GET | /getLastEdited | returns the timestamp of the last revision of the pad |
| POST | /getLastEdited | returns the timestamp of the last revision of the pad |
| GET | /getPadID | getPadIDUsingGET |
| POST | /getPadID | getPadIDUsingPOST |
| GET | /getPublicStatus | return true of false |
| POST | /getPublicStatus | return true of false |
| GET | /getReadOnlyID | returns the read only link of a pad |
| POST | /getReadOnlyID | returns the read only link of a pad |
| GET | /getRevisionChangeset | getRevisionChangesetUsingGET |
| POST | /getRevisionChangeset | getRevisionChangesetUsingPOST |
| GET | /getRevisionsCount | returns the number of revisions of this pad |
| POST | /getRevisionsCount | returns the number of revisions of this pad |
| GET | /getSavedRevisionsCount | getSavedRevisionsCountUsingGET |
| POST | /getSavedRevisionsCount | getSavedRevisionsCountUsingPOST |
| GET | /getSessionInfo | returns informations about a session |
| POST | /getSessionInfo | returns informations about a session |
| GET | /getStats | getStatsUsingGET |
| POST | /getStats | getStatsUsingPOST |
| GET | /getText | returns the text of a pad |
| POST | /getText | returns the text of a pad |
| GET | /listAllGroups | listAllGroupsUsingGET |
| POST | /listAllGroups | listAllGroupsUsingPOST |
| GET | /listAllPads | list all the pads |
| POST | /listAllPads | list all the pads |
| GET | /listAuthorsOfPad | returns an array of authors who contributed to this pad |
| POST | /listAuthorsOfPad | returns an array of authors who contributed to this pad |
| GET | /listPads | returns all pads of this group |
| POST | /listPads | returns all pads of this group |
| GET | /listPadsOfAuthor | returns an array of all pads this author contributed to |
| POST | /listPadsOfAuthor | returns an array of all pads this author contributed to |
| GET | /listSavedRevisions | listSavedRevisionsUsingGET |
| POST | /listSavedRevisions | listSavedRevisionsUsingPOST |
| GET | /listSessionsOfAuthor | returns all sessions of an author |
| POST | /listSessionsOfAuthor | returns all sessions of an author |
| GET | /listSessionsOfGroup | listSessionsOfGroupUsingGET |
| POST | /listSessionsOfGroup | listSessionsOfGroupUsingPOST |
| GET | /movePad | movePadUsingGET |
| POST | /movePad | movePadUsingPOST |
| GET | /padUsers | returns the list of users that are currently editing this pad |
| POST | /padUsers | returns the list of users that are currently editing this pad |
| GET | /padUsersCount | returns the number of user that are currently editing this pad |
| POST | /padUsersCount | returns the number of user that are currently editing this pad |
| GET | /restoreRevision | restoreRevisionUsingGET |
| POST | /restoreRevision | restoreRevisionUsingPOST |
| GET | /saveRevision | saveRevisionUsingGET |
| POST | /saveRevision | saveRevisionUsingPOST |
| GET | /sendClientsMessage | sends a custom message of type msg to the pad |
| POST | /sendClientsMessage | sends a custom message of type msg to the pad |
| GET | /setHTML | sets the text of a pad with HTML |
| POST | /setHTML | sets the text of a pad with HTML |
| GET | /setPublicStatus | sets a boolean for the public status of a pad |
| POST | /setPublicStatus | sets a boolean for the public status of a pad |
| GET | /setText | sets the text of a pad |
| POST | /setText | sets the text of a pad |
Questions
Does the Etherpad API API need an API key?
Yes. The Etherpad API API uses API key authentication; the documentation explains how to get credentials.
Does the Etherpad API API support HTTPS?
Yes, the Etherpad API API is served over HTTPS.
How many endpoints does the Etherpad API API have?
Its OpenAPI description lists 96 endpoints in version 1.2.15. All of them are shown on this page.
What are alternatives to the Etherpad API API?
Other Development APIs include Cloudflare, Azure DevOps, IPify, App Store Connect API, StackExchange.
Similar development APIs
Compare alternatives →Cloudflare
DevelopmentManage DNS, CDN, Workers and other services; documented with an official OpenAPI 3.0 spec
Azure DevOps
DevelopmentThe Azure DevOps basic components of a REST API request/response pair
IPify
DevelopmentA simple IP Address API
App Store Connect API
DevelopmentThe data structure that represents an app store connect api resource.
StackExchange
DevelopmentQ&A forum for developers
IPinfo
DevelopmentAnother simple IP Address API
Listed from APIs.guru (CC0).