Skip to content

Etherpad API API

by etherpad.local

API keyHTTPSDevelopment
Open documentation ↗

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
Spec updated
2021-01-07

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "http://etherpad.local/appendChatMessage" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
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);
Python
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

MethodPathWhat it does
GET/appendChatMessageappends a chat message
POST/appendChatMessageappends a chat message
GET/appendTextappendTextUsingGET
POST/appendTextappendTextUsingPOST
GET/checkTokenreturns ok when the current api token is valid
POST/checkTokenreturns ok when the current api token is valid
GET/copyPadcopyPadUsingGET
POST/copyPadcopyPadUsingPOST
GET/copyPadWithoutHistorycopyPadWithoutHistoryUsingGET
POST/copyPadWithoutHistorycopyPadWithoutHistoryUsingPOST
GET/createAuthorcreates a new author
POST/createAuthorcreates a new author
GET/createAuthorIfNotExistsForthis functions helps you to map your application author ids to Etherpad author ids
POST/createAuthorIfNotExistsForthis functions helps you to map your application author ids to Etherpad author ids
GET/createDiffHTMLcreateDiffHTMLUsingGET
POST/createDiffHTMLcreateDiffHTMLUsingPOST
GET/createGroupcreates a new group
POST/createGroupcreates a new group
GET/createGroupIfNotExistsForthis functions helps you to map your application group ids to Etherpad group ids
POST/createGroupIfNotExistsForthis functions helps you to map your application group ids to Etherpad group ids
GET/createGroupPadcreates a new pad in this group
POST/createGroupPadcreates a new pad in this group
GET/createPadcreates a new (non-group) pad. Note that if you need to create a group Pad, you should call createGroupPad
POST/createPadcreates a new (non-group) pad. Note that if you need to create a group Pad, you should call createGroupPad
GET/createSessioncreates a new session. validUntil is an unix timestamp in seconds
POST/createSessioncreates a new session. validUntil is an unix timestamp in seconds
GET/deleteGroupdeletes a group
POST/deleteGroupdeletes a group
GET/deletePaddeletes a pad
POST/deletePaddeletes a pad
GET/deleteSessiondeletes a session
POST/deleteSessiondeletes a session
GET/getAttributePoolgetAttributePoolUsingGET
POST/getAttributePoolgetAttributePoolUsingPOST
GET/getAuthorNameReturns the Author Name of the author
POST/getAuthorNameReturns the Author Name of the author
GET/getChatHeadreturns the chatHead (chat-message) of the pad
POST/getChatHeadreturns the chatHead (chat-message) of the pad
GET/getChatHistoryreturns the chat history
POST/getChatHistoryreturns the chat history
GET/getHTMLreturns the text of a pad formatted as HTML
POST/getHTMLreturns the text of a pad formatted as HTML
GET/getLastEditedreturns the timestamp of the last revision of the pad
POST/getLastEditedreturns the timestamp of the last revision of the pad
GET/getPadIDgetPadIDUsingGET
POST/getPadIDgetPadIDUsingPOST
GET/getPublicStatusreturn true of false
POST/getPublicStatusreturn true of false
GET/getReadOnlyIDreturns the read only link of a pad
POST/getReadOnlyIDreturns the read only link of a pad
GET/getRevisionChangesetgetRevisionChangesetUsingGET
POST/getRevisionChangesetgetRevisionChangesetUsingPOST
GET/getRevisionsCountreturns the number of revisions of this pad
POST/getRevisionsCountreturns the number of revisions of this pad
GET/getSavedRevisionsCountgetSavedRevisionsCountUsingGET
POST/getSavedRevisionsCountgetSavedRevisionsCountUsingPOST
GET/getSessionInforeturns informations about a session
POST/getSessionInforeturns informations about a session
GET/getStatsgetStatsUsingGET
POST/getStatsgetStatsUsingPOST
GET/getTextreturns the text of a pad
POST/getTextreturns the text of a pad
GET/listAllGroupslistAllGroupsUsingGET
POST/listAllGroupslistAllGroupsUsingPOST
GET/listAllPadslist all the pads
POST/listAllPadslist all the pads
GET/listAuthorsOfPadreturns an array of authors who contributed to this pad
POST/listAuthorsOfPadreturns an array of authors who contributed to this pad
GET/listPadsreturns all pads of this group
POST/listPadsreturns all pads of this group
GET/listPadsOfAuthorreturns an array of all pads this author contributed to
POST/listPadsOfAuthorreturns an array of all pads this author contributed to
GET/listSavedRevisionslistSavedRevisionsUsingGET
POST/listSavedRevisionslistSavedRevisionsUsingPOST
GET/listSessionsOfAuthorreturns all sessions of an author
POST/listSessionsOfAuthorreturns all sessions of an author
GET/listSessionsOfGrouplistSessionsOfGroupUsingGET
POST/listSessionsOfGrouplistSessionsOfGroupUsingPOST
GET/movePadmovePadUsingGET
POST/movePadmovePadUsingPOST
GET/padUsersreturns the list of users that are currently editing this pad
POST/padUsersreturns the list of users that are currently editing this pad
GET/padUsersCountreturns the number of user that are currently editing this pad
POST/padUsersCountreturns the number of user that are currently editing this pad
GET/restoreRevisionrestoreRevisionUsingGET
POST/restoreRevisionrestoreRevisionUsingPOST
GET/saveRevisionsaveRevisionUsingGET
POST/saveRevisionsaveRevisionUsingPOST
GET/sendClientsMessagesends a custom message of type msg to the pad
POST/sendClientsMessagesends a custom message of type msg to the pad
GET/setHTMLsets the text of a pad with HTML
POST/setHTMLsets the text of a pad with HTML
GET/setPublicStatussets a boolean for the public status of a pad
POST/setPublicStatussets a boolean for the public status of a pad
GET/setTextsets the text of a pad
POST/setTextsets 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.

Compare alternatives →

Listed from APIs.guru (CC0).