LE-KO Moderation (v1.0.0)

Download OpenAPI specification:

LE-KO Moderation API for content moderation, user reporting, and admin actions.

admin

Admin moderation panel

Get moderation queue

✨ List content items awaiting moderation, with optional filters.

Authorizations:
bearerHttpAuthentication
query Parameters
entity
string (Entity)
Enum: "user" "service" "group" "post" "comment" "message" "userAward" "userAchievement" "userCertificate" "userWorkCompany" "userWorkPosition" "userCover" "userAvatar" "postImage" "groupCover" "serviceImage" "userPhoto" "groupAvatar"

Type of moderated entity

status
string (ModerationStatus)
Enum: "posted" "review" "flagged" "approved" "rejected"

Moderation lifecycle status. Updated content that was rejected is moved back to review for re-check.

limit
integer [ 1 .. 100 ]
Default: 20
offset
integer >= 0
Default: 0
header Parameters
x-current-user-id
required
string <uuid>
traceparent
string^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-...
Example: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

W3C Trace Context traceparent header for request tracing

Responses

Response Schema: application/json
required
Array of objects (ModerationItem)
Array
id
required
string <uuid>
entity
required
string (Entity)
Enum: "user" "service" "group" "post" "comment" "message" "userAward" "userAchievement" "userCertificate" "userWorkCompany" "userWorkPosition" "userCover" "userAvatar" "postImage" "groupCover" "serviceImage" "userPhoto" "groupAvatar"

Type of moderated entity

entityId
required
string <uuid>
status
required
string (ModerationStatus)
Enum: "posted" "review" "flagged" "approved" "rejected"

Moderation lifecycle status. Updated content that was rejected is moved back to review for re-check.

createdAt
required
string <date-time>
updatedAt
required
string <date-time>
total
required
integer >= 0
limit
required
integer
offset
required
integer

Response samples

Content type
application/json
{
  • "items": [
    • {
      • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      • "entity": "user",
      • "entityId": "156e622c-6cdf-4c27-9bc9-2f2db69919f5",
      • "status": "posted",
      • "createdAt": "2019-08-24T14:15:22Z",
      • "updatedAt": "2019-08-24T14:15:22Z"
      }
    ],
  • "total": 0,
  • "limit": 0,
  • "offset": 0
}

Get recent platform content

✨ List all content posted on the platform within the last N minutes.

Authorizations:
bearerHttpAuthentication
query Parameters
entity
string (Entity)
Enum: "user" "service" "group" "post" "comment" "message" "userAward" "userAchievement" "userCertificate" "userWorkCompany" "userWorkPosition" "userCover" "userAvatar" "postImage" "groupCover" "serviceImage" "userPhoto" "groupAvatar"

Type of moderated entity

status
string (ModerationStatus)
Enum: "posted" "review" "flagged" "approved" "rejected"

Moderation lifecycle status. Updated content that was rejected is moved back to review for re-check.

minutes
integer [ 1 .. 1440 ]
Default: 60
limit
integer [ 1 .. 100 ]
Default: 20
offset
integer >= 0
Default: 0
header Parameters
x-current-user-id
required
string <uuid>
traceparent
string^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-...
Example: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

W3C Trace Context traceparent header for request tracing

Responses

Response Schema: application/json
required
Array of objects (ModerationItem)
Array
id
required
string <uuid>
entity
required
string (Entity)
Enum: "user" "service" "group" "post" "comment" "message" "userAward" "userAchievement" "userCertificate" "userWorkCompany" "userWorkPosition" "userCover" "userAvatar" "postImage" "groupCover" "serviceImage" "userPhoto" "groupAvatar"

Type of moderated entity

entityId
required
string <uuid>
status
required
string (ModerationStatus)
Enum: "posted" "review" "flagged" "approved" "rejected"

Moderation lifecycle status. Updated content that was rejected is moved back to review for re-check.

createdAt
required
string <date-time>
updatedAt
required
string <date-time>
total
required
integer >= 0
limit
required
integer
offset
required
integer

Response samples

Content type
application/json
{
  • "items": [
    • {
      • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      • "entity": "user",
      • "entityId": "156e622c-6cdf-4c27-9bc9-2f2db69919f5",
      • "status": "posted",
      • "createdAt": "2019-08-24T14:15:22Z",
      • "updatedAt": "2019-08-24T14:15:22Z"
      }
    ],
  • "total": 0,
  • "limit": 0,
  • "offset": 0
}

