Me
curl --request GET \
--url https://api.withallo.com/v2/api/me \
--header 'Authorization: <api-key>'{
"data": {
"api_key_id": "api-abc123def456",
"scopes": [
"CONVERSATIONS_READ",
"PHONE_NUMBERS_READ",
"TAGS_READ",
"TAGS_WRITE",
"USERS_READ"
],
"endpoints": [
{
"method": "GET",
"path": "/v2/api/conversations",
"description": "List conversations grouped by contact number",
"scope": "CONVERSATIONS_READ"
},
{
"method": "POST",
"path": "/v2/api/conversations/items/search",
"description": "Search calls and SMS with filters and keyword search",
"scope": "CONVERSATIONS_READ"
},
{
"method": "GET",
"path": "/v2/api/tags",
"description": "List all available tags",
"scope": "TAGS_READ"
},
{
"method": "GET",
"path": "/v2/api/users",
"description": "List team members with roles and assigned numbers",
"scope": "USERS_READ"
},
{
"method": "GET",
"path": "/v2/api/numbers",
"description": "List phone numbers with capabilities and member access",
"scope": "PHONE_NUMBERS_READ"
}
],
"team": {
"id": "team-xyz789",
"name": "Acme Sales"
},
"rate_limits": {
"read_per_second": 20,
"write_per_second": 5
}
}
}Users
Me
Returns information about the authenticated API key: its scopes, available endpoints, team, and rate limits. No specific scope is required — any valid API key can call this endpoint.
Agents should call this endpoint first to discover their capabilities before making other API calls.
GET
/
v2
/
api
/
me
Me
curl --request GET \
--url https://api.withallo.com/v2/api/me \
--header 'Authorization: <api-key>'{
"data": {
"api_key_id": "api-abc123def456",
"scopes": [
"CONVERSATIONS_READ",
"PHONE_NUMBERS_READ",
"TAGS_READ",
"TAGS_WRITE",
"USERS_READ"
],
"endpoints": [
{
"method": "GET",
"path": "/v2/api/conversations",
"description": "List conversations grouped by contact number",
"scope": "CONVERSATIONS_READ"
},
{
"method": "POST",
"path": "/v2/api/conversations/items/search",
"description": "Search calls and SMS with filters and keyword search",
"scope": "CONVERSATIONS_READ"
},
{
"method": "GET",
"path": "/v2/api/tags",
"description": "List all available tags",
"scope": "TAGS_READ"
},
{
"method": "GET",
"path": "/v2/api/users",
"description": "List team members with roles and assigned numbers",
"scope": "USERS_READ"
},
{
"method": "GET",
"path": "/v2/api/numbers",
"description": "List phone numbers with capabilities and member access",
"scope": "PHONE_NUMBERS_READ"
}
],
"team": {
"id": "team-xyz789",
"name": "Acme Sales"
},
"rate_limits": {
"read_per_second": 20,
"write_per_second": 5
}
}
}Was this page helpful?
⌘I