getCurrentUser
curl --request POST \
--url https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"args": {}
}'import requests
url = "https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser"
payload = { "args": {} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({args: {}})
};
fetch('https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser', 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://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'args' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser"
payload := strings.NewReader("{\n \"args\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"args\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"args\": {}\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"errorMessage": "",
"errorData": {},
"value": {
"_id": "user_9f3c2ab457",
"_creationTime": 1716403200000,
"workosUserId": "org_user_123",
"email": "member@example.com",
"displayName": "Member Example",
"orgId": "org_abc123",
"orgRole": "member",
"isActive": true,
"onboardingComplete": true,
"onboardingStartedAt": 1716406800000,
"onboardingCompletedAt": 1716489600000,
"createdAt": 1716403200000,
"updatedAt": 1716489600000
}
}{}{}Users
getCurrentUser
Returns the full user document for the currently authenticated user based on their WorkOS identity. Returns null if the user is not authenticated, allowing clients to safely subscribe without triggering errors during logged-out states. This is the primary method for retrieving the current user’s data in authenticated contexts.
POST
/
api
/
run
/
users
/
queries
/
getCurrentUser
getCurrentUser
curl --request POST \
--url https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"args": {}
}'import requests
url = "https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser"
payload = { "args": {} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({args: {}})
};
fetch('https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser', 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://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'args' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser"
payload := strings.NewReader("{\n \"args\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"args\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://connvo-dev.convex.cloud/api/run/users/queries/getCurrentUser")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"args\": {}\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"errorMessage": "",
"errorData": {},
"value": {
"_id": "user_9f3c2ab457",
"_creationTime": 1716403200000,
"workosUserId": "org_user_123",
"email": "member@example.com",
"displayName": "Member Example",
"orgId": "org_abc123",
"orgRole": "member",
"isActive": true,
"onboardingComplete": true,
"onboardingStartedAt": 1716406800000,
"onboardingCompletedAt": 1716489600000,
"createdAt": 1716403200000,
"updatedAt": 1716489600000
}
}{}{}Authorizations
Standard user authentication token issued via WorkOS. Provide as Authorization: Bearer <user-token>.
Body
application/json
⌘I