Create a Team | Astronomer Documentation

Authentication

AuthorizationBearer

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

Path parameters

organizationIdstringRequired

The ID of the Organization where the Team is created.

Request

The request body for creating a Team.

namestringRequired

The Team's name.

descriptionstringOptional

The Team's description.

memberIdslist of stringsOptional

The list of IDs for users to add to the Team.

organizationRoleenumOptional

The Team's Organization role.

Allowed values:

Response

OK

createdAtstringformat: "date-time"

The time when the Team was created in UTC, formatted as YYYY-MM-DDTHH:MM:SSZ.

idstring

The Team's ID.

isIdpManagedboolean

Whether the Team is managed by an identity provider (IdP).

namestring

The Team's name.

organizationIdstring

The ID of the Organization to which the Team belongs.

organizationRoleenum

The Team's Organization role.

Allowed values:

updatedAtstringformat: "date-time"

The time when the Team was last updated in UTC, formatted as YYYY-MM-DDTHH:MM:SSZ.

createdByobject

dagRoleslist of objects

The Team's role in each DAG it belongs to.

deploymentRoleslist of objects

The Team's role in each Deployment it belongs to.

descriptionstring

The Team's description.

rolesCountinteger

The number of roles the Team has.

updatedByobject

workspaceRoleslist of objects

The Team's role in each Workspace it belongs to.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.astronomer.io/v1/organizations/organizationId/teams \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "My Team"
>	}'

1	{
2	"createdAt": "2022-11-22T04:37:12Z",
3	"id": "clma5ftgk000008mhgev00k7d",
4	"isIdpManaged": false,
5	"name": "My Team",
6	"organizationId": "clma5g8q6000108mh88g27k1y",
7	"organizationRole": "ORGANIZATION_MEMBER",
8	"updatedAt": "2022-11-22T04:37:12Z",
9	"createdBy": {
10	"id": "clm8qv74h000008mlf08scq7k",
11	"apiTokenName": "my-token",
12	"avatarUrl": "https://avatar.url",
13	"fullName": "Jane Doe",
14	"subjectType": "USER",
15	"username": "user1@company.com"
16	},
17	"dagRoles": [
18	{
19	"deploymentId": "clm8t5u4q000008jq4qoc3031",
20	"role": "DAG_VIEWER",
21	"dagId": "my_dag",
22	"dagTag": "team-a"
23	}
24	],
25	"deploymentRoles": [
26	{
27	"deploymentId": "clm8t5u4q000008jq4qoc3031",
28	"role": "DEPLOYMENT_ADMIN"
29	}
30	],
31	"description": "My Team description",
32	"rolesCount": 1,
33	"updatedBy": {
34	"id": "clm8qv74h000008mlf08scq7k",
35	"apiTokenName": "my-token",
36	"avatarUrl": "https://avatar.url",
37	"fullName": "Jane Doe",
38	"subjectType": "USER",
39	"username": "user1@company.com"
40	},
41	"workspaceRoles": [
42	{
43	"role": "WORKSPACE_MEMBER",
44	"workspaceId": "clm8t5u4q000008jq4qoc3036"
45	}
46	]
47	}