Update moderation status

✨ Apply manual moderation decision for a content item.

Authorizations:
bearerHttpAuthentication
path Parameters
entity
required
string (Entity)
Enum: "user" "service" "group" "post" "comment" "message" "userAward" "userAchievement" "userCertificate" "userWorkCompany" "userWorkPosition" "userCover" "userAvatar" "postImage" "groupCover" "serviceImage" "userPhoto" "groupAvatar"

Type of moderated entity

entityId
required
string <uuid>
header Parameters
x-current-user-id
required
string <uuid>
traceparent
string^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-...
Example: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

W3C Trace Context traceparent header for request tracing

Request Body schema: application/json
required
status
required
string (ModerationDecisionStatus)
Enum: "approved" "rejected"

Moderator decision status

violation
string (ViolationType)
Enum: "toxicBehavior" "spam" "commercialActivity" "adultContent" "violence" "illegalActivity" "other"

Type of policy violation

moderatorId
string or null <uuid>
reason
string or null <= 1000 characters

Responses

Request samples

Content type
application/json
{
  • "status": "approved",
  • "violation": "toxicBehavior",
  • "moderatorId": "d34bd90e-1f5d-4f9e-a934-cc8697860bec",
  • "reason": "string"
}

Response samples

Content type
application/json
{
  • "errors": [
    • {
      • "code": "validation",
      • "message": "string",
      • "endpoint": "string",
      • "requestId": "string"
      }
    ]
}

Get audit log

✨ List moderation actions, including manual moderator actions and AI/system flags.

Authorizations:
bearerHttpAuthentication
query Parameters
actorId
string <uuid>
entity
string (Entity)
Enum: "user" "service" "group" "post" "comment" "message" "userAward" "userAchievement" "userCertificate" "userWorkCompany" "userWorkPosition" "userCover" "userAvatar" "postImage" "groupCover" "serviceImage" "userPhoto" "groupAvatar"

Type of moderated entity

action
string (AuditAction)
Enum: "approve" "reject" "flag"

Moderation action type

from
string <date-time>
to
string <date-time>
limit
integer [ 1 .. 100 ]
Default: 20
offset
integer >= 0
Default: 0
header Parameters
x-current-user-id
required
string <uuid>
traceparent
string^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-...
Example: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

W3C Trace Context traceparent header for request tracing

Responses

Response Schema: application/json
required
Array of objects (AuditEntry)
Array
id
required
string <uuid>
actorId
required
string <uuid>

Moderator who performed the action

entity
required
string (Entity)
Enum: "user" "service" "group" "post" "comment" "message" "userAward" "userAchievement" "userCertificate" "userWorkCompany" "userWorkPosition" "userCover" "userAvatar" "postImage" "groupCover" "serviceImage" "userPhoto" "groupAvatar"

Type of moderated entity

entityId
required
string <uuid>
action
required
string (AuditAction)
Enum: "approve" "reject" "flag"

Moderation action type

previousStatus
string (ModerationStatus)
Enum: "posted" "review" "flagged" "approved" "rejected"

Moderation lifecycle status. Updated content that was rejected is moved back to review for re-check.

newStatus
string (ModerationStatus)
Enum: "posted" "review" "flagged" "approved" "rejected"

Moderation lifecycle status. Updated content that was rejected is moved back to review for re-check.

violation
string (ViolationType)
Enum: "toxicBehavior" "spam" "commercialActivity" "adultContent" "violence" "illegalActivity" "other"

Type of policy violation

createdAt
required
string <date-time>
total
required
integer >= 0
limit
required
integer
offset
required
integer

Response samples

Content type
application/json
{
  • "items": [
    • {
      • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      • "actorId": "d2f1b55c-8cee-4a0d-af57-aebaeff77518",
      • "entity": "user",
      • "entityId": "156e622c-6cdf-4c27-9bc9-2f2db69919f5",
      • "action": "approve",
      • "previousStatus": "posted",
      • "newStatus": "posted",
      • "violation": "toxicBehavior",
      • "createdAt": "2019-08-24T14:15:22Z"
      }
    ],
  • "total": 0,
  • "limit": 0,
  • "offset": 0
}