Video Channels

List activities of a video channel

GET

https://peertube2.cpy.re/api/v1/video-channels/{channelHandle}/activities

PeerTube >= 8.0

curl -X GET 'https://peertube2.cpy.re/api/v1/video-channels/my_username%20%7C%20my_username%40example.com/activities?count=15'

const response = await fetch('https://peertube2.cpy.re/api/v1/video-channels/my_username%20%7C%20my_username%40example.com/activities?count=15', {
  method: 'GET',
});

const data = await response.text();

import requests

response = requests.get('https://peertube2.cpy.re/api/v1/video-channels/my_username%20%7C%20my_username%40example.com/activities?count=15')
print(response.text)

200

{
  "total": 1,
  "data": [
    {
      "id": 0,
      "account": {
        "id": 0,
        "name": "string",
        "displayName": "string",
        "url": "https://example.com",
        "host": "example.com",
        "avatars": [
          {
            "path": "string",
            "fileUrl": "string",
            "width": 0,
            "height": 0,
            "createdAt": "2024-01-15T09:30:00Z",
            "updatedAt": "2024-01-15T09:30:00Z"
          }
        ]
      },
      "action": {
        "id": 1,
        "label": "string"
      },
      "targetType": {
        "id": 1,
        "label": "string"
      },
      "details": {},
      "createdAt": "2024-01-15T09:30:00Z",
      "channel": {
        "id": 42,
        "name": "string",
        "displayName": "string",
        "url": "https://example.com"
      },
      "video": {
        "id": 42,
        "name": "string",
        "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
        "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
        "url": "https://example.com",
        "isLive": true
      },
      "videoImport": {
        "id": 42,
        "name": "string",
        "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
        "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
        "url": "https://example.com",
        "targetUrl": "https://example.com"
      },
      "playlist": {
        "id": 42,
        "name": "string",
        "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
        "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
        "url": "https://example.com"
      },
      "channelSync": {
        "id": 42,
        "externalChannelUrl": "https://example.com"
      }
    }
  ]
}

Parameters

channelHandlestringrequiredpath

The video channel handle

startinteger>= 0query

Offset used to paginate results

countinteger[1, 100]15query

Number of items to return

sortstringquery

Sort column

Response

200OKChannelActivityListResponse

successful operation

Response fields application/json

totalinteger

Example

dataArray<object>

Show child attributes

idinteger

accountAccountSummary | null

The account may have been deleted

Show child attributes

idinteger

namestring

displayNamestring

urlstring<url>

hoststring<hostname>

avatarsArray<ActorImage>

Show child attributes

pathstring | nulldeprecated

Deprecated in PeerTube v8.0, use fileUrl instead. Null if the file is stored in object storage: use the non-deprecated field instead.

fileUrlstring

PeerTube >= 7.1

widthinteger

heightinteger

PeerTube >= 7.3

createdAtstring<date-time>

updatedAtstring<date-time>

actionobject

Show child attributes

idVideoChannelActivityAction1234567891011

The activity action:

CREATE: 1
UPDATE: 2
DELETE: 3
UPDATE_CAPTIONS: 4
UPDATE_CHAPTERS: 5
UPDATE_PASSWORDS: 6
CREATE_STUDIO_TASKS: 7
UPDATE_SOURCE_FILE: 8
UPDATE_ELEMENTS: 9
REMOVE_CHANNEL_OWNERSHIP: 10
CREATE_CHANNEL_OWNERSHIP: 11

labelstring

targetTypeobject

Show child attributes

idVideoChannelActivityTarget12345

The activity target:

VIDEO: 1,
PLAYLIST: 2,
CHANNEL: 3,
CHANNEL_SYNC: 4,
VIDEO_IMPORT: 5

labelstring

detailsobject

createdAtstring<date-time>

channelobject

Show child attributes

idid>= 1

Example

namestring

displayNamestring

urlstring<url>

videoobject | null

Show child attributes

idid>= 1

Example

namestring

uuidUUIDv4<uuid>

Example

9c9de5e8-0a1e-484a-b099-e80766180a6d

shortUUIDshortUUID

translation of a uuid v4 with a bigger alphabet to have a shorter uuid

Example

2y84q2MQUMWPbiEcxNXMgC

urlstring<url>

isLiveboolean

videoImportobject | null

Show child attributes

idid>= 1

Example

namestring

uuidUUIDv4<uuid>

Example

9c9de5e8-0a1e-484a-b099-e80766180a6d

shortUUIDshortUUID

translation of a uuid v4 with a bigger alphabet to have a shorter uuid

Example

2y84q2MQUMWPbiEcxNXMgC

urlstring<url>

targetUrlstring<uri>

playlistobject | null

Show child attributes

idid>= 1

Example

namestring

uuidUUIDv4<uuid>

Example

9c9de5e8-0a1e-484a-b099-e80766180a6d

shortUUIDshortUUID

translation of a uuid v4 with a bigger alphabet to have a shorter uuid

Example

2y84q2MQUMWPbiEcxNXMgC

urlstring<url>

channelSyncobject | null

Show child attributes

idid>= 1

Example

externalChannelUrlstring<uri>

Docs by Sourcey