Ownership Change

Accept ownership change request

POST

https://peertube2.cpy.re/api/v1/videos/ownership/{id}/accept

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

const body = `{
  "channelId": 0
}`;

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

const data = await response.text();

import requests

body = '''{
  "channelId": 0
}'''

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

Request Body

{
  "channelId": 0
}

Body

application/json

channelIdintegerrequired

Target channel id owned by the authenticated user

Parameters

idid | UUIDv4 | shortUUIDrequiredpath

The object id, uuid or short uuid

Response

204No Content

successful operation

400Bad Request

ownership change request already accepted/refused or invalid target channel id

403Forbidden

cannot terminate an ownership change of another user

404Not Found

video ownership change not found

413Payload Too Large

quota exceeded for the target account/channel

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