MarkSubscriptionReleasesRead | Subscription API

Request

MarkSubscriptionReleasesReadRequest

MarkSubscriptionReleasesReadRequestapi.v1.subscription.MarkSubscriptionReleasesReadRequest3 fields

MarkSubscriptionReleasesReadRequest selects release events to mark read.

releaseIdsarray

uint32[]

Specific release event IDs to mark read.

animeIdoptional

uint32

Optional anime filter for marking all releases for one anime read.

all

bool

If true, marks every release for active subscriptions read.

Request JSON

{
  "releaseIds": [
    1
  ],
  "animeId": 1,
  "all": false
}

Response

MarkSubscriptionReleasesReadResponse

MarkSubscriptionReleasesReadResponseapi.v1.subscription.MarkSubscriptionReleasesReadResponse2 fields

MarkSubscriptionReleasesReadResponse confirms read cursor updates.

message

string

A descriptive message indicating the result.

updated

int32

Number of unread releases affected.

Example response

{
  "message": "success",
  "updated": 1
}

Error handling

Common failure codes

unauthenticatedThe Bearer token is missing or invalid.

invalid_argumentThe request payload failed validation.

internalThe service could not complete the operation.

Request example

curl 'https://fireani.me/api.v1.subscription.SubscriptionService/MarkSubscriptionReleasesRead' \
  -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  --data-raw '{
  "releaseIds": [
    1
  ],
  "animeId": 1,
  "all": false
}'