Skip to main content
PATCH
Update Post
Change a post’s title, description or privacy. Send only the fields you want to change.

Body

Behavior

  • Send a JSON body. At least one field is required.
  • Text over the limit returns 400; it is never truncated. Surrounding whitespace is trimmed.
  • You must own the post. For a team post, use that team’s access key.
  • Requires gallery access on the key.
  • Moderated posts cannot be changed and return 403 with type moderated.
  • A restricted post cannot be made public and returns 403 with type forbidden. It can still switch between private and unlisted.
  • Team posts are always private. Sending privacy: private on a team post is accepted and changes nothing; any other value returns 403.
  • Making a post public runs the same automatic scan as a new upload.
  • The response is the full updated post.

Examples

Change the title and make the post public:
Clear the description:

Responses

Errors

Authorizations

api-key
string
header
required

Your API key from an app on snipp.gg/settings/apps

Path Parameters

code
string
required

Post share code.

Body

application/json
title
string | null

Empty string or null clears it.

Maximum string length: 30
description
string | null

Empty string or null clears it.

Maximum string length: 200
privacy
enum<string>
Available options:
public,
unlisted,
private

Response

Success

post
object
required