Skip to content

Commit 2af335c

Browse files
author
github-actions
committed
Update REST API documentation Sun Mar 2 16:37:16 UTC 2025
1 parent 9383bbb commit 2af335c

File tree

1 file changed

+110
-18
lines changed

1 file changed

+110
-18
lines changed

docs/restapi.json

+110-18
Original file line numberDiff line numberDiff line change
@@ -255,14 +255,14 @@
255255
}
256256
}
257257
},
258-
"/lists/{list}/members": {
258+
"/lists/{id}/subscribers": {
259259
"get": {
260260
"tags": [
261261
"lists"
262262
],
263-
"summary": "Gets a list of all subscribers (members) of a subscriber list.",
263+
"summary": "Gets a list of all subscribers of a subscriber list.",
264264
"description": "Returns a JSON list of all subscribers for a subscriber list.",
265-
"operationId": "29f6848c27ee3e30b7e4bd7997c73a18",
265+
"operationId": "4758420770106043c526018727384dc0",
266266
"parameters": [
267267
{
268268
"name": "session",
@@ -274,7 +274,7 @@
274274
}
275275
},
276276
{
277-
"name": "list",
277+
"name": "id",
278278
"in": "path",
279279
"description": "List ID",
280280
"required": true,
@@ -355,14 +355,14 @@
355355
}
356356
}
357357
},
358-
"/lists/{list}/count": {
358+
"/lists/{id}/count": {
359359
"get": {
360360
"tags": [
361361
"lists"
362362
],
363363
"summary": "Gets the total number of subscribers of a list",
364364
"description": "Returns a count of all subscribers in a given list.",
365-
"operationId": "c1e2f17c0078014a816c914a25d8e889",
365+
"operationId": "55d76d7f22b445a9d9dd7ba38a3156cf",
366366
"parameters": [
367367
{
368368
"name": "session",
@@ -374,7 +374,7 @@
374374
}
375375
},
376376
{
377-
"name": "list",
377+
"name": "id",
378378
"in": "path",
379379
"description": "List ID",
380380
"required": true,
@@ -559,14 +559,14 @@
559559
}
560560
}
561561
},
562-
"/subscriber": {
562+
"/subscribers": {
563563
"post": {
564564
"tags": [
565565
"subscribers"
566566
],
567567
"summary": "Create a subscriber",
568568
"description": "Creates a new subscriber (if there is no subscriber with the given email address yet).",
569-
"operationId": "9dc1ae0a66e2eed292c4aed09bab8de0",
569+
"operationId": "e99d8d230dcb6ef5004ca48d716cd66b",
570570
"parameters": [
571571
{
572572
"name": "session",
@@ -593,21 +593,13 @@
593593
"format": "string",
594594
"example": "admin@example.com"
595595
},
596-
"confirmed": {
597-
"type": "boolean",
598-
"example": false
599-
},
600-
"blacklisted": {
596+
"request_confirmation": {
601597
"type": "boolean",
602598
"example": false
603599
},
604600
"html_email": {
605601
"type": "boolean",
606602
"example": false
607-
},
608-
"disabled": {
609-
"type": "boolean",
610-
"example": false
611603
}
612604
},
613605
"type": "object"
@@ -715,6 +707,106 @@
715707
}
716708
}
717709
}
710+
},
711+
"/subscribers/{subscriber}": {
712+
"get": {
713+
"tags": [
714+
"subscribers"
715+
],
716+
"summary": "Get a subscriber",
717+
"description": "Get subscriber date by id.",
718+
"operationId": "e44a0899dcd578274795f5899d6a9fa5",
719+
"parameters": [
720+
{
721+
"name": "session",
722+
"in": "header",
723+
"description": "Session ID obtained from authentication",
724+
"required": true,
725+
"schema": {
726+
"type": "string"
727+
}
728+
},
729+
{
730+
"name": "id",
731+
"in": "path",
732+
"description": "Subscriber ID",
733+
"required": true,
734+
"schema": {
735+
"type": "string"
736+
}
737+
}
738+
],
739+
"responses": {
740+
"200": {
741+
"description": "Success",
742+
"content": {
743+
"application/json": {
744+
"schema": {
745+
"properties": {
746+
"creation_date": {
747+
"type": "string",
748+
"format": "date-time",
749+
"example": "2017-12-16T18:44:27+00:00"
750+
},
751+
"email": {
752+
"type": "string",
753+
"example": "subscriber@example.com"
754+
},
755+
"confirmed": {
756+
"type": "boolean",
757+
"example": false
758+
},
759+
"blacklisted": {
760+
"type": "boolean",
761+
"example": false
762+
},
763+
"bounced": {
764+
"type": "integer",
765+
"example": 0
766+
},
767+
"unique_id": {
768+
"type": "string",
769+
"example": "69f4e92cf50eafca9627f35704f030f4"
770+
},
771+
"html_email": {
772+
"type": "boolean",
773+
"example": false
774+
},
775+
"disabled": {
776+
"type": "boolean",
777+
"example": false
778+
},
779+
"id": {
780+
"type": "integer",
781+
"example": 1
782+
}
783+
},
784+
"type": "object"
785+
}
786+
}
787+
}
788+
},
789+
"403": {
790+
"description": "Failure",
791+
"content": {
792+
"application/json": {
793+
"schema": {
794+
"properties": {
795+
"message": {
796+
"type": "string",
797+
"example": "No valid session key was provided as basic auth password."
798+
}
799+
},
800+
"type": "object"
801+
}
802+
}
803+
}
804+
},
805+
"404": {
806+
"description": "Not Found"
807+
}
808+
}
809+
}
718810
}
719811
},
720812
"tags": [

0 commit comments

Comments
 (0)