Support access
List support access grants
List the requests and grants that let Wordsmith engineers see your data.
GET
A support access grant lets one support member see named resources for one support ticket and one window. By default a member who manages support access gives it at once. Your support settings can instead ask for an admin other than the requester to approve it, or for both the data owner and an admin. Then the approvers are different people, and none of them is whoever raised the request. Newest requests come first.
Approving and rejecting a waiting request are not available through the API or the MCP server. Both need a recent sign-in, which an API key or token cannot prove, so the data owner and an admin decide in the web app, under Settings > Support access.
scope is resources (the role applies on the listed resources only) or organisation (across your organisation). ends_at is null for access until revoked. required_approvals lists the approvals the grant needs: admin, or data_owner and admin when your support settings ask for the data owner’s approval. separate_approvers says whether each approver must be someone other than the requester and the other approver. It is false when your support settings had approvals: requester. Both are fixed from your support settings when the grant is created.
phase says where the grant is now, worked out from status and the clock: awaiting_approval, lapsed (not approved in time), scheduled, active, expired or closed. A grant gives access only while it is active, and it expires on time without anyone acting.
requested_by is null when a Wordsmith engineer raised the request (requested_by_wordsmith), because their account is not in your organisation. closed_by is null while the grant is open, and when Wordsmith support management closed it (closed_by_wordsmith).
Authentication
Requires an API key, or an OAuth token withdirectory:admin. directory:admin is never granted by default. The caller must also hold a role with the view support access permission; the predefined admin role holds both. A Wordsmith support member is always refused, whatever role it holds. Support access must be turned on for your organisation.
Query parameters
true returns only requests and grants that can still give access: awaiting_approval, scheduled or active.Response
Returns200 with a page of grants.