Workspace administration
Every Workspace administration tool, with the scope it needs, its arguments and the API operation it calls.
15 tools
Get workspace branding
Read onlyatlas_workspace_branding_get
Read tenant-level white-label branding tokens: display name, tagline, accent hex, logo URL, and favicon URL.
- Scope
workspace:read- Calls
- GET /v1/tenant-branding
- Example prompt
- Show this tenant branding setup.
Arguments
This tool takes no arguments.
Update workspace branding
Changes dataatlas_workspace_branding_update
Update tenant-level white-label branding tokens. Omitted fields preserve existing values; null or empty clears supported fields.
- Scope
workspace:manage- Calls
- PUT /v1/tenant-branding
- Example prompt
- Set the tenant accent color to #16a34a.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
displayName | string | null | No | |
tagline | string | null | No | |
accentHex | "" | string | null | No | |
logoUrl | string | null | No | |
faviconUrl | string | null | No |
Get workspace chrome branding
Read onlyatlas_workspace_chrome_branding_get
Read workspace chrome branding from the tenant row: display name, logo URL, and brand color.
- Scope
workspace:read- Calls
- Example prompt
- Show the workspace display name, logo, and brand color.
Arguments
This tool takes no arguments.
Update workspace chrome branding
Changes dataatlas_workspace_chrome_branding_update
Update workspace chrome branding. Admin-only server-side; omitted fields preserve values and null or empty clears supported fields.
- Scope
workspace:manage- Calls
- Example prompt
- Set the workspace brand color to #0f766e.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
displayName | string | null | No | |
logoUrl | "" | string | null | No | |
brandColor | "" | string | null | No |
Create workspace
Changes dataatlas_workspace_create
Create a new intra-tenant Workspace. Idempotent within the request window: retries with the same name re-use the existing row instead of duplicating.
- Scope
workspace:manage- Calls
- Example prompt
- Create a Marketing workspace.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name (1-120 chars). Used in the workspace switcher and on the projects index. |
Export workspace delegated grant evidence
Read onlyatlas_workspace_delegated_grant_evidence_export
Export the tamper-evident evidence record of every delegated grant in the workspace. Returns a snapshot with the format, generation time, item count, the SHA-256 root hash and chain head, a summary, and one entry per grant with its grantee, capability, scope, approval and revocation history and chain hashes. Use this for an access review or an audit request.
- Scope
workspace:read- Calls
- Example prompt
- Export the evidence record of every delegated grant for the access review.
Arguments
This tool takes no arguments.
List workspace
Read onlyatlas_workspace_list
List every intra-tenant Workspace (Programs, Marketing, R&D) in the calling tenant. Cached with a 120s TTL so high-frequency callers do not stampede the DB.
- Scope
workspace:read- Calls
- Example prompt
- List the workspaces in this tenant.
Arguments
This tool takes no arguments.
Get workspace members about
Read onlyatlas_workspace_members_about_get
Get a teammate's about block (bio + manager).
- Scope
profile:read- Calls
- GET /profile/{x}/about
- Example prompt
- Show me usr_xyz's bio.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | User id (e.g. usr_...). |
List workspace members direct reports
Read onlyatlas_workspace_members_direct_reports_list
List a user's direct reports, one page at a time; pass the nextCursor of a page as cursor to read the next one.
- Scope
profile:read- Calls
- GET /profile/{x}/direct-reports
- Example prompt
- Who reports to usr_xyz?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | User id (e.g. usr_...). |
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "name" | "createdAt" | No | The field to sort on: name, createdAt. name by default. |
order | "asc" | "desc" | No | asc or desc. asc by default. |
Get workspace members manager chain
Read onlyatlas_workspace_members_manager_chain_get
Get the calling-user-visible upward chain of managers from a user.
- Scope
profile:read- Calls
- GET /profile/{x}/manager-chain
- Example prompt
- Who does usr_xyz report up to?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | User id (e.g. usr_...). |
Get workspace members profile extras
Read onlyatlas_workspace_members_profile_extras_get
Get a teammate's profile extras.
- Scope
profile:read- Calls
- GET /profile/{x}/extras
- Example prompt
- What's usr_xyz's job title?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | User id (e.g. usr_...). |
Get workspace org chart
Read onlyatlas_workspace_org_chart_get
Get the tenant-wide org chart (everyone visible to the calling user).
- Scope
profile:read- Calls
- GET /profile/org-chart
- Example prompt
- Show me the Atlas org chart.
Arguments
This tool takes no arguments.
Get workspace rate limit tier
Read onlyatlas_workspace_rate_limit_tier_get
Return the calling tenant's public-API rate-limit tier (free / pro / enterprise), the per-class ceilings (read / write / ai), the full catalog of upgrade tiers, and a rolling 60-minute per-minute usage histogram for each class. Use this to detect proximity to the cap before issuing a large fan-out call so the assistant can throttle or warn instead of triggering 429s.
- Scope
workspace:read- Calls
- Example prompt
- Are we close to the rate limit on AI requests right now?
Arguments
This tool takes no arguments.
Get workspace rate limit usage
Read onlyatlas_workspace_rate_limit_usage_get
Return the calling tenant's aggregated rate-limit analytics for the admin dashboard. Provides a day-by-day request + throttled trend (default 7 days, max 90), the top throttled endpoint classes ranked by absolute 429 count, the current-period quota saturation per class, and an upgrade-suggestion string when sustained throttling crosses the 5% threshold. Owner/Admin only.
- Scope
workspace:read- Calls
- Example prompt
- Show me how many 429s we hit in the last week, broken down by class.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
windowDays | integer | No |
List workspace role bundle templates
Read onlyatlas_workspace_role_bundle_templates_list
List the governance bundle templates a custom role can be started from. Returns { templates }, where each template has an id, a label, a description and the capabilities it grants. The templates are fixed and read only. Use this to explain what a template would grant before a person creates a role from it.
- Scope
workspace:read- Calls
- Example prompt
- Which role templates can I start a custom role from, and what does each one grant?
Arguments
This tool takes no arguments.