Anthropic Workspaces API

Create and manage workspaces within an organization

Documentation GitHub OpenAPI

Business capability

Tenant Provisioning & Lifecycle BC-4230.10

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /organizations/workspaces List the organization's workspaces · Anthropic List Workspaces #

Ask an LLM

“Which workspaces exist in my organization?”

“Can I include archived workspaces in the list?”

Tell an agent

List workspaces in my organization, archived included {include_archived}.

Show {limit} workspaces per page.

POST /organizations/workspaces Create a workspace · Anthropic Create Workspace #

Ask an LLM

“How do I add a new workspace to my organization?”

“What do I need to name a workspace when creating it?”

Tell an agent

Create a workspace called {name}.

Set up a new organization workspace named {name}.

GET /organizations/workspaces/{workspace_id} Get a workspace's details · Anthropic Get Workspace #

Ask an LLM

“What settings does a particular workspace have?”

“Can I look up one workspace by its ID?”

Tell an agent

Get workspace {workspace_id}.

Show the details of workspace {workspace_id}.

POST /organizations/workspaces/{workspace_id} Rename a workspace · Anthropic Update Workspace #

Ask an LLM

“How do I rename a workspace?”

“Can I change a workspace's configuration after it's created?”

Tell an agent

Rename workspace {workspace_id} to {name}.

Update workspace {workspace_id} so its name is {name}.

POST /organizations/workspaces/{workspace_id}/archive Archive a workspace and make it read-only · Anthropic Archive Workspace #

Ask an LLM

“What happens to a workspace when I archive it?”

“Is there a way to freeze a workspace so nothing new can be done in it?”

Tell an agent destructive · confirm first

Archive workspace {workspace_id}.

Make workspace {workspace_id} read-only by archiving it.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/anthropic:anthropic-workspaces-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Anthropic Admin Workspaces API
  description: Manage administrative functions for Anthropic organizations, workspaces, users, invites, and API keys.
  version: 1.0.0
  contact:
    name: Anthropic
    url: https://www.anthropic.com
    email: support@anthropic.com
  license:
    name: Anthropic API License
    url: https://www.anthropic.com/terms
servers:
- url: https://api.anthropic.com/v1
  description: Production Server
security:
- AdminApiKeyAuth: []
tags:
- name: Workspaces
  description: Create and manage workspaces within an organization
paths:
  /organizations/workspaces:
    get:
      summary: Anthropic List Workspaces
      description: Retrieves a paginated list of workspaces associated with the organization.
      operationId: listWorkspaces
      tags:
      - Workspaces
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/BeforeId'
      - $ref: '#/components/parameters/AfterId'
      - name: include_archived
        in: query
        required: false
        description: Whether to include archived workspaces in the response
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceList'
              examples:
                WorkspaceListExample:
                  $ref: '#/components/examples/WorkspaceListExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceListExample\"\n}\n"
    post:
      summary: Anthropic Create Workspace
      description: Creates a new workspace within the organization.
      operationId: createWorkspace
      tags:
      - Workspaces
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateWorkspaceRequest'
            examples:
              CreateWorkspaceRequestExample:
                $ref: '#/components/examples/CreateWorkspaceRequestExample'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
              examples:
                WorkspaceExample:
                  $ref: '#/components/examples/WorkspaceExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceExample\"\n}\n"
  /organizations/workspaces/{workspace_id}:
    get:
      summary: Anthropic Get Workspace
      description: Retrieves detailed information about a specific workspace.
      operationId: getWorkspace
      tags:
      - Workspaces
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/WorkspaceId'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
              examples:
                WorkspaceExample:
                  $ref: '#/components/examples/WorkspaceExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceExample\"\n}\n"
    post:
      summary: Anthropic Update Workspace
      description: Updates configuration for a specific workspace.
      operationId: updateWorkspace
      tags:
      - Workspaces
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/WorkspaceId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWorkspaceRequest'
            examples:
              UpdateWorkspaceRequestExample:
                $ref: '#/components/examples/UpdateWorkspaceRequestExample'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
              examples:
                WorkspaceExample:
                  $ref: '#/components/examples/WorkspaceExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"WorkspaceExample\"\n}\n"
  /organizations/workspaces/{workspace_id}/archive:
    post:
      summary: Anthropic Archive Workspace
      description: Archives a specific workspace, making it read-only.
      operationId: archiveWorkspace
      tags:
      - Workspaces
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/WorkspaceId'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
              examples:
                ArchivedWorkspaceExample:
                  $ref: '#/components/examples/ArchivedWorkspaceExample'
        4XX:
          $ref: '#/components/responses/ErrorResponse'
      x-microcks-operation:
        dispatcher: FALLBACK
        dispatcherRules: "{\n  \"dispatcher\": \"FALLBACK\",\n  \"fallback\": \"ArchivedWorkspaceExample\"\n}\n"
