Organizations

Endpointhttps://app.monad.com/api

Download schema

Organization management endpoints

List organizations for user

GET

https://app.monad.com/api

/v1/organizations

Authorization (header)

x-api-key (header)

List organizations for user

List organizations for user › query Parameters

limit

integer

Limit the number of organizations returned (default: 10)

offset

integer

Offset the organizations returned (default: 0)

no_children

boolean

If true, only return organizations that are directly associated with the user, not child organizations (default: false)

parent_organization_id

string

If provided, only return organizations that are children of the specified parent organization

name_search

string

If provided, only return organizations with names that contain the search string

List organizations for user › Responses

200

Response body for listing organizations

object[]

object

Create organization

POST

https://app.monad.com/api

/v1/organizations

Authorization (header)

x-api-key (header)

Create organization

Create organization › Request Body

Request body for creating an organization

name

string · required

billing_account_id

string

description

string

friendly_name

string

Create organization › Responses

200

Response body for creating an organization

billing_account_id

string

connection_id

string

created_at

string

description

string

friendly_name

string

id

string

name

string

parent_organization_id

string

updated_at

string

POST/v1/organizations

curl --request POST \
  --url https://app.monad.com/api/v1/organizations \
  --header 'Content-Type: application/json' \
  --data '
{
  "billing_account_id": "billing_account_id",
  "description": "description",
  "friendly_name": "friendly_name",
  "name": "name"
}
'

shell

Example Request Body

{
  "billing_account_id": "billing_account_id",
  "description": "description",
  "friendly_name": "friendly_name",
  "name": "name"
}

json

Example Responses

{
  "billing_account_id": "billing_account_id",
  "connection_id": "connection_id",
  "created_at": "created_at",
  "description": "description",
  "friendly_name": "friendly_name",
  "id": "id",
  "name": "name",
  "parent_organization_id": "parent_organization_id",
  "updated_at": "updated_at"
}

json

application/json

Delete organization

DELETE

https://app.monad.com/api

/v1/organizations/{organization_id}

Authorization (header)

x-api-key (header)

Delete organization

Delete organization › path Parameters

organization_id

string · required

Organization ID

Delete organization › Responses

200

Update organization

PATCH

https://app.monad.com/api

/v1/organizations/{organization_id}

Authorization (header)

x-api-key (header)

Update organization

Update organization › path Parameters

organization_id

string · required

Organization ID

Update organization › Request Body

Request body for updating an organization

friendly_name

string · required

description

string

Update organization › Responses

200

Response body for updating an organization

billing_account_id

string

connection_id

string

created_at

string

description

string

friendly_name

string

id

string

name

string

parent_organization_id

string

updated_at

string

Get storage type cost summary by type

GET

https://app.monad.com/api

/v2/{organization_id}/metrics/storage-types/{storage_type}/summary

Authorization (header)

x-api-key (header)

Get aggregated cost and usage summary for a specific storage type

Get storage type cost summary by type › path Parameters

organization_id

string · required

Organization ID

storage_type

string · required

Storage type (e.g., s3, dev-null, bigquery)

Get storage type cost summary by type › query Parameters

start

string

ISO3339 start time, default 6 hours ago

end

string

ISO3339 end time, default now

billing_type

string

Filter by billing type (billable|non_billable)

pipeline_id

string

Filter to specific pipeline

Get storage type cost summary by type › Responses

Storage type cost summary

object

end_at

string

organization_id

string

organization_name

string

object

start_at

string

GET/v2/{organization_id}/metrics/storage-types/{storage_type}/summary

curl --request GET \
  --url https://app.monad.com/api/v2/:organization_id/metrics/storage-types/:storage_type/summary

shell

Example Responses

{
  "cost_summary": {
    "total_org_cost_post_filter": 0,
    "total_org_cost_pre_filter": 0,
    "total_org_ingest_bytes": 0,
    "total_org_ingest_gb": 0,
    "total_org_output_storage_bytes": 0,
    "total_org_output_storage_gb": 0
  },
  "end_at": "end_at",
  "organization_id": "organization_id",
  "organization_name": "organization_name",
  "outputs": {
    "key": {
      "cost_id": "cost_id",
      "cost_per_gb": 0,
      "egress_bytes": 0,
      "egress_bytes_gb": 0,
      "num_pipelines": 0,
      "pre_filter_bytes": 0,
      "pre_filter_bytes_gb": 0,
      "total_cost_post_filter": 0,
      "total_cost_pre_filter": 0
    }
  },
  "start_at": "start_at"
}

json

application/json

List child organizations (teams)

GET

https://app.monad.com/api

/v3/{organization_id}/organizations

Authorization (header)

x-api-key (header)

List child organizations for the given parent organization. These are surfaced as "teams" in the UI.

List child organizations (teams) › path Parameters

organization_id

string · required

Parent Organization ID

List child organizations (teams) › query Parameters

limit

integer

Limit the number of organizations returned (default: 10)

offset

integer

Offset the organizations returned (default: 0)

name_search

string

If provided, only return organizations with names that contain the search string

List child organizations (teams) › Responses

List of child organizations

object[]

object

Create child organization (team)

POST

https://app.monad.com/api

/v3/{organization_id}/organizations

Authorization (header)

x-api-key (header)

Create a new child organization under the given parent organization. Known as a "team" in the UI.

Create child organization (team) › path Parameters

organization_id

string · required

Parent Organization ID

Create child organization (team) › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: name

Properties for Variant 1:

Create child organization (team) › Responses

Created child organization

billing_account_id

string

connection_id

string

created_at

string

description

string

friendly_name

string

id

string

name

string

parent_organization_id

string

updated_at

string

Delete child organization (team)

DELETE

https://app.monad.com/api

/v3/{organization_id}/organizations/{child_organization_id}

Authorization (header)

x-api-key (header)

Delete a child organization under the given parent organization. Known as a "team" in the UI.

Delete child organization (team) › path Parameters

organization_id

string · required

Parent Organization ID

child_organization_id

string · required

Child Organization ID

Delete child organization (team) › Responses

Child organization deleted successfully

No data returned

Update child organization (team)

PATCH

https://app.monad.com/api

/v3/{organization_id}/organizations/{child_organization_id}

Authorization (header)

x-api-key (header)

Update a child organization under the given parent organization. Known as a "team" in the UI.

Update child organization (team) › path Parameters

organization_id

string · required

Parent Organization ID

child_organization_id

string · required

Child Organization ID

Update child organization (team) › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: friendly_name

Properties for Variant 1:

Update child organization (team) › Responses

Updated child organization

billing_account_id

string

connection_id

string

created_at

string

description

string

friendly_name

string

id

string

name

string

parent_organization_id

string

updated_at

string

Users Organization Users

Monad API

Organizations

Endpointhttps://app.monad.com/api

Download schema

Organization management endpoints

List organizations for user

GET

https://app.monad.com/api

/v1/organizations

Authorization (header)

x-api-key (header)

List organizations for user

List organizations for user › query Parameters

limit

integer

Limit the number of organizations returned (default: 10)

offset

integer

Offset the organizations returned (default: 0)

no_children

boolean

If true, only return organizations that are directly associated with the user, not child organizations (default: false)

parent_organization_id

string

If provided, only return organizations that are children of the specified parent organization

name_search

string

If provided, only return organizations with names that contain the search string

List organizations for user › Responses

200

Response body for listing organizations

object[]

object

Create organization

POST

https://app.monad.com/api

/v1/organizations

Authorization (header)

x-api-key (header)

Create organization

Create organization › Request Body

Request body for creating an organization

name

string · required

billing_account_id

string

description

string

friendly_name

string

Create organization › Responses

200

Response body for creating an organization

billing_account_id

string

connection_id

string

created_at

string

description

string

friendly_name

string

id

string

name

string

parent_organization_id

string

updated_at

string

POST/v1/organizations

curl --request POST \
  --url https://app.monad.com/api/v1/organizations \
  --header 'Content-Type: application/json' \
  --data '
{
  "billing_account_id": "billing_account_id",
  "description": "description",
  "friendly_name": "friendly_name",
  "name": "name"
}
'

shell

Example Request Body

{
  "billing_account_id": "billing_account_id",
  "description": "description",
  "friendly_name": "friendly_name",
  "name": "name"
}

json

Example Responses

{
  "billing_account_id": "billing_account_id",
  "connection_id": "connection_id",
  "created_at": "created_at",
  "description": "description",
  "friendly_name": "friendly_name",
  "id": "id",
  "name": "name",
  "parent_organization_id": "parent_organization_id",
  "updated_at": "updated_at"
}

json

application/json

Delete organization

DELETE

https://app.monad.com/api

/v1/organizations/{organization_id}

Authorization (header)

x-api-key (header)

Delete organization

Delete organization › path Parameters

organization_id

string · required

Organization ID

Delete organization › Responses

200

Update organization

PATCH

https://app.monad.com/api

/v1/organizations/{organization_id}

