PeerTube

List instances followed by the server

Live Test Server (live data - latest nightly version)

https://peertube2.cpy.re/api/v1

GET

/server/following

Instance Follows

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://peertube2.cpy.re/api/v1/server/following'

Response Example

{
    "data": [
        {
            "createdAt": "2019-08-24T14:15:22Z",
            "follower": {
                "avatar": {
                    "createdAt": "2019-08-24T14:15:22Z",
                    "path": "string",
                    "updatedAt": "2019-08-24T14:15:22Z"
                },
                "createdAt": "2019-08-24T14:15:22Z",
                "followersCount": 0,
                "followingCount": 0,
                "host": "example.com",
                "hostRedundancyAllowed": true,
                "id": 42,
                "name": "chocobozzz",
                "updatedAt": "2019-08-24T14:15:22Z",
                "url": "string"
            },
            "following": {
                "avatar": {
                    "createdAt": "2019-08-24T14:15:22Z",
                    "path": "string",
                    "updatedAt": "2019-08-24T14:15:22Z"
                },
                "createdAt": "2019-08-24T14:15:22Z",
                "followersCount": 0,
                "followingCount": 0,
                "host": "example.com",
                "hostRedundancyAllowed": true,
                "id": 42,
                "name": "chocobozzz",
                "updatedAt": "2019-08-24T14:15:22Z",
                "url": "string"
            },
            "id": 42,
            "score": 0,
            "state": "pending",
            "updatedAt": "2019-08-24T14:15:22Z"
        }
    ],
    "total": 1
}

Request

Query Params

state

string

optional

actorType

string

optional

start

integer

optional

Offset used to paginate results

count

integer

optional

Number of items to return

sort

string

optional

Sort column

Responses

🟢200successful operation

application/json

Body

data

array[object (Follow) {7}]

optional

createdAt

string <date-time>

optional

follower

object (Actor)

optional

following

object (Actor)

optional

integer

optional

>= 1

Example:

score

number

optional

score reflecting the reachability of the actor, with steps of 10 and a base score of 1000.

state

enum<string>

optional

Allowed values:

pendingaccepted

updatedAt

string <date-time>

optional

total

integer

optional

Example:

Modified at 2022-09-10 22:29:49

Reject a pending follower to your server

Follow a list of actors (PeerTube instance, channel or account)