Jump to Content

Guides API Reference Discussions

Documentation Home Portal Status

Home Portal Status

Guides API Reference Discussions

Administrator Authentication

Authentication
/login
- User loginpost
/login/refresh
- Refresh API tokenpost
/user
- Register a new userpost
/user/confirm/{token}
- Confirm and activate user with a temporary tokenget
/user/{user_id}
- Show user info by user IDget
- Update an existing userput

Border0 API

/audit_actions
- Show all audit logs from organizationget
/client/auth/org/{slug}
- Authenticate a client with headers against organization emailget
Client authentication
/client/device_authorizations
- Fetches a client token in exchange for a device authorization code previously authorized via the (OAuth2.0) client device authorization flowget
- Posts details for a device initiating a new (OAuth2.0) client device authorization flow in exchange for a one-time-use codepost
/client/resources
- Show socket client resourcesget
/organization/identity_provider
- Add a custom identity provider to the current organizationpost
- Update a custom identity provider in the current organizationpatch
/organization/identity_provider/{name}
- Get a custom identity provider for the current organizationget
- Remove a custom identity provider from the current organizationdelete
/organization/identity_provider_status
- Toggle the status (enable/disable) of an identity provider in the current organizationput
/organization/identity_providers
- List all identity providers for the current organizationget
/organizations
- Create a new organizationpost
/organizations/csr
- Generate a cert request and sign the CSR with organization CApost
/organizations/customdomains
/organizations/notifications
- List all notificationsget
- Create a notificationpost
/organizations/notifications/{name}
/organizations/settings
- Update organization settingsput
/organizations/sign_ssh
- Generate a signed SSH cert for organizationpost
/organizations/tokens
/organizations/users/leave
- Leave an organizationput
/organizations/users/remove
- Remove user from an organizationput
/organizations/users/switch_role
- Switch user roleput
/policies
- get policies paginatedget
- Create a new policy and attach sockets to thempost
/policies/find
- find policies by a specific paramget
/policy/{uuid}
/sessions
- Show all sessions from a organizationget
/socket/{socket_id_or_name}
/socket/{socket_id_or_name}/customcert
- Show a custom cert from a socketget
/socket/{socket_id_or_name}/signkey
- Generate a signed cert for a tunnelpost
/socket/{socket_id_or_name}/tunnel
- Show all tunnels from a socketget
- Create a socket tunnelpost
/socket/{socket_id_or_name}/tunnel/{tunnel_id}
- Show one tunnel from a socket by socket ID and tunnel IDget
- Delete one tunnel from a socket by socket ID and tunnel IDdelete
/socket/{socket_id_or_name}/tunnel/{tunnel_id}/signkey
- Generate a signed cert for a tunnelpost
/users/mfa_challenge
- MFA Challengepost
/users/mfa_confirm
- MFA Setup Confirmpost
/users/mfa_disabled
- Disable MFAput
/users/mfa_setup
- MFA Setupget
/users/organizations/switch
- Switch Organizationpost

Sockets

Sockets
/socket
- Show all socketsget
- Create a socketpost

Connect

/connect
- Show all connected socketsget
- Create a socket connectionpost

Sessions

/session/{socket_id}
- Show all sessions from a socket by socket ID, including active and killed sessionsget
/session/{socket_id}/{session_id}
- Show a socket's session info by socket ID and session IDget
- Kill a socket's session with socket ID, session ID and json payload with killed flagput
/session/{socket_id}/{session_id}/session_log
- Download a socket's session recordingget

Statistics

/stats/{socket_id}/bandwidth
- Get number of requests by status codeget
/stats/{socket_id}/requests
- Get number of requests by status codeget

Certificate Signing

/mtls-ca/socket/{socket_dnsname}/auth
- Generate a JWT for CA request on socket's DNS nameget
/mtls-ca/socket/{socket_dnsname}/csr
- Generate a cert request and sign the CSR with socket's CA certpost
/mtls-ca/socket/{socket_dnsname}/ssh
- Generate a signed SSH cert for socketpost

Powered by

Administrator Authentication