components:
  examples:
    ErrorExample:
      summary: Error Response
      value:
        type: invalid_request_error
        message: The request was invalid or malformed.
    WorkspaceExample:
      summary: Workspace Response
      value:
        id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
        type: workspace
        name: Engineering Team
        display_color: '#6C5BB9'
        created_at: '2024-10-30T23:58:27.427722Z'
        archived_at: null
    WorkspaceListExample:
      summary: Workspace List Response
      value:
        data:
        - id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
          type: workspace
          name: Engineering Team
          display_color: '#6C5BB9'
          created_at: '2024-10-30T23:58:27.427722Z'
          archived_at: null
        - id: wrkspc_02KxRvs8sQMB6BHy4ILGgGVK
          type: workspace
          name: Marketing Team
          display_color: '#4A90D9'
          created_at: '2024-09-15T14:20:00.000000Z'
          archived_at: null
        first_id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
        has_more: false
        last_id: wrkspc_02KxRvs8sQMB6BHy4ILGgGVK
    ArchivedWorkspaceExample:
      summary: Archived Workspace Response
      value:
        id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
        type: workspace
        name: Engineering Team
        display_color: '#6C5BB9'
        created_at: '2024-10-30T23:58:27.427722Z'
        archived_at: '2024-11-01T23:59:27.427722Z'
    UpdateWorkspaceRequestExample:
      summary: Update Workspace Request
      value:
        name: Engineering Team - Updated
    CreateWorkspaceRequestExample:
      summary: Create Workspace Request
      value:
        name: Engineering Team
  schemas:
    UpdateWorkspaceRequest:
      type: object
      required:
      - name
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 40
          description: Updated name for the workspace
    Workspace:
      type: object
      required:
      - id
      - type
      - name
      - created_at
      - archived_at
      - display_color
      properties:
        id:
          type: string
          description: Unique workspace identifier
        type:
          type: string
          enum:
          - workspace
          default: workspace
          description: Object type identifier
        name:
          type: string
          minLength: 1
          maxLength: 40
          description: Workspace name
        display_color:
          type: string
          description: Hex color code for UI display
        created_at:
          type: string
          format: date-time
          description: RFC 3339 datetime when workspace was created
        archived_at:
          type: string
          format: date-time
          nullable: true
          description: RFC 3339 datetime when workspace was archived, or null if active
    CreateWorkspaceRequest:
      type: object
      required:
      - name
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 40
          description: Name for the new workspace
    WorkspaceList:
      type: object
      required:
      - data
      - has_more
      - first_id
      - last_id
      properties:
        data:
          type: array
          description: List of workspaces
          items:
            $ref: '#/components/schemas/Workspace'
        first_id:
          type: string
          nullable: true
          description: First ID in the data list for pagination
        has_more:
          type: boolean
          description: Indicates if there are more results available
        last_id:
          type: string
          nullable: true
          description: Last ID in the data list for pagination
    Error:
      type: object
      required:
      - type
      - message
      properties:
        type:
          type: string
          description: Error type identifier
        message:
          type: string
          description: Human-readable error message
  parameters:
    WorkspaceId:
      name: workspace_id
      in: path
      required: true
      description: Unique identifier for the workspace
      schema:
        type: string
      example: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ
    BeforeId:
      name: before_id
      in: query
      required: false
      description: ID of the object to use as a cursor for pagination. Returns the page of results immediately before this object.
      schema:
        type: string
    Limit:
      name: limit
      in: query
      required: false
      description: Number of items to return per page. Defaults to 20. Ranges from 1 to 1000.
      schema:
        type: integer
        default: 20
        minimum: 1
        maximum: 1000
    AnthropicVersion:
      name: anthropic-version
      in: header
      required: true
      description: The version of the Anthropic API to use
      schema:
        type: string
        example: '2023-06-01'
    AfterId:
      name: after_id
      in: query
      required: false
      description: ID of the object to use as a cursor for pagination. Returns the page of results immediately after this object.
      schema:
        type: string
  responses:
    ErrorResponse:
      description: Error Response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            ErrorExample:
              $ref: '#/components/examples/ErrorExample'
  securitySchemes:
    AdminApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Admin API key for authentication (starts with sk-ant-admin...).

Anthropic Workspaces API

Operations 5

Documentation

Specifications

Schemas & Data

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification