Billing

Gets the usage of a workspace

get

Get the usage data for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to get usage data for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

The usage of the workspace

application/json

has_payment_methodbooleanRequired

monthly_subscription_statusstring · nullableRequired

annual_subscription_statusstring · nullableRequired

creditsintegerRequired

404

Not found

422

Validation Error

application/json

get/billing/{workspace_id}/workspace-usage

HTTPcURLJavaScriptPython

GET /billing/{workspace_id}/workspace-usage HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "seats": {
    "used": 1,
    "included": 1,
    "enforced": true
  },
  "guests": {
    "used": 1,
    "included": 1,
    "enforced": true
  },
  "has_payment_method": true,
  "cloud_storage": {
    "free": 1,
    "paid": 1,
    "used": 1
  },
  "byo_storage": {
    "free": 1,
    "paid": 1,
    "used": 1
  },
  "vault_storage": {
    "free": 1,
    "paid": 1,
    "used": 1
  },
  "vault_byo_storage": {
    "free": 1,
    "paid": 1,
    "used": 1
  },
  "high_speed_storage": {
    "free": 1,
    "paid": 1,
    "used": 1
  },
  "drives": {
    "used": 1,
    "included": 1,
    "enforced": true
  },
  "ai_indexed_items": {
    "used": 1,
    "included": 1,
    "enforced": true
  },
  "cloud_drives": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "usage": 1
    }
  ],
  "byo_drives": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "usage": 1
    }
  ],
  "vault_drives": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "usage": 1
    }
  ],
  "vault_byo_drives": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "usage": 1
    }
  ],
  "high_speed_drives": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "usage": 1
    }
  ],
  "monthly_subscription_status": "text",
  "annual_subscription_status": "text",
  "credits": 1
}

Gets the usage of a drive

get

Get the usage data for a drive

Path parameters

drive_idstring · uuidRequired

The ID of the drive to get usage data for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

The usage of the drive

application/json

usagenumberRequired

total_storagenumberRequired

total_itemsintegerRequired

404

Not found

422

Validation Error

application/json

get/billing/{drive_id}/drive-usage

HTTPcURLJavaScriptPython

GET /billing/{drive_id}/drive-usage HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "types": [
    {
      "type": "IMAGE",
      "count": 1,
      "size": 1
    }
  ],
  "usage": 1,
  "total_storage": 1,
  "total_items": 1
}

Gets the usage of a workspace

get

Get the usage data for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to get usage data for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

The usage of the workspace

application/json

planstring · nullableRequired

plan_namestringRequired

seats_annualbooleanRequired

is_trialbooleanRequired

seatsintegerRequired

404

Not found

422

Validation Error

application/json

get/billing/{workspace_id}/usage

HTTPcURLJavaScriptPython

GET /billing/{workspace_id}/usage HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "billing": {
    "start_time": 1,
    "end_time": 1,
    "total_cloud_paid": 1,
    "total_vault_paid": 1,
    "total_byo_paid": 1,
    "total_vault_byo_paid": 1,
    "total_high_speed_paid": 1,
    "total_cloud_free": 1,
    "total_vault_free": 1,
    "total_byo_free": 1,
    "cloud_overage": 1,
    "byo_overage": 1,
    "vault_storage_overage": 1,
    "vault_byo_storage_overage": 1,
    "high_speed_storage_overage": 1
  },
  "plan": "text",
  "plan_name": "text",
  "seats_annual": true,
  "is_trial": true,
  "seats": 1
}

Gets the invoices for a workspace

get

Get the invoices for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to get invoices for

Query parameters

upcomingbooleanOptional

Whether to get the upcoming invoice

Default: false

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

The invoices of the workspace

application/json

total_amount_duenumberRequired

period_startintegerRequired

period_endintegerRequired

invoice_dateintegerRequired

paidbooleanRequired

invoice_pdfstringRequired

hosted_invoice_urlstringRequired

taxnumberRequired

subtotalnumberRequired

statusstringRequired

currencystringRequired

404

Not found

422

Validation Error

application/json

get/billing/{workspace_id}/invoices

HTTPcURLJavaScriptPython

GET /billing/{workspace_id}/invoices HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "total_amount_due": 1,
    "period_start": 1,
    "period_end": 1,
    "invoice_date": 1,
    "paid": true,
    "invoice_pdf": "text",
    "hosted_invoice_url": "text",
    "tax": 1,
    "subtotal": 1,
    "lines": [
      {
        "description": "text",
        "amount": 1,
        "quantity": 1,
        "unit_type": "text",
        "unit_amount": 1
      }
    ],
    "status": "text",
    "currency": "text"
  }
]

Update Payment Method

put

Update the payment method for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to update the payment method for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

payment_method_idstringRequired

The ID of the payment method to update to

is_firstboolean · nullableOptional

Whether this is the first added payment method (not updated later on)

Default: false

Responses

200

Successful Response

application/json

Other propertiesstringOptional

404

Not found

422

Validation Error

application/json

put/billing/{workspace_id}/payment-method

HTTPcURLJavaScriptPython

PUT /billing/{workspace_id}/payment-method HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 91

