Developers
Menu
POSThttps://streetartcities.com/api/edits

Make or suggest a change. If you're allowed to change the entity directly, the edit is applied straight away (status: "accepted"). Otherwise it's queued for review (status: "submitted").

Edits made with an OAuth token from a third-party app are always queued for review. Send people to the reviewUrl in the response: if they're allowed to review the edit, they can accept it there themselves.

Request body

entityTypestringrequired

The kind of entity being changed. city and site mean the same thing; edits are returned with site.

Allowed values:markerartistsitetagcalendar-eventcommunity-notecity

entityIdstring

The entity to change. Leave out to create a new entity.

actionsobjectrequired

A map of changes. Keys are dot-paths into the entity (e.g. title or attributes.access_note). Values are either a literal to set, or an operation: { "$add": [...], "$remove": [...] } for arrays, or { "$unset": true } to remove a field. The special keys $mergeInto (another entity id), $delete (true, must be the only action) and $renameTo (a new name, tags only, not combined with $mergeInto) merge, delete or rename an existing entity.

editCommentstring
editAttachmentsarray string[]

Requirements

Needs an access token. When using OAuth, the token needs the edits:write scope.

Responses

201 The created edit

editEditrequired

400 Invalid request

errorstringrequired

401 Not logged in

errorstringrequired

403 No permission

errorstringrequired

404 Not found

errorstringrequired