List in-app notices

GET

/api/v1/notices

curl --request GET \
  --url https://api.deploybase.eu/api/v1/api/v1/notices \
  --header 'Authorization: <Authorization>'

Returns the notices this person can see in this team, newest first, each with their own dismiss and acknowledgement state, plus the bell watermark (seen_at, null when they have never opened it). The list is resolved at read time: stored notices whose publication window is open and whose audience includes this team and role, plus derived notices such as the functions closed-beta invite.

Authorizations

• BearerAuth

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

object

items

Array<object>

object

acknowledged_at

string

acknowledged_version

string

body

string

cta_label

string

cta_url

string

dismissed_at

string

expires_at

string

key

string

presentation

string

published_at

string

requires_ack

boolean

severity

string

title

string

version

string

member_since

MemberSince is when this person joined the team. The frontend uses it as an unread floor, so somebody who signed up today does not open the bell to every historical changelog entry counted as unread. It does not replace SeenAt and changes none of its meaning: SeenAt stays nullable and still means “the watermark this person set”, null until they open the bell for the first time.

string

seen_at

string

Example ^generated

{
  "data": {
    "items": [
      {
        "acknowledged_at": "example",
        "acknowledged_version": "example",
        "body": "example",
        "cta_label": "example",
        "cta_url": "example",
        "dismissed_at": "example",
        "expires_at": "example",
        "key": "example",
        "presentation": "example",
        "published_at": "example",
        "requires_ack": true,
        "severity": "example",
        "title": "example",
        "version": "example"
      }
    ],
    "member_since": "example",
    "seen_at": "example"
  },
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

401

Unauthorized

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

403

Forbidden

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

404

Not Found

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

500

Internal Server Error

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

503

Service Unavailable

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}