Skip to navigation
SkillsPlatform operators

Simplified Workspace

Use this Simplified skill from a compatible connected assistant.
View as Markdown

Skill ID: simplified-workspace · Install skills · Canonical source

Try it

Which workspace am I connected to, and which teamspaces can I access?

The instructions below describe the workflow. Installed skills and connected tools are separate; use only operations exposed by your authorized connection.

Establish the correct Simplified identity and workspace context before operating on scoped resources. This operator resolves a teamspace once, then scopes every downstream MCP call explicitly.

Workflow

  1. Call api_getWorkspaceInfo for the authenticated user’s identity, current workspace, workspace settings, and visible active teamspaces. Its teamspaces field is context information, not membership authority.
  2. Call api_listTeamspaces to discover the current user’s accessible memberships, including all relevant pages. Use search for name matching and expand:"settings" when settings are needed. Return available teamspaces from this membership list, not from api_getWorkspaceInfo.teamspaces.
  3. If the user names a teamspace, search with api_listTeamspaces. Resolve to one exact numeric ID; do not guess when names or slugs are ambiguous.
  4. If deeper workspace metadata is material, call api_getWorkspace with the workspace integer ID returned by api_getWorkspaceInfo.
  5. When the user says “use,” “push this to,” “create in,” or “switch to” a teamspace, remember the resolved ID for the current task and pass space_id: <numeric_id> on every downstream Simplified tool call.
  6. State the applied context before the downstream workflow: user, workspace, teamspace name and ID, and settings that affect the work.
  7. Follow references/teamspace-context.md before handing off to another Simplified skill.

Identity and memory model

  • Treat api_getWorkspaceInfo as Simplified’s authoritative whoami; never infer identity from conversation memory.
  • A credential belongs to one workspace. Teamspaces are sub-spaces inside that workspace, not alternate workspaces.
  • Brand kits and their context documents are durable Simplified marketing memory. Workspace identity decides where that memory is read or written; this skill does not replace manage-brand.
  • Conversation memory is not proof that a remote workspace, teamspace, account, asset, brand kit, project, or draft still exists or remains accessible. Re-read context when the user changes client, workspace, or teamspace, or before a consequential write when context is uncertain.
  • Workspace timezone, language, and start of week guide planning. For social scheduling, inspect workspace settings and account metadata; the create tool accepts no timezone field. Canonical guidance identifies workspace timezone, but resolve conflicting service/account interpretation before converting a user-specified time. Disclose uncertainty rather than scheduling at an assumed time.

Teamspace safety

  • Teamspace IDs are integers. Never pass a name, slug, alias, or fabricated value where a numeric ID is required.
  • Hosted MCP scoping is stateless: space_id applies to one tool call. Carry the same resolved ID into every related read, write, poll, and follow-up call for the current task.
  • It is fine to tell the user “Using Acme East (42)” after resolution, but do not imply the server persisted a global teamspace:use session.
  • Do not reuse IDs for accounts, assets, brand kits, projects, items, drafts, or posts across teamspaces without re-listing them in the correctly scoped context.
  • Never omit space_id midway through a scoped workflow. An omitted value uses the configured inbound Space header or server fallback scope when present, otherwise the credential’s default workspace context. It does not reliably preserve the task’s explicitly selected teamspace.
  • On 403, report the denied operation and inspect whether access or permission is missing. On 400, read the actual validation error: it may concern a payload field rather than teamspace scope. Preserve the selected scope while correcting invalid fields. Never retry against a different space without the user’s direction.

Handoff contract

When another skill will continue the work, provide a compact context block:

  • authenticated user;
  • workspace name and integer ID;
  • requested teamspace name and integer ID, or default workspace context;
  • workspace timezone/language/start-of-week when relevant;
  • the space_id that every downstream Simplified call must carry.

Do not treat context resolution as permission to generate credits, edit brand memory, mutate projects, schedule, queue, or publish.