Skip to main content
Documentation
StartOverviewArchitectureAuthenticationSend your first message
TypeScript SDKOverviewTrusted app serverApp-user clientsRealtimeErrors & webhooks
Flutter SDKOverviewInstallationAuthenticationChannels & messagesOffline & syncRealtimeUI componentsPush & lifecycle
ConceptsTenancy & scopeChannels & messagesDelivery & reconciliationSecurity checklist
ProtocolsRealtimeSigned webhooks
ReferenceREST APIErrors, limits & retriesDeploy docs to Coolify
VV ChatDocs API v1
Recommended starting points
Build chat without rebuilding infrastructureV Chat is a multi-tenant messaging backend with typed server, web, and Flutter integration paths.StartArchitecture at a glanceUnderstand the control plane, data plane, realtime path, and SDK boundaries before integrating.StartAuthentication and credentialsSelect the correct credential for dashboard, trusted-server, app-user, realtime, and webhook flows.StartSend your first messageUse the trusted TypeScript server client to create the minimum safe messaging flow.StartTypeScript SDK overviewChoose the correct typed client for trusted servers, app users, dashboard sessions, realtime, and webhooks.TypeScript SDKTrusted app-server clientUse AppServerClient from a protected backend to manage data-plane resources and mint app-user tokens.TypeScript SDKApp-user clientsBuild browser or Node app-user flows with VChatClient or the lower-level AppUserClient.TypeScript SDK
↑↓ Navigate↵ Openesc Close
API reference
StartOverviewArchitectureAuthenticationSend your first message
TypeScript SDKOverviewTrusted app serverApp-user clientsRealtimeErrors & webhooks
Flutter SDKOverviewInstallationAuthenticationChannels & messagesOffline & syncRealtimeUI componentsPush & lifecycle
ConceptsTenancy & scopeChannels & messagesDelivery & reconciliationSecurity checklist
ProtocolsRealtimeSigned webhooks
ReferenceREST APIErrors, limits & retriesDeploy docs to Coolify
Contract sourceOpenAPI JSON
Docs/API/Moderation
GET/v1/moderation/blocklists

operationIdqueryModerationBlocklists

Authentication

appServerCredential

Use only the principal and credential documented for this operation. Visibility in this reference does not grant authority.

Request

NameInRequiredDescription
x-request-idheaderNoOptional caller-supplied request correlation identifier.
X-VChat-Tenant-IdheaderYesNo description declared.
X-VChat-App-IdheaderYesNo description declared.
X-VChat-EnvironmentheaderYesNo description declared.

cURL template

Replace path placeholders, the credential, and request body with values valid for your exact scope.

cURL
curl --request GET \
+  --url 'https://api.example.com/v1/moderation/blocklists' \
+  -H 'Authorization: Bearer <token>'

Responses

