Users
Get my account
Fetches detailed information about a user, including profile details, teams, locale, and other metadata. Indicates if the token used in the request is privileged or outdated. Privileged tokens are necessary for specific sensitive operations like email updates.
GET
/
users
/
{user_id}
Retrieve user details
curl --request GET \
--url https://api.superthread.com/v1/users/{user_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.superthread.com/v1/users/{user_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.superthread.com/v1/users/{user_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.superthread.com/v1/users/{user_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.superthread.com/v1/users/{user_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.superthread.com/v1/users/{user_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.superthread.com/v1/users/{user_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"user": {
"id": "u-dsu0j19",
"email": "user@example.com",
"email_confirmed": true,
"first_name": "John",
"last_name": "Smith",
"display_name": "pete",
"profile_image": "https://s3..../avatar.png",
"thumbnail_image": "https://s3..../avatar.png",
"color": "red",
"teams": [
{
"archived": {
"user_id": "uDsu0j19",
"time_archived": 1608742037016
},
"id": "t-iwquhs1",
"sub_domain": "apple",
"team_name": "Apple Backend",
"company_name": "Apple Inc",
"email_domain": "apple.com",
"creator_user_id": "u-dsu0j19",
"time_created": 1608742037016,
"time_updated": 1608742037016,
"trashed": {
"user_deleted": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": false,
"on_behalf_of": "<string>"
}
},
"time_deleted": 1608742037016
},
"logo": {
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup"
},
"subscription_plan_id": "free",
"features": [
{
"id": "<string>",
"enabled": true,
"time_enabled": 1608742037016,
"toggleable": true
}
],
"limits": [
{
"id": "<string>",
"limit_value": "2"
}
],
"team_description": "Technology company",
"flags": [
"ai0"
]
}
],
"time_created": 1608742037016,
"time_updated": 1608742037016,
"current_project": "<string>",
"timezone_id": "America/Los_Angeles",
"autodetect_timezone_id": true,
"locale": "en",
"transcription_keywords": [
"<string>"
],
"job_description": "software engineer",
"rank": 1
},
"token_outdated": true,
"token_privileged": true
}{
"error": {
"id": "err5f744ab",
"code": 403,
"sec": "SEC:000-00014",
"message": "You do not have access to this resource",
"date": 1608742037016
}
}You can replaceuser_idwithmein order to return your own account details. (https://api.superthread.com/v1/users/me)
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
User ID is an alphanumerical string that identifies a user.
Previous
Update my accountUpdates user profile fields such as name, profile image, timezone, and company information.
Allows selective updates, leaving unspecified fields unmodified.
A successful request returns the updated user details.
Next
⌘I
Retrieve user details
curl --request GET \
--url https://api.superthread.com/v1/users/{user_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.superthread.com/v1/users/{user_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.superthread.com/v1/users/{user_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.superthread.com/v1/users/{user_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.superthread.com/v1/users/{user_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.superthread.com/v1/users/{user_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.superthread.com/v1/users/{user_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"user": {
"id": "u-dsu0j19",
"email": "user@example.com",
"email_confirmed": true,
"first_name": "John",
"last_name": "Smith",
"display_name": "pete",
"profile_image": "https://s3..../avatar.png",
"thumbnail_image": "https://s3..../avatar.png",
"color": "red",
"teams": [
{
"archived": {
"user_id": "uDsu0j19",
"time_archived": 1608742037016
},
"id": "t-iwquhs1",
"sub_domain": "apple",
"team_name": "Apple Backend",
"company_name": "Apple Inc",
"email_domain": "apple.com",
"creator_user_id": "u-dsu0j19",
"time_created": 1608742037016,
"time_updated": 1608742037016,
"trashed": {
"user_deleted": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": false,
"on_behalf_of": "<string>"
}
},
"time_deleted": 1608742037016
},
"logo": {
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup"
},
"subscription_plan_id": "free",
"features": [
{
"id": "<string>",
"enabled": true,
"time_enabled": 1608742037016,
"toggleable": true
}
],
"limits": [
{
"id": "<string>",
"limit_value": "2"
}
],
"team_description": "Technology company",
"flags": [
"ai0"
]
}
],
"time_created": 1608742037016,
"time_updated": 1608742037016,
"current_project": "<string>",
"timezone_id": "America/Los_Angeles",
"autodetect_timezone_id": true,
"locale": "en",
"transcription_keywords": [
"<string>"
],
"job_description": "software engineer",
"rank": 1
},
"token_outdated": true,
"token_privileged": true
}{
"error": {
"id": "err5f744ab",
"code": 403,
"sec": "SEC:000-00014",
"message": "You do not have access to this resource",
"date": 1608742037016
}
}