User

5min
To create a digital human you will need a user and organisation (Organisation and User Create﻿). Depending on your organization's type and privileges, you will have access to various head visuals.
Prior to utilizing the digital human API, you must request access. UNITH will create and assign an organization to your account and provide you with an authentication token. Your account will be exclusively assigned to your organization. 
API Users will be of role type ADMIN
Please contact us if you need access.
Authenticate
In order to authenticate, use the the following API endpoint, and provide the email used to register on the UNITH platform, along with the token provided.. 
POST https://platform-api.unith.ai/auth/enter
JSON
{
  "email": "[email protected]",
  "token": "3103d3d2-70e2-4988-95ee-..."
}
{
  "email": "abc@unithtest.ai",
  "token": "3103d3d2-70e2-4988-95ee-..."
}
﻿
Authentication request example
Curl
 curl -X 'POST' \
  'https://platform-api.unith.ai/auth/enter' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "[email protected]",
  "token": "3103d3d2-70e2-4988-95ee-..."
}
 curl -X 'POST' \
  'https://platform-api.unith.ai/auth/enter' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "abc@unithtest.ai",
  "token": "3103d3d2-70e2-4988-95ee-..."
}
﻿
Authentication Response
JSON

{
  "data": {
    "id": "49379a95-aaaa-1111-b7dd-189427f6b038",
    ...
    },
    "authToken": "abcdefg1234556677889eyadasdasdasd"
  }
}

{
  "data": {
    "id": "49379a95-aaaa-1111-b7dd-189427f6b038",
    ...
    },
    "authToken": "abcdefg1234556677889eyadasdasdasd"
  }
}
﻿
Copy the JWT Bearer authToken from the response and use for authentication purposes of all subsequent queries.
Retrieve User Information
For additional details regarding your assigned organizations, use GET /user/me
Curl
curl -X 'GET' \
  'https://platform-api.unith.ai/user/me' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer xyzasbd'
curl -X 'GET' \
  'https://platform-api.unith.ai/user/me' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer xyzasbd'
﻿
﻿
Updated 20 Sep 2024
Did this page help you?
Introduction
Create a Digital Human