If you need to fetch user details from your Builder.io Space or Organization via the GraphQL Admin API, this guide will walk you through the process.
To access the Admin API, authenticate using your Space’s or Organization’s private API key. The API is available at the following endpoint:
https://cdn.builder.io/api/v2/admin
Include your private API key in the request’s Authorization header:
{
"Authorization": "Bearer bpk-xx"
}
Querying Users
To fetch a list of users in your Space or Organization, use this GraphQL query:
{
users {
id
name
email
role
lastActive
}
}
Example API Request
Make a POST request to https://cdn.builder.io/api/v2/admin with the following JSON payload:
{
"query": "{ users { id name email role lastActive } }"
}
Sample Response
A successful request will return a JSON response similar to this:
{
"data": {
"users": [
{
"id": "user-123",
"name": "John Doe",
"email": "john.doe@example.com",
"role": "admin",
"lastActive": "2025-02-28T12:00:00Z"
},
{
"id": "user-456",
"name": "Jane Smith",
"email": "jane.smith@example.com",
"role": "editor",
"lastActive": "2025-02-27T15:45:00Z"
}
]
}
}
The Builder.io Admin API supports additional queries and mutations for managing your Space or Organization. Refer to the official Builder.io Admin API documentation for more details.
https://builder.io/api/v2/admin
Hope this helps! Let me know if you have any questions.
Thanks,