Skip to main content
POST
/
organization
/
teamspaces
Python
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)
{
  "id": "<string>",
  "cloud_provider": "aws",
  "name": "<string>",
  "access": "open",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

The name of the teamspace

Maximum string length: 300
​
access
enum<string>
required

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.

Available options:
open,
closed
​
cloud_provider
enum<string> | null

Cloud provider for this teamspace. Determines storage (S3/GCS) and model providers (Bedrock/Vertex). Immutable after creation. Defaults to gcp if not specified.

Available options:
aws,
gcp

Response

Successfully created teamspace

​
id
string
required
​
cloud_provider
enum<string>
required

Cloud provider for this teamspace. Determines storage platform (S3/GCS) and AI model providers (Bedrock/Vertex). Immutable after creation. Defaults to gcp.

Available options:
aws,
gcp
​
name
string

The name of the teamspace

​
access
enum<string>

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.

Available options:
open,
closed
​
created_at
string<date-time>

The ISO string for when the teamspace was created.