Danbooru
Login Posts Comments Notes Artists Tags Pools Wiki Forum More ยป
Search Changes Help | Posts (0) History
  • Help
guro
scat
furry -rating:g

Recent Changes (all)

  • akari no mirage (project sekai)
  • tenjou reiyu
  • kimi no sensei demo heroine ni naremasu ka?
  • ichigo lemonade
  • rekkyou sensen
  • ano hi kanadeta neiro wo (project sekai)
  • coldplay kiss cam (meme)
  • xai (company)
  • amber (genshin impact)
  • nun
  • soda fountain
  • fioretta aneri
  • beverage dispenser
  • haikei bibliophile no kimitachi e (trpg)
  • bailey briggs
  • noose
  • one world trade center
  • immiscible discord (project sekai)
  • pokemon (anime)
  • brant (wuthering waves)
  • hasumi (swimsuit) (blue archive)
  • fleeing
  • caenis (fgo fes. 2025) (fate)
  • tsuji minako
  • toragara (pixiv326502)

Options

  • Wiki History
  • Discussions
  • What Links Here

api:uploads

Table of Contents
  • 1. Record field format
  • 2. Associated attributes
  • 3. Nomenclature
  • 4. Actions
    • 4.01 Index
    • 4.02 Show
    • 4.03 Delete
  • 5. See also
  • 6. External links

The following includes the details of how to interface with the upload records through the API.

Note: Only upload records created by oneself are visible, unless you are an Admin (Help:Users).

Record field format

NameTypeDetails
idinteger>0
uploader_idinteger>0
sourcestring
referer_urlstring
media_asset_countinteger
statusstring
errorstring or null
created_attimestamp
updated_attimestamp

Associated attributes

NameTypeNumberAvailabilityDetails
uploaderusersinglerequired
upload_media_assetsupload media assetmultiplerequired
media_assetsmedia assetmultiplerequired
postspostmultipleoptional

Nomenclature

  • Plural form: "uploads"
    • Used in the URL pathname
  • Singular form: "upload"
    • Used for write parameters (Help:API Write Requests)
  • Versions: none

Actions

These are the various actions that can be done with upload records.

Index
HTTP MethodGET
Base URL/uploads.json
Typeread request
DescriptionThe default order is ID descending
Search attributes

All of the following are standard attributes with all of their available formats and qualifiers.

  • Number syntax
    • id
    • media_asset_count
    • created_at
    • updated_at
  • Text syntax
    • status
    • source
    • referer_url
  • Post syntax
    • post
  • User syntax
    • uploader
  • Chaining syntax
    • media_assets
    • upload_media_assets
Special search parameters
  • is_posted - Whether to show uploads that have a post or not (Help:Boolean syntax).
Show
HTTP MethodGET
Base URL/uploads/$id.json
Typeread request
Description$id is the upload ID
Create
HTTP MethodPOST
Base URL/uploads.json
Typewrite request
Create parameters
  • Mandatory: One of these values must be present.
    • source
    • files (array file format)
  • Optional:
    • referer_url

See also

  • Help:Common URL Parameters
  • Help:API

External links

Controllerhttps://github.com/danbooru/danbooru/blob/master/app/controllers/uploads_controller.rb
Modelhttps://github.com/danbooru/danbooru/blob/master/app/models/upload.rb
Policyhttps://github.com/danbooru/danbooru/blob/master/app/policies/upload_policy.rb
Terms / Privacy / Upgrade / Contact /