Authorization (header)

x-api-key (header)

Update organization

Update organization › path Parameters

organization_id

string · required

Organization ID

Update organization › Request Body

Request body for updating an organization

friendly_name

string · required

description

string

Update organization › Responses

200

Response body for updating an organization

billing_account_id

string

connection_id

string

created_at

string

description

string

friendly_name

string

id

string

name

string

parent_organization_id

string

updated_at

string

Get storage type cost summary by type

GET

https://app.monad.com/api

/v2/{organization_id}/metrics/storage-types/{storage_type}/summary

Authorization (header)

x-api-key (header)

Get aggregated cost and usage summary for a specific storage type

Get storage type cost summary by type › path Parameters

organization_id

string · required

Organization ID

storage_type

string · required

Storage type (e.g., s3, dev-null, bigquery)

Get storage type cost summary by type › query Parameters

start

string

ISO3339 start time, default 6 hours ago

end

string

ISO3339 end time, default now

billing_type

string

Filter by billing type (billable|non_billable)

pipeline_id

string

Filter to specific pipeline

Get storage type cost summary by type › Responses

Storage type cost summary

object

end_at

string

organization_id

string

organization_name

string

object

start_at

string

GET/v2/{organization_id}/metrics/storage-types/{storage_type}/summary

curl --request GET \
  --url https://app.monad.com/api/v2/:organization_id/metrics/storage-types/:storage_type/summary

shell

Example Responses

{
  "cost_summary": {
    "total_org_cost_post_filter": 0,
    "total_org_cost_pre_filter": 0,
    "total_org_ingest_bytes": 0,
    "total_org_ingest_gb": 0,
    "total_org_output_storage_bytes": 0,
    "total_org_output_storage_gb": 0
  },
  "end_at": "end_at",
  "organization_id": "organization_id",
  "organization_name": "organization_name",
  "outputs": {
    "key": {
      "cost_id": "cost_id",
      "cost_per_gb": 0,
      "egress_bytes": 0,
      "egress_bytes_gb": 0,
      "num_pipelines": 0,
      "pre_filter_bytes": 0,
      "pre_filter_bytes_gb": 0,
      "total_cost_post_filter": 0,
      "total_cost_pre_filter": 0
    }
  },
  "start_at": "start_at"
}

json

application/json

List child organizations (teams)

GET

https://app.monad.com/api

/v3/{organization_id}/organizations

Authorization (header)

x-api-key (header)

List child organizations for the given parent organization. These are surfaced as "teams" in the UI.

List child organizations (teams) › path Parameters

organization_id

string · required

Parent Organization ID

List child organizations (teams) › query Parameters

limit

integer

Limit the number of organizations returned (default: 10)

offset

integer

Offset the organizations returned (default: 0)

name_search

string

If provided, only return organizations with names that contain the search string

List child organizations (teams) › Responses

List of child organizations

object[]

object

Create child organization (team)

POST

https://app.monad.com/api

/v3/{organization_id}/organizations

Authorization (header)

x-api-key (header)

Create a new child organization under the given parent organization. Known as a "team" in the UI.

Create child organization (team) › path Parameters

organization_id

string · required

Parent Organization ID

Create child organization (team) › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: name

Properties for Variant 1:

Create child organization (team) › Responses

Created child organization

billing_account_id

string

connection_id

string

created_at

string

description

string

friendly_name

string

id

string

name

string

parent_organization_id

string

updated_at

string

Delete child organization (team)

DELETE

https://app.monad.com/api

/v3/{organization_id}/organizations/{child_organization_id}

Authorization (header)

x-api-key (header)

Delete a child organization under the given parent organization. Known as a "team" in the UI.

Delete child organization (team) › path Parameters

organization_id

string · required

Parent Organization ID

child_organization_id

string · required

Child Organization ID

Delete child organization (team) › Responses

Child organization deleted successfully

No data returned

Update child organization (team)

PATCH

https://app.monad.com/api

/v3/{organization_id}/organizations/{child_organization_id}

Authorization (header)

x-api-key (header)

Update a child organization under the given parent organization. Known as a "team" in the UI.

Update child organization (team) › path Parameters

organization_id

string · required

Parent Organization ID

child_organization_id

string · required

Child Organization ID

Update child organization (team) › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: friendly_name

Properties for Variant 1:

Update child organization (team) › Responses

Updated child organization

billing_account_id

string

connection_id

string

created_at

string

description

string

friendly_name

string

id

string

name

string

parent_organization_id

string

updated_at

string

Users Organization Users