V2
Make Your First Request
Run a minimal Buildin V2 API request and learn how to diagnose common errors.
Make Your First Request
Use GET /v2/users/me as the smallest protected request. It verifies that your token is valid and shows the identity the API will use for later calls.
Minimal curl
curl https://api.buildin.ai/v2/users/me \
-H "Authorization: Bearer $BUILDIN_API_TOKEN"
Success Response Example
{
"object": "bot_user",
"id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"name": "My Integration",
"workspace_id": "99999999-9999-4999-8999-999999999999",
"workspace_name": "Team Workspace",
"owner": {
"object": "user",
"id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb"
},
"capabilities": {
"pages.read": true,
"pages.write": true,
"blocks.read": true,
"blocks.write": true,
"databases.read": true,
"databases.write": true,
"users.read": true,
"users.email.read": false,
"search.read": true
},
"type": "integration",
"integration_id": "77777777-7777-4777-8777-777777777777"
}
Troubleshooting Order
401
- Confirm that the header is exactly
Authorization: Bearer <token>. - Check that the token has not expired or been revoked.
- Make sure no quotes, spaces, or shell interpolation errors changed the token value.
403
- Check the required scope on the endpoint page.
- Confirm that the token can access the target resource.
- Confirm that the workspace plan allows the requested API capability.