SmartSpace.ai API Authentication Guide

Overview

To interact with the SmartSpace API, you need to authenticate your requests using a Bearer Token. This document outlines the steps required to obtain and use the Bearer Token.

Prerequisites

You will need the following credentials:

• SmartSpace Client ID (smartspace_client_id)
• Service Principal Client ID (sp_client_id)
• Service Principal Client Secret (sp_client_secret)
• Tenant ID (tenant_id)

Step 1: Obtain the Bearer Token

To obtain the Bearer Token, follow these steps:

Set Up Authentication Parameters

Prepare the authentication parameters using the credentials you have. The parameters include client_id, scope, client_secret, and grant_type.

Send the Token Request

Send a POST request to the token endpoint at https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token with the authentication parameters.

Extract the Bearer Token

Retrieve the Bearer Token from the response. It will be available in the access_token field.

Step 2: Use the Bearer Token for API Requests

When making requests to the SmartSpace API, include the Bearer Token in the Authorization header:

Prepare the API Request

Include the Bearer Token in your API request header and set the Content-Type to application/json.

Include Required Headers

Ensure the following headers are included in your request:

• Authorization: Bearer {accessToken}
• Content-Type: application/json

You will need to assign the role for app-web to the Service Principle, so it can make calls to the workspace.