package bff.v1
Get desktop application:
View/edit binary Protocol Buffers messages
message
moderation_service.proto:216string actor_did = 1
repeated string roles = 2
message
moderation_service.proto:220(message has no fields)
rpc BanActor (, )
moderation_service.proto:30BanActor changes an actors status to "banned". Actor can be in any status before they are banned.
message
moderation_service.proto:180string actor_did = 1
string reason = 2
message
moderation_service.proto:184optional actor = 1
CreateActor creates a database entry for an actor who does not currently exist. By default, their status will be set to none.
message
moderation_service.proto:147string actor_did = 1
string reason = 2
message
moderation_service.proto:151optional actor = 1
message
moderation_service.proto:231string subject_did = 1
bytes data = 2
message
moderation_service.proto:235(message has no fields)
message
moderation_service.proto:133string subject_did = 1
string subject_record_uri = 2
string comment = 3
message
moderation_service.proto:138optional audit_event = 1
ForceApproveActor changes an actor to "approved" status from "none" or "pending".
message
moderation_service.proto:169string actor_did = 1
string reason = 2
message
moderation_service.proto:173optional actor = 1
rpc GetActor (, )
moderation_service.proto:27GetActor fetches a single actor from the database.
message
moderation_service.proto:54string did = 1
message
moderation_service.proto:57optional actor = 1
message
moderation_service.proto:238int64 attachment_id = 1
message
moderation_service.proto:242string mime_type = 1
bytes data = 2
HoldBackPendingActor ignores a pending actor for review in some time, so we don’t need to reject actors that e.g. have no avatar or bio yet.
message
moderation_service.proto:96string did = 1
optional duration = 2
message
moderation_service.proto:100(message has no fields)
ListActors fetches multiple actors from the database. It allows this to be filtered by certain attributes.
message
moderation_service.proto:61string cursor = 1
int32 limit = 2
ActorStatus filter_status = 3
message
moderation_service.proto:66repeated actors = 1
string cursor = 2
message
moderation_service.proto:117string filter_actor_did = 1
string filter_subject_did = 2
string filter_subject_record_uri = 3
repeated AuditEventType filter_types = 6
uint32 limit = 4
limit specifies how many audit events to return. If unspecific, this defaults to 100.
string cursor = 5
message
moderation_service.proto:128repeated audit_events = 1
string cursor = 2
rpc ListRoles (, )
moderation_service.proto:41message
moderation_service.proto:207(message has no fields)
message
moderation_service.proto:208map<string, > roles = 1
rpc Ping (, )
moderation_service.proto:15Ping is a test RPC that checks that the user is authenticated and then returns an empty response. Ideal for health checking the moderation service.
message
moderation_service.proto:71(message has no fields)
message
moderation_service.proto:72(message has no fields)
TODO: Refactor ProcessApprovalQueue to something more like "ProcessPendingActor"
message
moderation_service.proto:80string did = 1
ApprovalQueueAction action = 2
bool is_artist = 3
string reason = 4
reason is the reason that the actor was approved or rejected. This is currently optional but will become required for rejections eventually.
message
moderation_service.proto:88(message has no fields)
UnapproveActor changes an actor from "approved" status to "none" status.
message
moderation_service.proto:158string actor_did = 1
string reason = 2
message
moderation_service.proto:162optional actor = 1
rpc ListFeeds (, )
public_service.proto:9ListFeeds returns a list of all feeds hosted by this server.
message
public_service.proto:13(message has no fields)
message
public_service.proto:15repeated feeds = 1
service UserService
user_service.proto:11rpc GetMe (, )
user_service.proto:12message
user_service.proto:16(message has no fields)
message
user_service.proto:17optional Actor = 1
message
user_service.proto:21(message has no fields)
message
user_service.proto:22(message has no fields)
message
types.proto:17Used in: , , , , , ,
string did = 1
did is the decentralized identity of the actor. This is also the UID used for fetching and mutating actors.
bool is_artist = 3
is_artist is a flag indicating this account is primarily an artist. It does not currently control any feed placement.
string comment = 4
comment is a short string that is applied to an account when it is added to the system. This will eventually be replaced by a more powerful system.
ActorStatus status = 5
status indicates the actor's current status.
optional created_at = 6
created_at indicates the time that the actor was first added to the bff system - this does not necessarily indicate when they joined bluesky.
repeated string roles = 7
roles is an array of roles this actor holds in relation to actions on the moderation API.
optional held_until = 8
held_until is the time until an actor with the PENDING status is ignored in the queue to be processed later, e.g. when the actor doesn’t have an avatar
Used in: ,
ACTOR_STATUS_UNSPECIFIED = 0
ACTOR_STATUS_PENDING = 1
ACTOR_STATUS_APPROVED = 2
ACTOR_STATUS_BANNED = 3
ACTOR_STATUS_NONE = 4
Used in: ,
APPROVAL_QUEUE_ACTION_UNSPECIFIED = 0
APPROVAL_QUEUE_ACTION_APPROVE = 1
APPROVAL_QUEUE_ACTION_REJECT = 2
message
moderation_service.proto:222repeated string roles_before = 1
repeated string roles_after = 2
message
moderation_service.proto:227repeated int64 attachment_ids = 1
message
moderation_service.proto:191Used in: ,
string id = 1
id is a unique identifier of this audit event.
optional created_at = 2
string actor_did = 3
actor_did is the DID of the actor whose action caused this audit event to be emitted.
string subject_did = 4
subject_did is the DID of the actor who the action was done to.
string subject_record_uri = 5
subject_record_uri is the optional AT URI of a specific ATProto record that the action was taken against.
optional payload = 6
Used in:
COMMENT = 0
APPROVED = 1
REJECTED = 2
HELD_BACK = 3
FORCE_APPROVED = 4
UNAPPROVED = 5
TRACKED = 6
BANNED = 7
ASSIGNED_ROLES = 8
message
moderation_service.proto:187string reason = 1
message
moderation_service.proto:143CommentAuditPayload is the payload for the `comment`audit event. This is empty, as the comment is actually held within `AuditEvent`
string comment = 1
message
moderation_service.proto:154string reason = 1
message
public_service.proto:19Used in:
string id = 1
id is the unique identifier of the feed. This is also the rkey it is published under on bluesky.
string link = 2
link is a link to the feed in the official Bluesky client.
string display_name = 3
display_name is the short name of the feed shown in the Bluesky client.
string description = 4
description is a long description of the feed shown in the Bluesky client.
int32 priority = 5
priority indicates where to show this feed in BFF UIs, allowing more common feeds to be shown first. Higher priority wins. Negative values indicate the feed should be hidden in the UI.
message
moderation_service.proto:176string reason = 1
message
moderation_service.proto:101optional held_until = 1
message
moderation_service.proto:48string uri = 1
optional created_at = 2
optional indexed_at = 3
message
moderation_service.proto:91ProcessApprovalQueueAuditPayload is the payload for the `process_approval_queue` audit event.
ApprovalQueueAction action = 1
string reason = 2
message
moderation_service.proto:212Used in:
repeated string permissions = 1
message
moderation_service.proto:165string reason = 1