> ## 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.

# Retrieve teamspace

> Retrieve a specific teamspace by ID.



## OpenAPI

````yaml get /organization/teamspaces/{teamspace_id}
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/{teamspace_id}:
    get:
      tags:
        - Teamspaces
      summary: Retrieve teamspace
      description: Retrieve a specific teamspace by ID.
      operationId: Teamspaces.retrieveTeamspace
      parameters:
        - name: teamspace_id
          in: path
          required: true
          schema:
            type: string
          description: The ID of the teamspace to retrieve.
      responses:
        '200':
          description: Successfully retrieved teamspace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Teamspace'
        '404':
          description: >-
            Not found. The requested teamspace does not exist, or the
            authenticated user does not have permission to access it.
        '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.retrieve('teamspace_id');


            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.retrieve(
                "teamspace_id",
            )
            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

````