> ## Documentation Index
> Fetch the complete documentation index at: https://developers.datagrid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create teamspace

> Create a new teamspace within your organization.



## OpenAPI

````yaml post /organization/teamspaces
openapi: 3.0.3
info:
  version: 0.1.1
  title: Datagrid API
  description: Datagrid API
servers:
  - url: https://api.datagrid.com/v1
security:
  - BearerAuth: []
paths:
  /organization/teamspaces:
    post:
      tags:
        - Teamspaces
      summary: Create teamspace
      description: Create a new teamspace within your organization.
      operationId: Teamspaces.createTeamspace
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
                - access
              properties:
                name:
                  type: string
                  description: The name of the teamspace
                  maxLength: 300
                access:
                  type: string
                  enum:
                    - open
                    - closed
                  description: >
                    Open teamspaces allow all organization members to join
                    without admin approval. Access for users who join this way
                    is limited to conversations with agents in this teamspace. 


                    Closed teamspaces require admin approval to join.
                cloud_provider:
                  type: string
                  nullable: true
                  enum:
                    - aws
                    - gcp
                  description: >-
                    Cloud provider for this teamspace. Determines storage
                    (S3/GCS) and model providers (Bedrock/Vertex). Immutable
                    after creation. Defaults to `gcp` if not specified.
      responses:
        '201':
          description: Successfully created teamspace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Teamspace'
        '429':
          description: >-
            Rate limit exceeded. The request has been throttled because the rate
            limit for this endpoint has been reached. Check the `Retry-After`
            response header and retry after the specified number of seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitError'
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import Datagrid from 'datagrid-ai';


            const client = new Datagrid({
              apiKey: process.env['DATAGRID_API_KEY'], // This is the default and can be omitted
            });


            const teamspace = await client.organization.teamspaces.create({
            access: 'open', name: 'name' });


            console.log(teamspace.id);
        - lang: Python
          source: |-
            import os
            from datagrid_ai import Datagrid

            client = Datagrid(
                api_key=os.environ.get("DATAGRID_API_KEY"),  # This is the default and can be omitted
            )
            teamspace = client.organization.teamspaces.create(
                access="open",
                name="name",
            )
            print(teamspace.id)
components:
  schemas:
    Teamspace:
      type: object
      required:
        - id
        - cloud_provider
      properties:
        id:
          type: string
        name:
          type: string
          description: The name of the teamspace
        access:
          type: string
          enum:
            - open
            - closed
          description: >
            Open teamspaces allow all organization members to join without admin
            approval. Access for users who join this way is limited to
            conversations with agents in this teamspace. 


            Closed teamspaces require admin approval to join.
        created_at:
          type: string
          format: date-time
          description: The ISO string for when the teamspace was created.
        cloud_provider:
          type: string
          enum:
            - aws
            - gcp
          description: >-
            Cloud provider for this teamspace. Determines storage platform
            (S3/GCS) and AI model providers (Bedrock/Vertex). Immutable after
            creation. Defaults to `gcp`.
    RateLimitError:
      type: object
      description: >-
        Returned when the rate limit is exceeded. Rate limits are enforced per
        teamspace, endpoint path, and HTTP method over a 60-second sliding
        window. Each endpoint may have its own limit — check the
        X-RateLimit-Limit response header for the effective value.
      required:
        - error
        - message
        - retryable
        - status_code
      properties:
        status_code:
          type: integer
          description: The HTTP status code (429).
        statusCode:
          type: integer
          deprecated: true
          description: Deprecated. Use status_code instead.
        error:
          type: string
          enum:
            - rate_limit_exceeded
          description: The error code identifying this as a rate limit error.
        message:
          type: string
          description: A human-readable error message.
        mitigation:
          type: string
          description: Suggested action to resolve the error.
        retryable:
          type: boolean
          description: Whether the request can be retried after a delay.
        details:
          type: object
          properties:
            reason:
              type: string
              description: A detailed explanation of why the rate limit was exceeded.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````