v1

latestOpenAPI 3.0.32026-07-268955212.1 KB

authorization

Authorize the client

OAuth 2.0 authorization endpoint to initiate the OAuth 2.0 Authorization Code grant to obtain an authorization code to exchange for an access token.

Use Authorization Code grant to obtain access token for a Company.

get/authorize

Query parameters

response_type'code' required

The response type for the authorization request

client_idstring uuid required

The client ID for the authorization request

redirect_uristring uri required

The URI to redirect the user to after authorization. Must match one of the redirect URIs registered for the client.

scopestring

The scope for the authorization request

statestring required

An opaque value used by the client to maintain state between the request and callback. Required as protection against CSRF (cross-site request forgery) attacks.

bokio_tenantidstring uuid

The Bokio tenant ID to authorize the integration to have access. Bokioio company ID will be the teant ID when the tenant_type is company.

bokio_tenanttype'company'

The Bokio tenant type to authorize the integration to have access. Currently support only company tenant type.