200
application/json
Response schema
{
  "$ref": "#/components/schemas/ModerationBlocklistListResponseDto",
  "properties": {
    "data": {
      "items": {
        "$ref": "#/components/schemas/ModerationBlocklistDataDto"
      },
      "type": "array"
    },
    "meta": {
      "$ref": "#/components/schemas/ModerationResponseMetaDto",
      "properties": {
        "requestId": {
          "type": "string"
        }
      },
      "required": [
        "requestId"
      ],
      "type": "object"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "type": "object"
}
400
application/json
Response schema
{
  "$ref": "#/components/schemas/PublicErrorResponseDto",
  "properties": {
    "error": {
      "$ref": "#/components/schemas/PublicErrorBodyDto",
      "properties": {
        "code": {
          "enum": [
            "validation_failed",
            "authentication_failed",
            "authentication_required",
            "reauthentication_required",
            "permission_denied",
            "resource_not_found",
            "idempotency_conflict",
            "target_account_unavailable",
            "organization_owner_removal_conflict",
            "organization_owner_role_conflict",
            "organization_role_conflict",
            "membership_conflict",
            "invitation_conflict",
            "invitation_expired",
            "application_name_conflict",
            "application_settings_version_conflict",
            "environment_settings_version_conflict",
            "app_user_version_conflict",
            "channel_type_conflict",
            "channel_type_version_conflict",
            "channel_type_limit_reached",
            "channel_conflict",
            "channel_version_conflict",
            "channel_membership_conflict",
            "channel_membership_version_conflict",
            "channel_membership_limit_reached",
            "message_conflict",
            "message_version_conflict",
            "channel_read_state_conflict",
            "thread_reply_limit_reached",
            "message_reaction_type_not_allowed",
            "message_reaction_limit_reached",
            "thread_read_state_conflict",
            "credential_limit_reached",
            "credential_lifecycle_conflict",
            "device_registration_conflict",
            "device_registration_version_conflict",
            "device_registration_limit_reached",
            "attachment_upload_incomplete",
            "attachment_not_ready",
            "attachment_limit_reached",
            "moderation_relationship_limit_reached",
            "moderation_blocklist_limit_reached",
            "moderation_case_resolution_conflict",
            "message_moderation_rejected",
            "retention_policy_version_conflict",
            "data_job_not_cancelable",
            "data_job_not_ready",
            "data_job_limit_exceeded",
            "webhook_endpoint_conflict",
            "webhook_endpoint_version_conflict",
            "webhook_endpoint_limit_reached",
            "webhook_destination_rejected",
            "webhook_secret_rotation_conflict",
            "webhook_delivery_not_replayable",
            "conflict",
            "rate_limit_exceeded",
            "internal_error",
            "service_unavailable"
          ],
          "example": "service_unavailable",
          "type": "string"
        },
        "details": {
          "$ref": "#/components/schemas/PublicErrorDetailsDto"
        },
        "message": {
          "example": "The service is temporarily unavailable.",
          "type": "string"
        },
        "requestId": {
          "example": "req_01J00000000000000000000000",
          "type": "string"
        }
      },
      "required": [
        "code",
        "message",
        "requestId",
        "details"
      ],
      "type": "object"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}
401
application/json
Response schema
{
  "$ref": "#/components/schemas/PublicErrorResponseDto",
  "properties": {
    "error": {
      "$ref": "#/components/schemas/PublicErrorBodyDto",
      "properties": {
        "code": {
          "enum": [
            "validation_failed",
            "authentication_failed",
            "authentication_required",
            "reauthentication_required",
            "permission_denied",
            "resource_not_found",
            "idempotency_conflict",
            "target_account_unavailable",
            "organization_owner_removal_conflict",
            "organization_owner_role_conflict",
            "organization_role_conflict",
            "membership_conflict",
            "invitation_conflict",
            "invitation_expired",
            "application_name_conflict",
            "application_settings_version_conflict",
            "environment_settings_version_conflict",
            "app_user_version_conflict",
            "channel_type_conflict",
            "channel_type_version_conflict",
            "channel_type_limit_reached",
            "channel_conflict",
            "channel_version_conflict",
            "channel_membership_conflict",
            "channel_membership_version_conflict",
            "channel_membership_limit_reached",
            "message_conflict",
            "message_version_conflict",
            "channel_read_state_conflict",
            "thread_reply_limit_reached",
            "message_reaction_type_not_allowed",
            "message_reaction_limit_reached",
            "thread_read_state_conflict",
            "credential_limit_reached",
            "credential_lifecycle_conflict",
            "device_registration_conflict",
            "device_registration_version_conflict",
            "device_registration_limit_reached",
            "attachment_upload_incomplete",
            "attachment_not_ready",
            "attachment_limit_reached",
            "moderation_relationship_limit_reached",
            "moderation_blocklist_limit_reached",
            "moderation_case_resolution_conflict",
            "message_moderation_rejected",
            "retention_policy_version_conflict",
            "data_job_not_cancelable",
            "data_job_not_ready",
            "data_job_limit_exceeded",
            "webhook_endpoint_conflict",
            "webhook_endpoint_version_conflict",
            "webhook_endpoint_limit_reached",
            "webhook_destination_rejected",
            "webhook_secret_rotation_conflict",
            "webhook_delivery_not_replayable",
            "conflict",
            "rate_limit_exceeded",
            "internal_error",
            "service_unavailable"
          ],
          "example": "service_unavailable",
          "type": "string"
        },
        "details": {
          "$ref": "#/components/schemas/PublicErrorDetailsDto"
        },
        "message": {
          "example": "The service is temporarily unavailable.",
          "type": "string"
        },
        "requestId": {
          "example": "req_01J00000000000000000000000",
          "type": "string"
        }
      },
      "required": [
        "code",
        "message",
        "requestId",
        "details"
      ],
      "type": "object"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}
500
application/json
Response schema
{
  "$ref": "#/components/schemas/PublicErrorResponseDto",
  "properties": {
    "error": {
      "$ref": "#/components/schemas/PublicErrorBodyDto",
      "properties": {
        "code": {
          "enum": [
            "validation_failed",
            "authentication_failed",
            "authentication_required",
            "reauthentication_required",
            "permission_denied",
            "resource_not_found",
            "idempotency_conflict",
            "target_account_unavailable",
            "organization_owner_removal_conflict",
            "organization_owner_role_conflict",
            "organization_role_conflict",
            "membership_conflict",
            "invitation_conflict",
            "invitation_expired",
            "application_name_conflict",
            "application_settings_version_conflict",
            "environment_settings_version_conflict",
            "app_user_version_conflict",
            "channel_type_conflict",
            "channel_type_version_conflict",
            "channel_type_limit_reached",
            "channel_conflict",
            "channel_version_conflict",
            "channel_membership_conflict",
            "channel_membership_version_conflict",
            "channel_membership_limit_reached",
            "message_conflict",
            "message_version_conflict",
            "channel_read_state_conflict",
            "thread_reply_limit_reached",
            "message_reaction_type_not_allowed",
            "message_reaction_limit_reached",
            "thread_read_state_conflict",
            "credential_limit_reached",
            "credential_lifecycle_conflict",
            "device_registration_conflict",
            "device_registration_version_conflict",
            "device_registration_limit_reached",
            "attachment_upload_incomplete",
            "attachment_not_ready",
            "attachment_limit_reached",
            "moderation_relationship_limit_reached",
            "moderation_blocklist_limit_reached",
            "moderation_case_resolution_conflict",
            "message_moderation_rejected",
            "retention_policy_version_conflict",
            "data_job_not_cancelable",
            "data_job_not_ready",
            "data_job_limit_exceeded",
            "webhook_endpoint_conflict",
            "webhook_endpoint_version_conflict",
            "webhook_endpoint_limit_reached",
            "webhook_destination_rejected",
            "webhook_secret_rotation_conflict",
            "webhook_delivery_not_replayable",
            "conflict",
            "rate_limit_exceeded",
            "internal_error",
            "service_unavailable"
          ],
          "example": "service_unavailable",
          "type": "string"
        },
        "details": {
          "$ref": "#/components/schemas/PublicErrorDetailsDto"
        },
        "message": {
          "example": "The service is temporarily unavailable.",
          "type": "string"
        },
        "requestId": {
          "example": "req_01J00000000000000000000000",
          "type": "string"
        }
      },
      "required": [
        "code",
        "message",
        "requestId",
        "details"
      ],
      "type": "object"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}

Contract source

This page is generated from artifacts/openapi/openapi.json. The dedicated endpoint folder documents authorization, validation, errors, consistency, idempotency, events, retries, and client reconciliation.

View docs/api/v1/moderation/queryModerationBlocklists/endpoint.json
On this pageAuthenticationRequestResponsesContract source
All operations