{
  "payment_method_id": "text",
  "is_first": false,
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Update Billing Address

put

Update the billing address for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to update the billing address for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

payment_method_idstringRequired

The ID of the payment method to update to

Responses

200

Successful Response

application/json

anyOptional

404

Not found

422

Validation Error

application/json

put/billing/{workspace_id}/billing-address

HTTPcURLJavaScriptPython

PUT /billing/{workspace_id}/billing-address HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 224

{
  "address": {
    "name": "text",
    "phone": "text",
    "address": {
      "line1": "text",
      "line2": "text",
      "city": "text",
      "state": "text",
      "postal_code": "text",
      "country": "text"
    }
  },
  "payment_method_id": "text",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Get Payment Methods

get

Get the payment methods for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to get the payment methods for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

Successful Response

application/json

idstringRequired

brandstringRequired

typestringRequired

last4stringRequired

exp_monthinteger · nullableRequired

exp_yearinteger · nullableRequired

fundingstring · nullableRequired

countrystringRequired

addressstringRequired

citystringRequired

statestringRequired

zipstringRequired

namestringRequired

404

Not found

422

Validation Error

application/json

get/billing/{workspace_id}/payment-methods

HTTPcURLJavaScriptPython

GET /billing/{workspace_id}/payment-methods HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "id": "text",
    "brand": "text",
    "type": "text",
    "last4": "text",
    "exp_month": 1,
    "exp_year": 1,
    "funding": "text",
    "country": "text",
    "address": "text",
    "city": "text",
    "state": "text",
    "zip": "text",
    "name": "text"
  }
]

Update Plan

put

Update the plan for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to update the plan for

Query parameters

price_idstringRequired

The ID of the price plan to update to

seatsinteger · nullableOptional

The number of seats to update to

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

Successful Response

application/json

anyOptional

404

Not found

422

Validation Error

application/json

put/billing/{workspace_id}/plan

HTTPcURLJavaScriptPython

PUT /billing/{workspace_id}/plan?price_id=text HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Get Current Invoice

get

Get the current invoice for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to get the current invoice for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

Successful Response

application/json

total_amount_duenumberRequired

period_startintegerRequired

period_endintegerRequired

invoice_dateintegerRequired

paidbooleanRequired

invoice_pdfstringRequired

hosted_invoice_urlstringRequired

taxnumberRequired

subtotalnumberRequired

statusstringRequired

currencystringRequired

404

Not found

422

Validation Error

application/json

get/billing/{workspace_id}/current-invoice

HTTPcURLJavaScriptPython

GET /billing/{workspace_id}/current-invoice HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "total_amount_due": 1,
  "period_start": 1,
  "period_end": 1,
  "invoice_date": 1,
  "paid": true,
  "invoice_pdf": "text",
  "hosted_invoice_url": "text",
  "tax": 1,
  "subtotal": 1,
  "lines": [
    {
      "description": "text",
      "amount": 1,
      "quantity": 1,
      "unit_type": "text",
      "unit_amount": 1
    }
  ],
  "status": "text",
  "currency": "text"
}

Get Upcoming Monthly Invoice

get

Get the upcoming monthly invoice for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to get the upcoming monthly invoice for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

Successful Response

application/json

total_amount_duenumberRequired

period_startintegerRequired

period_endintegerRequired

invoice_dateintegerRequired

paidbooleanRequired

invoice_pdfstringRequired

hosted_invoice_urlstringRequired

taxnumberRequired

subtotalnumberRequired

statusstringRequired

currencystringRequired

404

Not found

422

Validation Error

application/json

get/billing/{workspace_id}/upcoming-monthly-invoice

HTTPcURLJavaScriptPython

GET /billing/{workspace_id}/upcoming-monthly-invoice HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "total_amount_due": 1,
  "period_start": 1,
  "period_end": 1,
  "invoice_date": 1,
  "paid": true,
  "invoice_pdf": "text",
  "hosted_invoice_url": "text",
  "tax": 1,
  "subtotal": 1,
  "lines": [
    {
      "description": "text",
      "amount": 1,
      "quantity": 1,
      "unit_type": "text",
      "unit_amount": 1
    }
  ],
  "status": "text",
  "currency": "text"
}

Get Annual Subscriptions

get

Get the annual subscriptions for a workspace

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to get the annual subscriptions for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

Responses

200

Successful Response

application/json

anyOptional

404

Not found

422

Validation Error

application/json

get/billing/{workspace_id}/annual-subscriptions

HTTPcURLJavaScriptPython

GET /billing/{workspace_id}/annual-subscriptions HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content

Update Billing Email

put

Update the billing email for a workspace on stripe

Path parameters

workspace_idstring · uuidRequired

The ID of the workspace to update the billing email for

Header parameters

passwordstring · nullableOptional

The password header to use to fetch the preview

Body

application/json

emailstringRequired

The email to update the billing email to

Responses

200

Successful Response

application/json

anyOptional

404

Not found

422

Validation Error

application/json

put/billing/{workspace_id}/billing-email

HTTPcURLJavaScriptPython

PUT /billing/{workspace_id}/billing-email HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "email": "text",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

No content