Skip to content
GAMPEONCreate
New project

Add a screenshot to the gallery

POST
/v1/projects/{slug}/gallery/images
curl --request POST \
--url https://api.gampeon.com/v1/projects/example/gallery/images \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: image/png' \
--data binary

Everyone who can edit the project (owner, or owners and admins of its studio). PNG, JPEG or WebP up to 2 MB, at least 480×270 pixels, no animation. The server removes all metadata (EXIF including GPS position, XMP, IPTC, comments) and gives the file a random name. At most 20 images and videos per project. Set a caption with the change route.

Not available with access tokens.

Rate limit: 30 uploads per hour per account (all images together).

slug
required
string
/^[a-z0-9][a-z0-9-]{1,30}[a-z0-9]$/

Project slug

The image

string format: binary

Added at the end of the gallery

Media typeapplication/json
One of:
object
id
required
string
type
required
Allowed value: image
url
required
One of:

Image path (/v1/media/…). null only for the team when moderation removed the image

string
width
required
integer
height
required
integer
caption
required
string
removed

Only for the team: removed by moderation

boolean

Example

{
"type": "image"
}

Error codes: invalid_image, upload_incomplete

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: unauthorized

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: token_not_allowed, forbidden, project_hidden

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: not_found

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: gallery_full

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: length_required

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: file_too_large

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: unsupported_media_type, invalid_image, animated_image

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: image_too_small, invalid_aspect_ratio

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Limit: 30 uploads per hour per account (all images together). Error codes: rate_limited

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: storage_disabled

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Report a problem with this pageOther ways to give feedback