Video Comments

Create a thread

POST

https://peertube2.cpy.re/api/v1/videos/{id}/comment-threads

Create a thread

curl -X POST 'https://peertube2.cpy.re/api/v1/videos/42/comment-threads' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  --data-raw '{}'

const response = await fetch('https://peertube2.cpy.re/api/v1/videos/42/comment-threads', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json',
  },
  body: '{}',
});

const data = await response.text();

import requests

response = requests.post(
    'https://peertube2.cpy.re/api/v1/videos/42/comment-threads',
    data='{}'.encode('utf-8'),
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{}

200

{
  "comment": {
    "id": 42,
    "url": "https://example.com",
    "text": "This video is wonderful!",
    "threadId": 42,
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "deletedAt": null,
    "isDeleted": false,
    "heldForReview": true,
    "totalRepliesFromVideoAuthor": 0,
    "totalReplies": 0,
    "account": {
      "id": 42,
      "url": "https://example.com",
      "avatars": [
        {
          "path": "string",
          "fileUrl": "string",
          "width": 0,
          "height": 0,
          "createdAt": "2024-01-15T09:30:00Z",
          "updatedAt": "2024-01-15T09:30:00Z"
        }
      ],
      "host": "example.com",
      "hostRedundancyAllowed": true,
      "followingCount": 0,
      "followersCount": 0,
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "displayName": "string",
      "description": "string"
    }
  }
}

Body

application/json

texttext<markdown>required

Show child attributes

Text of the comment

text<html>

Example

This video is wonderful!

Parameters

idid | UUIDv4 | shortUUIDrequiredpath

The object id, uuid or short uuid

Response

200OKCommentThreadPostResponse

successful operation

Response fields application/json

commentVideoComment

Show child attributes

idid>= 1

Example

urlurl<url>

texttext<html>

Text of the comment

Example

This video is wonderful!

threadIdid>= 1

Example

inReplyToCommentIdid | null

Show child attributes

id>= 1

Example

videoIdid

object id for the video

Show child attributes

id>= 1

Example

createdAtcreatedAt<date-time>

updatedAtupdatedAt<date-time>

deletedAtstring<date-time> | nullnull

isDeletedbooleanfalse

heldForReviewheldForReview

totalRepliesFromVideoAuthorinteger>= 0

totalRepliesinteger>= 0

accountActor & any

Show child attributes

idid>= 1

Example

Same fields as comment.videoId

urlstring<url>

nameusername

immutable name of the actor, used to find or mention it

Show child attributes

immutable name of the user, used to find or mention its actor

username

Example

chocobozzz

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>

hoststring<hostname>

server on which the actor is resident

hostRedundancyAllowedboolean | null

whether this actor's host allows redundancy of its videos

followingCountinteger>= 0

number of actors subscribed to by this actor, as seen by this instance

followersCountinteger>= 0

number of followers of this actor, as seen by this instance

createdAtstring<date-time>

updatedAtstring<date-time>

userIdid | null

object id for the user tied to this account

Show child attributes

id>= 1

Example

displayNamestring

editable name of the account, displayed in its representations

descriptionstring | null

text or bio displayed on the account's profile

404Not Found

video does not exist

Authorization

OAuth2oauth2

Authenticating via OAuth requires the following steps:

Have an activated account
Generate an access token for that account at /api/v1/users/token.
Make requests with the Authorization: Bearer <token> header
Profit, depending on the role assigned to the account

Note that the access token is valid for 1 day and is given along with a refresh token valid for 2 weeks.

Docs by Sourcey