Shop Mobile More Submit  Join Login
Group Info Group Founded 14 Years ago Statistics 46 Members
377,208 Pageviews900 Watchers
COGS #2 by Z-GrimV
We are happy to announce the release of an improved API. After many years the api had become a little confusing and was not keeping up with changes to its backend systems. We therefore decided to redesign parts and fix some of the confusing naming and behaviour.

These changes are versioned so if you are using version prior to 20150416 there will be no change in behaviour, we plan to support the old api for around a year.

Summary of Changes

The folderid and stashid fields have been replaced by stackid and itemid respectively, this change applies to all endpoints.

These endpoints were removed and their functionality is provided by newer ones

  • /stash/folder
  • /stash/media
  • /stash/metadata
  • /stash/move/file
  • /stash/move/folder

New endpoints to manage stacks

  • POST /stash/move/{stackid} - moves stacks
  • POST /stash/position/{stackid} - change the position of a stack within a parent stack
  • POST /stash/update/{stackid} - update stack details (title, description)
  • GET /stash/{stackid} - fetch stack details, returns stash_metadata object
  • GET /stash/{stackid}/contents - list stack contents, supports pagination

New endpoints to manage items

  • GET /stash/item/{itemid} - fetch an item, returns stash_metadata object
  • POST /stash/delete - delete an item by itemid

Stash Metadata object

  • Renamed fields folderid and stashid
  • Removed is_folder
  • Replaced keywords with tags

Any problems can be reported on the GitHub Issue Tracker.

Header artwork: COGS #2 by Z-GrimV

More Journal Entries

Group Info

Founded 14 Years ago
Oct 25, 2001


Group Focus
deviantART Related

46 Members
900 Watchers
377,208 Pageviews
Daily Pageviews


When DT finishes making a brand new DeviantArt feature, or just fixes a bug, we first run it on our top-secret staging server. When everything's ready to go live, we sync it!
  • randomduck synced 11 hours, 22 minutes ago
  • baclap synced 13 hours, 35 minutes ago
  • yury-n synced 16 hours, 23 minutes ago
  • yury-n synced 17 hours, 22 minutes ago
  • ArtBIT synced 18 hours, 12 minutes ago
  • outgoingcoyote synced 18 hours, 17 minutes ago
  • trezoid synced 21 hours, 53 minutes ago
  • muteor synced 23 hours, 31 minutes ago
  • ArtBIT synced 1 day, 1 hour ago
  • justgalym synced 1 day, 8 hours ago
  • randomduck synced 1 day, 16 hours ago
Syncs Per Day


Add a Comment:
dogecat Featured By Owner 4 days ago  Hobbyist Filmographer
How do you kick out admins from groups?
alfonsomarin Featured By Owner Nov 11, 2015
Is there any way to access to the groups information (Members, Roles, Stats, Folders, etc) from the current API?
DRSDavidSoft Featured By Owner Nov 15, 2015  Hobbyist General Artist
What about an unofficial API? dA-Droid
alfonsomarin Featured By Owner Nov 17, 2015
What about it? For what I read in your page  and what da-Droid does. It does nothing that I'm asking for, or at least it doesn't say anywhere  that it does.

Thanks for the offer anyway.
DRSDavidSoft Featured By Owner Nov 18, 2015  Hobbyist General Artist
I have written several pieces of code to interact with DeviantArt and DiFi, which without them none of dADroid's functionalities would work either.

Therefore, I'd like to provide an API which other developers can use in order to make their job simpler.

Also, since I plan to make dADroid open-source after a while and release the code to public, other programmers could include it as a class to simplify their process. dADroid will be released as PHP, JavaScript, Python and Java variants.

If you need a dA API which doesn't exist, or does not satisfy your needs, you could note me with the functions you need, so I can add them to the dADroid.

Hope this helps.
triple7photography Featured By Owner Oct 17, 2015  Professional Photographer
Glad a page like this exists.
Rho-Mu-31 Featured By Owner Sep 24, 2015  Hobbyist General Artist
Wouldn't e-mail notification be practical?
I'm fairly new to this site but see there used to be a script & and interface before?… How about that, or just simply the option to be notified by e-mail as well (it could bring back inactive members by reminding them? :) )
MiloticScale Featured By Owner Oct 25, 2015  Hobbyist Digital Artist
...notifications for what?
Rho-Mu-31 Featured By Owner Oct 26, 2015  Hobbyist General Artist
... for a start; feedback & notes (simply put; the same events that add to the Notes & the Feedback counters on your account, the ones shown when browsing online).
Ideally one should be able to choose which events that triggers e-mail, and preferably whether to send on a per event basis, or just send i.e. a weekly summary (grouped listing of notes in one e-mail).

How about that?
MiloticScale Featured By Owner Oct 26, 2015  Hobbyist Digital Artist
That sort of defeats the purpose of having an on-site message center, doesn't it?

I'd agree maybe with the weekly summary as long as it only included unread messages. I get way to many feedback messages/notes on a regular basis to be for being notified on each. Perhaps instead a system that lets a message sit pending for at least a certain amount of time before emailing you. :nod:
(1 Reply)
Add a Comment: