README.md

AllowlistBlocklist

(allowlist_blocklist)

Overview

Available Operations

• list_allowlist_identifiers - List all identifiers on the allow-list
• create_allowlist_identifier - Add identifier to the allow-list
• create_blocklist_identifier - Add identifier to the block-list
• delete_blocklist_identifier - Delete identifier from block-list

list_allowlist_identifiers

Get a list of all identifiers allowed to sign up to an instance

Example Usage

from clerk_backend_api import Clerk

with Clerk(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as clerk:

    res = clerk.allowlist_blocklist.list_allowlist_identifiers()

    assert res is not None

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
retries	Optional[utils.RetryConfig]	➖	Configuration to override the default retry behavior of the client.

Response

List[models.AllowlistIdentifier]

Errors

Error Type	Status Code	Content Type
models.ClerkErrors	401, 402	application/json
models.SDKError	4XX, 5XX	*/*

create_allowlist_identifier

Create an identifier allowed to sign up to an instance

Example Usage

from clerk_backend_api import Clerk

with Clerk(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as clerk:

    res = clerk.allowlist_blocklist.create_allowlist_identifier(request={
        "identifier": "[email protected]",
        "notify": True,
    })

    assert res is not None

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
request	models.CreateAllowlistIdentifierRequestBody	✔️	The request object to use for the request.
retries	Optional[utils.RetryConfig]	➖	Configuration to override the default retry behavior of the client.

Response

models.AllowlistIdentifier

Errors

Error Type	Status Code	Content Type
models.ClerkErrors	400, 402, 422	application/json
models.SDKError	4XX, 5XX	*/*

create_blocklist_identifier

Create an identifier that is blocked from accessing an instance

Example Usage

from clerk_backend_api import Clerk

with Clerk(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as clerk:

    res = clerk.allowlist_blocklist.create_blocklist_identifier(request={
        "identifier": "[email protected]",
    })

    assert res is not None

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
request	models.CreateBlocklistIdentifierRequestBody	✔️	The request object to use for the request.
retries	Optional[utils.RetryConfig]	➖	Configuration to override the default retry behavior of the client.

Response

models.BlocklistIdentifier

Errors

Error Type	Status Code	Content Type
models.ClerkErrors	400, 402, 422	application/json
models.SDKError	4XX, 5XX	*/*

delete_blocklist_identifier

Delete an identifier from the instance block-list

Example Usage

from clerk_backend_api import Clerk

with Clerk(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as clerk:

    res = clerk.allowlist_blocklist.delete_blocklist_identifier(identifier_id="identifier123")

    assert res is not None

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description	Example
identifier_id	str	✔️	The ID of the identifier to delete from the block-list	identifier123
retries	Optional[utils.RetryConfig]	➖	Configuration to override the default retry behavior of the client.

Response

models.DeletedObject

Errors

Error Type	Status Code	Content Type
models.ClerkErrors	402, 404	application/json
models.SDKError	4XX, 5XX	*/*