Clerk

Overview

Use Clerk credentials to make authenticated API calls through Alter Vault without exposing API keys in code.

Property	Value
Provider ID	clerk
Category	Developer Tools
Credential Type	Bearer Token

Step 1: Get Credentials

Log in to the Clerk Dashboard

Log in to the Clerk Dashboard and select the application.

Open API keys

In the left sidebar, open API keys.

Copy the Secret Key

Under Secret keys, copy the Secret Key (starts with sk_live_ or sk_test_).

Warning

Never share credentials publicly. Store them securely and only enter them in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Clerk

Go to Managed Secrets > Add Provider > Clerk.

Enter credentials

Paste your Secret Key into the credential field.

Save

Click Save. You’ll receive a grant_id to use with the SDK.

Using in Code

response = await alter_app.request(
    HttpMethod.GET,
    "https://api.clerk.com/v1/users",
    grant_id="YOUR_GRANT_ID",
)

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
GetUserList	read	GET	/v1/users
CreateUser	write	POST	/v1/users
GetUsersCount	read	GET	/v1/users/count
GetUser	read	GET	/v1/users/{user_id}
UpdateUser	write	PATCH	/v1/users/{user_id}
DeleteUser	delete	DELETE	/v1/users/{user_id}
UpdateUserMetadata	write	PATCH	/v1/users/{user_id}/metadata
BanUser	admin	POST	/v1/users/{user_id}/ban
UnbanUser	admin	POST	/v1/users/{user_id}/unban
GetOAuthAccessToken	read	GET	/v1/users/{user_id}/oauth_access_tokens/{provider}
UsersGetOrganizationMemberships	read	GET	/v1/users/{user_id}/organization_memberships
CreateInvitation	admin, send	POST	/v1/invitations
ListInvitations	read	GET	/v1/invitations
RevokeInvitation	admin	POST	/v1/invitations/{invitation_id}/revoke
ListOrganizations	read	GET	/v1/organizations
CreateOrganization	write	POST	/v1/organizations
GetOrganization	read	GET	/v1/organizations/{organization_id}
UpdateOrganization	write	PATCH	/v1/organizations/{organization_id}
DeleteOrganization	delete	DELETE	/v1/organizations/{organization_id}
ListOrganizationMemberships	read	GET	/v1/organizations/{organization_id}/memberships
CreateOrganizationMembership	admin	POST	/v1/organizations/{organization_id}/memberships
GetSessionList	read	GET	/v1/sessions
GetSession	read	GET	/v1/sessions/{session_id}
RevokeSession	admin	POST	/v1/sessions/{session_id}/revoke
CreateSessionToken	admin	POST	/v1/sessions/{session_id}/tokens
GetJWKS	read	GET	/v1/jwks