Authentication
/login
- User loginpost
/login/refresh
- Refresh API tokenpost
/user
- Register a new userpost
/user/confirm/{token}
- Confirm and activate user with a temporary tokenget
/user/{user_id}
- Show user info by user IDget
- Update an existing userput

Border0 API

/audit_actions
- Show all audit logs from organizationget
/client/auth/org/{slug}
- Authenticate a client with headers against organization emailget
Client authentication
/client/device_authorizations
- Fetches a client token in exchange for a device authorization code previously authorized via the (OAuth2.0) client device authorization flowget
- Posts details for a device initiating a new (OAuth2.0) client device authorization flow in exchange for a one-time-use codepost
/client/resources
- Show socket client resourcesget
/organization/identity_provider
- Add a custom identity provider to the current organizationpost
- Update a custom identity provider in the current organizationpatch
/organization/identity_provider/{name}
- Get a custom identity provider for the current organizationget
- Remove a custom identity provider from the current organizationdelete
/organization/identity_provider_status
- Toggle the status (enable/disable) of an identity provider in the current organizationput
/organization/identity_providers
- List all identity providers for the current organizationget
/organizations
- Create a new organizationpost
/organizations/csr
- Generate a cert request and sign the CSR with organization CApost
/organizations/customdomains
/organizations/notifications
- List all notificationsget
- Create a notificationpost
/organizations/notifications/{name}
/organizations/settings
- Update organization settingsput
/organizations/sign_ssh
- Generate a signed SSH cert for organizationpost
/organizations/tokens
/organizations/users/leave
- Leave an organizationput
/organizations/users/remove
- Remove user from an organizationput
/organizations/users/switch_role
- Switch user roleput
/policies
- get policies paginatedget
- Create a new policy and attach sockets to thempost
/policies/find
- find policies by a specific paramget
/policy/{uuid}
/sessions
- Show all sessions from a organizationget
/socket/{socket_id_or_name}
/socket/{socket_id_or_name}/customcert
- Show a custom cert from a socketget
/socket/{socket_id_or_name}/signkey
- Generate a signed cert for a tunnelpost
/socket/{socket_id_or_name}/tunnel
- Show all tunnels from a socketget
- Create a socket tunnelpost
/socket/{socket_id_or_name}/tunnel/{tunnel_id}
- Show one tunnel from a socket by socket ID and tunnel IDget
- Delete one tunnel from a socket by socket ID and tunnel IDdelete
/socket/{socket_id_or_name}/tunnel/{tunnel_id}/signkey
- Generate a signed cert for a tunnelpost
/users/mfa_challenge
- MFA Challengepost
/users/mfa_confirm
- MFA Setup Confirmpost
/users/mfa_disabled
- Disable MFAput
/users/mfa_setup
- MFA Setupget
/users/organizations/switch
- Switch Organizationpost

Sockets

Sockets
/socket
- Show all socketsget
- Create a socketpost

Connect

/connect
- Show all connected socketsget
- Create a socket connectionpost

Sessions

/session/{socket_id}
- Show all sessions from a socket by socket ID, including active and killed sessionsget
/session/{socket_id}/{session_id}
- Show a socket's session info by socket ID and session IDget
- Kill a socket's session with socket ID, session ID and json payload with killed flagput
/session/{socket_id}/{session_id}/session_log
- Download a socket's session recordingget

Statistics

/stats/{socket_id}/bandwidth
- Get number of requests by status codeget
/stats/{socket_id}/requests
- Get number of requests by status codeget

Certificate Signing

/mtls-ca/socket/{socket_dnsname}/auth
- Generate a JWT for CA request on socket's DNS nameget
/mtls-ca/socket/{socket_dnsname}/csr
- Generate a cert request and sign the CSR with socket's CA certpost
/mtls-ca/socket/{socket_dnsname}/ssh
- Generate a signed SSH cert for socketpost

Powered by

List all identity providers for the current organization

get https://example.com/organization/identity_providers

Language

Authorization

Header

Log in to use your API keys

Click Try It! to start a request and see the response here!