Skip to content
GAMPEONCreate
New project

Upload a photo for a post

POST
/v1/me/post-images
curl --request POST \
--url https://api.gampeon.com/v1/me/post-images \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: image/png' \
--data binary

PNG, JPEG or WebP up to 2 MB and at least 64×64 pixels. Metadata (EXIF, GPS) is removed. The photo is only visible once it belongs to a post; photos that were never posted are deleted after 24 hours.

Not available with access tokens.

Rate limit: 30 images per hour per account; up to 20 photos that aren’t posted yet.

The image

string format: binary

Uploaded

Media typeapplication/json
object
file
required

Use it in images of POST /v1/posts

string
url
required
string
width
required
integer
height
required
integer

Example generated

{
"file": "example",
"url": "example",
"width": 1,
"height": 1
}

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

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: too_many_pending_images

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

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 images per hour per account; up to 20 photos that aren’t posted yet. 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"
}

Report a problem with this pageOther ways to give feedback