Bans

get

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Query parameters

ban_typestring · enumOptionalPossible values:

ban_type_valuestringOptional

reasonstringOptional

limitinteger · int32 · min: 1 · max: 100Optional

The maximum number of items to return in a single request.

afterstring · flake-idOptional

Returns items after the specified ID. Used for forward pagination through results.

Example: 411486491630370816

beforestring · flake-idOptional

Returns items before the specified ID. Used for backward pagination through results.

Example: 411486491630370816

ascbooleanOptional

Determines the sort order of returned items. When true, items are returned in ascending order. When false, items are returned in descending order.

Responses

200

OK

application/json

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

reasonstringRequired

enabledbooleanRequired

created_atstring · date-timeRequired

updated_atstring · nullableOptional

expires_atstring · nullableOptional

default

Error response

application/json

get/v1/stores/{storeId}/bans

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/bans HTTP/1.1
Authorization: APIKey TOKEN_HERE
Accept: */*

[
  {
    "id": "411486491630370816",
    "store_id": "411486491630370816",
    "reason": "text",
    "enabled": true,
    "identities": [
      {
        "ban_type": "unknown",
        "ban_type_value": "text"
      }
    ],
    "created_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    },
    "created_at": "2026-07-11T00:23:48.060Z",
    "updated_at": null,
    "updated_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    },
    "expires_at": null
  }
]

post

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

reasonstring · nullableOptional

expires_atstring · nullableOptional

Responses

201

Created

application/json

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

reasonstringRequired

enabledbooleanRequired

created_atstring · date-timeRequired

updated_atstring · nullableOptional

expires_atstring · nullableOptional

default

Error response

application/json

post/v1/stores/{storeId}/bans

HTTPcURLJavaScriptPython

POST /v1/stores/{storeId}/bans HTTP/1.1
Authorization: APIKey TOKEN_HERE
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "reason": null,
  "identities": [
    {
      "ban_type": "unknown",
      "ban_type_value": "text"
    }
  ],
  "expires_at": null
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "reason": "text",
  "enabled": true,
  "identities": [
    {
      "ban_type": "unknown",
      "ban_type_value": "text"
    }
  ],
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "created_at": "2026-07-11T00:23:48.060Z",
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "expires_at": null
}

get

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

banIdstring · flake-idRequiredExample: 411486491630370816

Responses

200

OK

application/json

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

reasonstringRequired

enabledbooleanRequired

created_atstring · date-timeRequired

updated_atstring · nullableOptional

expires_atstring · nullableOptional

default

Error response

application/json

get/v1/stores/{storeId}/bans/{banId}

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/bans/{banId} HTTP/1.1
Authorization: APIKey TOKEN_HERE
Accept: */*

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "reason": "text",
  "enabled": true,
  "identities": [
    {
      "ban_type": "unknown",
      "ban_type_value": "text"
    }
  ],
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "created_at": "2026-07-11T00:23:48.060Z",
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "expires_at": null
}

delete

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

banIdstring · flake-idRequiredExample: 411486491630370816

Responses

204

No Content

No content

default

Error response

application/json

delete/v1/stores/{storeId}/bans/{banId}

HTTPcURLJavaScriptPython

DELETE /v1/stores/{storeId}/bans/{banId} HTTP/1.1
Authorization: APIKey TOKEN_HERE
Accept: */*

No content

patch

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

banIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

reasonstring · nullableOptional

expires_atstring · nullableOptional

Responses

200

OK

application/json

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

reasonstringRequired

enabledbooleanRequired

created_atstring · date-timeRequired

updated_atstring · nullableOptional

expires_atstring · nullableOptional

default

Error response

application/json

patch/v1/stores/{storeId}/bans/{banId}

HTTPcURLJavaScriptPython

PATCH /v1/stores/{storeId}/bans/{banId} HTTP/1.1
Authorization: APIKey TOKEN_HERE
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "reason": null,
  "identities": [
    {
      "ban_type": "unknown",
      "ban_type_value": "text"
    }
  ],
  "expires_at": null
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "reason": "text",
  "enabled": true,
  "identities": [
    {
      "ban_type": "unknown",
      "ban_type_value": "text"
    }
  ],
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "created_at": "2026-07-11T00:23:48.060Z",
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "expires_at": null
}

post

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

Responses

200

OK

application/json

is_bannedbooleanRequired

ban_idstring · flake-idOptionalExample: 411486491630370816

default

Error response

application/json

post/v1/stores/{storeId}/bans/check

HTTPcURLJavaScriptPython

POST /v1/stores/{storeId}/bans/check HTTP/1.1
Authorization: APIKey TOKEN_HERE
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "identities": [
    {
      "ban_type": "unknown",
      "ban_type_value": "text"
    }
  ]
}

application/jsontext/jsonapplication/*+json

{
  "is_banned": true,
  "ban_id": "411486491630370816"
}