curl --request POST \
--url https://patch.gg/api/v1/projects/{owner}/{slug}/media/{id}/complete \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://patch.gg/api/v1/projects/{owner}/{slug}/media/{id}/complete', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://patch.gg/api/v1/projects/{owner}/{slug}/media/{id}/complete"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "cover",
"status": "pending",
"url": "<string>",
"levels": [
{
"width": 123,
"url": "<string>"
}
],
"content_type": "<string>",
"sha256": "<string>",
"size": 123,
"width": 123,
"height": 123,
"alt": "<string>",
"error": "<string>",
"position": 123,
"generated": true,
"job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "<string>"
}{
"error": {
"code": "version_exists",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "version_exists",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "version_exists",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "version_exists",
"message": "<string>",
"details": "<unknown>"
}
}Confirm an upload, and start making the media's copies
Checks the file’s hash, its size and that it’s the kind of file you said it was, then answers at once with the media processing while Patch makes its smaller copies (levels): a few seconds for a picture and, for a clip, about as long as it plays. It becomes ready, public and served as what its bytes say it is, once they’re made, and shows on the project’s page from then on, so there’s no need to wait for it. If its copies can’t be made, it becomes failed with why in error: complete it again to try again. If it isn’t that kind of file, or can’t be read at all, answers media_invalid and removes the media, since those bytes would never pass. If Patch can’t start its copies, answers 503 copies_unavailable and the media is failed: complete it again.
curl --request POST \
--url https://patch.gg/api/v1/projects/{owner}/{slug}/media/{id}/complete \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://patch.gg/api/v1/projects/{owner}/{slug}/media/{id}/complete', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://patch.gg/api/v1/projects/{owner}/{slug}/media/{id}/complete"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "cover",
"status": "pending",
"url": "<string>",
"levels": [
{
"width": 123,
"url": "<string>"
}
],
"content_type": "<string>",
"sha256": "<string>",
"size": 123,
"width": 123,
"height": 123,
"alt": "<string>",
"error": "<string>",
"position": 123,
"generated": true,
"job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "<string>"
}{
"error": {
"code": "version_exists",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "version_exists",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "version_exists",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "version_exists",
"message": "<string>",
"details": "<unknown>"
}
}Authorizations
An API key (pch_...) or the token from pch login.
Path Parameters
"patch"
"demo-mod"
Response
The media, making its copies or ready
cover: the wide 16:9 key art every card shows (one). screenshot: up to 20. clip: up to 5, for the game page. tall_cover: the tall 2:3 key art for where games stand as tall tiles (one). hover_clip: 4 to 8 seconds of play, no UI, that cards fade into while pointed at (one, at most 20 MB). A new cover, tall cover or hover clip replaces the old once it's ready.
cover, screenshot, clip, tall_cover, hover_clip pending until its upload is completed. processing while its smaller copies are made: a few seconds for a picture and, for a clip, about as long as it plays. ready once they and the file are public, which is when it shows. failed when they couldn't be made, with why in error: complete it again to try again. Only its managers see it before it's ready.
pending, processing, ready, failed Where it's served from, once it's ready
Smaller copies of a picture (WebP) or a clip (MP4, H.264, without sound), smallest first, each at its own address that never changes. Show the smallest that's sharp where it goes. Empty for animated pictures, for flat art and short clips with no smaller copy, and for media from before Patch made copies until theirs are made: then use the file itself.
Show child attributes
Show child attributes
Why its copies couldn't be made, when it's failed
Order among media of the same kind
Made by an image model: a cover or tall cover that's key art built from the game's real frames
The covers job whose take it is, when Patch's free covers made it