Get current identity

Returns the acting user, organization, granted scopes, and registry-level MCP tool access for the authenticated token. tool_access predicts whether each public tool can succeed with the granted scopes; endpoint variant and connection-level tool filtering can further restrict visibility. A tool can still appear in tools/list yet return INSUFFICIENT_SCOPE, so use tool_access to plan calls and tools/list for this connection’s visibility. Available to every valid token; no scope is required. No parameters are accepted because identity is determined entirely from authentication.

GET

curl --request GET \
  --url https://api.modernloop.io/v1/me \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.modernloop.io/v1/me', 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.modernloop.io/v1/me",
  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.modernloop.io/v1/me"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.modernloop.io/v1/me")

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

{
  "id": "usr_a1b2c3d4e5f64789a1b2c3d4e5f64789",
  "name": "<string>",
  "email": "jsmith@example.com",
  "app_url": "<string>",
  "organization": {
    "id": "org_a1b2c3d4e5f64789a1b2c3d4e5f64789",
    "name": "<string>",
    "app_url": "<string>"
  },
  "scopes": [
    "<string>"
  ],
  "tool_access": [
    {
      "tool": "<string>",
      "available": true,
      "missing_scope": "<string>"
    }
  ]
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

Beta: this endpoint may change or be removed without notice while in beta. There is no compatibility promise until it reaches general availability.

Authorizations

Authorization

string

header

required

API tokens are passed as Bearer tokens.

Response

Success

string

required

Canonical user ID (usr_ followed by 32 lowercase hexadecimal UUID characters).

Pattern: ^usr_[0-9a-f]{32}$

Example:

"usr_a1b2c3d4e5f64789a1b2c3d4e5f64789"

name

string

required

string<email>

required

app_url

string<uri>

required

Link that opens this resource in the ModernLoop app.

organization

object

required

Show child attributes

scopes

string[]

required

Scopes granted to the presented token, sorted ascending.

tool_access

object[]

required

For every public MCP tool in stable registry order, available predicts whether a call can succeed with the granted scopes. Endpoint variant and connection-level include_tools/exclude_tools can further restrict visibility. A tool may appear in tools/list yet return INSUFFICIENT_SCOPE, so use this field to plan calls and tools/list for per-connection visibility.

Show child attributes

⌘I

Get current identity

curl --request GET \
  --url https://api.modernloop.io/v1/me \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.modernloop.io/v1/me', 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.modernloop.io/v1/me",
  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.modernloop.io/v1/me"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.modernloop.io/v1/me")

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

{
  "id": "usr_a1b2c3d4e5f64789a1b2c3d4e5f64789",
  "name": "<string>",
  "email": "jsmith@example.com",
  "app_url": "<string>",
  "organization": {
    "id": "org_a1b2c3d4e5f64789a1b2c3d4e5f64789",
    "name": "<string>",
    "app_url": "<string>"
  },
  "scopes": [
    "<string>"
  ],
  "tool_access": [
    {
      "tool": "<string>",
      "available": true,
      "missing_scope": "<string>"
    }
  ]
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

Activity

Application

Audit Log

Candidate

Interview Event

Interview Module

Job Stage

Job

Me

Organization

Schedule

Task Queue

Scheduling Task

Template

User

Get current identity

Authorizations

Response