Workspace administration
Every Workspace administration tool, with the scope it needs, its arguments and the API operation it calls.
16 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
- 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
- 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.
Get workspace limits
Read onlyatlas_workspace_limits_get
Return the limits that apply to the calling workspace: requests a minute for reads, writes and AI calls, the monthly API call quota with the calls used this month and when the count starts again, the daily AI spend cap, and how webhooks are retried. Use it to pace a large job before it meets a 429.
- Scope
workspace:read- Calls
- Example prompt
- How many API calls do we have left this month?
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 is 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.