For Agents
Programmatically retrieve authenticated user profile, get profile for specified xuid. Covers 34 operations with bearer authentication.
Use for: I need to authenticated user profile, I want to profile for specified xuid, Search for profile by gamertag, Find all xbox 360 gamercard
Not supported: Does not handle payments, communications, or crm - use for social media only.
XAPI provides access to Xbox Live data including profiles, achievements, game clips, screenshots, friends, clubs, and marketplace information. The API exposes 34 endpoints secured with bearer authentication.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the XAPI Xbox API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fxapi.us%2Fxapi-us" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fxapi.us%2Fxapi-us" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with XAPI Xbox API.
Retrieve authenticated user profile
Get profile for specified XUID
Check presence information
List all conversations
Monitor XAPI Xbox API operational status and events
Patterns agents use XAPI Xbox API for, with concrete tasks.
★ Social Media Operations
Use the XAPI Xbox API to perform social media operations programmatically. The API provides 34 endpoints covering core functionality including retrieve authenticated user profile, get profile for specified xuid, get profile by gamertag.
Call GET /api/profile to retrieve authenticated user profile
Automated Achievements Management
Automate achievements operations by combining multiple XAPI Xbox API endpoints. Agents can get profile for specified xuid and then get profile by gamertag in a single workflow.
Call GET /api/{xuid}/profile to get profile for specified xuid, then verify the result
AI Agent Integration via Jentic
AI agents discover and call XAPI Xbox API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle bearer tokens manually.
Search Jentic for 'retrieve authenticated user profile', load the operation schema, and execute with Jentic-managed credentials
34 endpoints — xapi provides access to xbox live data including profiles, achievements, game clips, screenshots, friends, clubs, and marketplace information.
METHOD
PATH
DESCRIPTION
/api/profile
Retrieve authenticated user profile
/api/{xuid}/profile
Get profile for specified XUID
/api/{gamertag}/profile-for-gamertag
Get profile by gamertag
/api/{xuid}/gamercard
Retrieve Xbox 360 gamercard
/api/{xuid}/presence
Check presence information
/api/{xuid}/activity
Get current activity status
/api/conversations
List all conversations
/api/conversations/{xuid}
Get conversation with another user
/api/profile
Retrieve authenticated user profile
/api/{xuid}/profile
Get profile for specified XUID
/api/{gamertag}/profile-for-gamertag
Get profile by gamertag
/api/{xuid}/gamercard
Retrieve Xbox 360 gamercard
/api/{xuid}/presence
Check presence information
/api/{xuid}/activity
Get current activity status
/api/conversations
List all conversations
/api/conversations/{xuid}
Get conversation with another user
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the XAPI Xbox API by hand means setting up its bearer auth and handling profile, presence, and conversation lookups yourself. Through Jentic you install once, import the XAPI Xbox API from the API Directory, store the token once, and your agent calls it.
Permission scoping
The XAPI Xbox API puts the Xbox user id in the URL path (/api/{xuid}/profile, /api/{xuid}/presence), so a rule can pin your agent to one xuid: it can read that user's gamercard, presence, and activity. You choose the operations it may call, so it is mostly read-only lookups and only the ones you allow are available.
Credential isolation
Your XAPI Xbox API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'retrieve the authenticated user profile' or 'get a player's presence', and Jentic returns the matching XAPI Xbox API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using XAPI Xbox API through Jentic.
What authentication does the XAPI Xbox API use?
The XAPI Xbox API uses a Bearer token in the Authorization header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.
Can I retrieve authenticated user profile with the XAPI Xbox API?
Yes. Use the GET /api/profile endpoint. The API returns structured JSON responses that agents can parse and act on directly.
What are the rate limits for the XAPI Xbox API?
Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.
How do I retrieve authenticated user profile through Jentic?
Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'retrieve authenticated user profile'. Jentic returns the matching XAPI Xbox API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.
How many endpoints does the XAPI Xbox API have?
The XAPI Xbox API exposes 34 endpoints covering achievements, clubs, content operations.
GET STARTED