Sign in
uploads

Get a blank upload

Changed on

Returns an unsaved upload. Rejected while uploads are locked down, for accounts below the upload minimum level, and during an account's first week.

get/uploads/new.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/uploads/new.json
  • Auth: one of:
    • none
    • HTTP basic
    • API key in query parameter login and API key in query parameter api_key

Response

A blank upload

idinteger required

The unique ID of the upload

sourcestring required

The source URL of the upload, if provided

rating's' | 'q' | 'e' required

The rating of the post (e.g., safe, questionable, explicit)

uploader_idinteger required

The ID of the user who uploaded the content

tag_stringstring

The tags associated with the upload

statusstring required

The current status of the upload. May include details like "duplicate: 12345" or "error: message"

backtracestring nullable

Any backtrace or error details if applicable

post_idinteger nullable

The ID of the post generated by this upload, if applicable

md5_confirmationstring nullable

The MD5 confirmation hash for the upload, if applicable

created_atstring date-time required

The timestamp when the upload was created

updated_atstring date-time required

The timestamp when the upload was last updated

parent_idinteger nullable

The ID of the parent post, if applicable

md5string

The MD5 hash of the file

file_extstring required

The file extension (e.g., jpg, png, webm)

file_sizeinteger required

The size of the file in bytes

image_widthinteger required

The width of the uploaded image in pixels

image_heightinteger required

The height of the uploaded image in pixels

descriptionstring

A description of the uploaded content

uploader_namestring required

The username of the uploader

Changes