POST
https://streetartcities.com/api/collectionsOnly the fields you send change, so renaming or sharing a collection keeps its artworks.
Request body
collectionIdstring· uuid· pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Only for creating: the id to give the new collection
namestring
publicboolean
Whether others can see the collection
artworksarray Artwork[]
Replaces all artworks in the collection
Requirements
Needs an access token. When using OAuth, the token needs the collections:write scope.
Responses
200 The collection
idstringrequired
createdBystringrequired
The id of the person it belongs to
namestring
artworksarray Artwork[]required
publicTokenstring
Set when the collection is public
createdAtstring
updatedAtstring
400 Invalid request
errorobjectrequired
401 Not logged in, or not your collection
errorobjectrequired
403 The app doesn't have the scope for this
errorobjectrequired
404 Not found
errorobjectrequired