Update an Organization | Astronomer Documentation

curl -X POST https://api.astronomer.io/platform/v1beta1/organizations/organizationId \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "billingEmail": "billing@company.com",
  "isScimEnabled": false,
  "name": "My Organization"
}'

{
  "allowEnhancedSupportAccess": true,
  "createdAt": "2022-11-22T04:37:12Z",
  "createdBy": {
    "id": "clm8qv74h000008mlf08scq7k",
    "apiTokenName": "my-token",
    "avatarUrl": "https://avatar.url",
    "fullName": "Jane Doe",
    "subjectType": "USER",
    "username": "user1@company.com"
  },
  "id": "clmaxoarx000008l2c5ayb9pt",
  "isScimEnabled": false,
  "name": "My organization",
  "supportPlan": "BUSINESS_CRITICAL",
  "updatedAt": "2022-11-22T04:37:12Z",
  "updatedBy": {
    "id": "clm8qv74h000008mlf08scq7k",
    "apiTokenName": "my-token",
    "avatarUrl": "https://avatar.url",
    "fullName": "Jane Doe",
    "subjectType": "USER",
    "username": "user1@company.com"
  },
  "billingEmail": "billing@company.com",
  "managedDomains": [
    {
      "createdAt": "2024-01-15T09:30:00Z",
      "id": "cln203mz7000008jv0jyz9m3y",
      "name": "mycompany.com",
      "organizationId": "cln204xr2000008mu3hhe3zwe",
      "status": "PENDING",
      "updatedAt": "2024-01-15T09:30:00Z",
      "enforcedLogins": [
        "password"
      ]
    }
  ],
  "paymentMethod": "CREDIT_CARD",
  "product": "HOSTED",
  "productPlans": [
    {
      "astronomerProduct": "ASTRO",
      "organizationId": "string",
      "productPlanId": "string",
      "productPlanName": "string"
    }
  ],
  "status": "ACTIVE",
  "trialExpiresAt": "2022-11-22T04:37:12Z"
}

Update an Organization's details.

curl -X POST https://api.astronomer.io/platform/v1beta1/organizations/organizationId \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "billingEmail": "billing@company.com",
  "isScimEnabled": false,
  "name": "My Organization"
}'

{
  "allowEnhancedSupportAccess": true,
  "createdAt": "2022-11-22T04:37:12Z",
  "createdBy": {
    "id": "clm8qv74h000008mlf08scq7k",
    "apiTokenName": "my-token",
    "avatarUrl": "https://avatar.url",
    "fullName": "Jane Doe",
    "subjectType": "USER",
    "username": "user1@company.com"
  },
  "id": "clmaxoarx000008l2c5ayb9pt",
  "isScimEnabled": false,
  "name": "My organization",
  "supportPlan": "BUSINESS_CRITICAL",
  "updatedAt": "2022-11-22T04:37:12Z",
  "updatedBy": {
    "id": "clm8qv74h000008mlf08scq7k",
    "apiTokenName": "my-token",
    "avatarUrl": "https://avatar.url",
    "fullName": "Jane Doe",
    "subjectType": "USER",
    "username": "user1@company.com"
  },
  "billingEmail": "billing@company.com",
  "managedDomains": [
    {
      "createdAt": "2024-01-15T09:30:00Z",
      "id": "cln203mz7000008jv0jyz9m3y",
      "name": "mycompany.com",
      "organizationId": "cln204xr2000008mu3hhe3zwe",
      "status": "PENDING",
      "updatedAt": "2024-01-15T09:30:00Z",
      "enforcedLogins": [
        "password"
      ]
    }
  ],
  "paymentMethod": "CREDIT_CARD",
  "product": "HOSTED",
  "productPlans": [
    {
      "astronomerProduct": "ASTRO",
      "organizationId": "string",
      "productPlanId": "string",
      "productPlanName": "string"
    }
  ],
  "status": "ACTIVE",
  "trialExpiresAt": "2022-11-22T04:37:12Z"
}

Update an Organization's details.

Authentication

AuthorizationBearer

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

Path parameters

organizationIdstringRequired

The Organization's ID.

Request

The request body for updating the Organization.

billingEmailstringRequired

The Organization's billing email.

isScimEnabledbooleanRequired

Whether SCIM is enabled for the Organization.

namestringRequired<=50 characters

The name of the Organization.

allowEnhancedSupportAccessbooleanOptional

Response

allowEnhancedSupportAccessboolean

Whether the organization allows CRE to have view access to their entities

createdAtstringformat: "date-time"

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

createdByobject

idstring

The Organization's ID.

isScimEnabledboolean

Whether SCIM is enabled for the Organization.

namestring

The Organization's name.

supportPlanenum

The Organization's support plan.

updatedAtstringformat: "date-time"

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

updatedByobject

billingEmailstring

The Organization's billing email.

managedDomainslist of objects

The list of managed domains configured in the Organization.

paymentMethodenum

The Organization's payment method.

productenum

The Organization's product type.

Allowed values:

productPlanslist of objects

statusenum

The Organization's status.

Allowed values:

trialExpiresAtstringformat: "date-time"

The time when the Organization’s trial expires in UTC, formatted as YYYY-MM-DDTHH:MM:SSZ. Organizations that are no longer in Trial will not have a expiry date.

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/platform/v1beta1/organizations/organizationId \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"billingEmail": "billing@company.com",
>	"isScimEnabled": false,
>	"name": "My Organization"
>	}'

1	{
2	"allowEnhancedSupportAccess": true,
3	"createdAt": "2022-11-22T04:37:12Z",
4	"createdBy": {
5	"id": "clm8qv74h000008mlf08scq7k",
6	"apiTokenName": "my-token",
7	"avatarUrl": "https://avatar.url",
8	"fullName": "Jane Doe",
9	"subjectType": "USER",
10	"username": "user1@company.com"
11	},
12	"id": "clmaxoarx000008l2c5ayb9pt",
13	"isScimEnabled": false,
14	"name": "My organization",
15	"supportPlan": "BUSINESS_CRITICAL",
16	"updatedAt": "2022-11-22T04:37:12Z",
17	"updatedBy": {
18	"id": "clm8qv74h000008mlf08scq7k",
19	"apiTokenName": "my-token",
20	"avatarUrl": "https://avatar.url",
21	"fullName": "Jane Doe",
22	"subjectType": "USER",
23	"username": "user1@company.com"
24	},
25	"billingEmail": "billing@company.com",
26	"managedDomains": [
27	{
28	"createdAt": "2024-01-15T09:30:00Z",
29	"id": "cln203mz7000008jv0jyz9m3y",
30	"name": "mycompany.com",
31	"organizationId": "cln204xr2000008mu3hhe3zwe",
32	"status": "PENDING",
33	"updatedAt": "2024-01-15T09:30:00Z",
34	"enforcedLogins": [
35	"password"
36	]
37	}
38	],
39	"paymentMethod": "CREDIT_CARD",
40	"product": "HOSTED",
41	"productPlans": [
42	{
43	"astronomerProduct": "ASTRO",
44	"organizationId": "string",
45	"productPlanId": "string",
46	"productPlanName": "string"
47	}
48	],
49	"status": "ACTIVE",
50	"trialExpiresAt": "2022-11-22T04:37:12Z"
51	}