Skip to content
Artbucket

What's new in a brand

GET
/api/v1/brands/{slug}/updates
curl --request GET \
  --url http://localhost:3000/api/v1/brands/example/updates \
  --header 'Authorization: Bearer <token>'

Its latest publishes, newest first, up to 20: each one’s note and picture, and what it changed for readers since the publish before it (edits between two publishes are passed over): rules by key, and pages readers can reach, a hidden one left out.

Scope: read.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
slug
required
string

Brand slug

Responses

Section titled “Responses”

200

Section titled “200”

Its publishes

Media typeapplication/json
object
data
required
Array<object>
object
version
required
integer
>= -9007199254740991 <= 9007199254740991
publishedAt
required
string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/
publishedBy
required
string | null
note
required

What changed, in the publisher’s words

string | null
image
required
Any of:
string format: uuid
/^([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)$/
changes
required

What it changed for readers since the publish before it

object
rules
required

By key

object
added
required
Array<string>
changed
required
Array<string>
removed
required
Array<string>
pages
required

Pages readers can reach: a hidden one is left out

object
added
required
Array<object>
object
slug
required
string
title
required
string
changed
required
Array<object>
object
slug
required
string
title
required
string
removed
required
Array<object>
object
slug
required
string
title
required
string
Examplegenerated
{
  "data": [
    {
      "version": 1,
      "publishedAt": "2026-04-15T12:00:00Z",
      "publishedBy": "example",
      "note": "example",
      "image": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "changes": {
        "rules": {
          "added": [
            "example"
          ],
          "changed": [
            "example"
          ],
          "removed": [
            "example"
          ]
        },
        "pages": {
          "added": [
            {
              "slug": "example",
              "title": "example"
            }
          ],
          "changed": [
            {
              "slug": "example",
              "title": "example"
            }
          ],
          "removed": [
            {
              "slug": "example",
              "title": "example"
            }
          ]
        }
      }
    }
  ]
}

default

Section titled “default”

An error

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
detail
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "detail": "example"
  }
}