Overview
GET
/access/effectiveaccessA subject's effective verbs + provenance (the explainer; requires M)
List effective.
Auth: bearerAuth — calls run as the authenticated user.
Parameters
- workspacequerystring
- featurequerystring
- subjectKindquerystring
- subjectIdquerystring
- itemIdquery · optionalstring
Responses
200
Effective access
- itemVerbsstring
- subitemVerbsstring
- restrictedboolean
- decidedByobject
per-verb provenance (the explainer): verb → {kind: 'owner'|'admin-role'|'grant', roleSlug?, via?, scopeItemId?}; sub-item verbs keyed 'sub:<verb>'
Example
{
"itemVerbs": "string",
"subitemVerbs": "string",
"restricted": true,
"decidedBy": {}
}400
Error
- erroroptionalobject
Example
{
"error": {
"message": "string",
"code": "string"
}
}401
Error
- erroroptionalobject
Example
{
"error": {
"message": "string",
"code": "string"
}
}403
Error
- erroroptionalobject
Example
{
"error": {
"message": "string",
"code": "string"
}
}404
Error
- erroroptionalobject
Example
{
"error": {
"message": "string",
"code": "string"
}
}Code examples
cURL
curl -X GET "https://api.agenticdeveloperhub.com/access/effective" \
-H "Authorization: Bearer YOUR_TOKEN"JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/access/effective", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
},
});
const data = await res.json();