---
title: "Organization"
description: "Your account, and the boundary nothing crosses."
canonical_url: "https://twominutebilling.com/help/developers/api-reference/organization"
---
# Organization

> Your account, and the boundary nothing crosses.

Your account, and the boundary nothing crosses. An organization holds the API keys and owns every business under it; no request authenticated with your key can reach another organization's data, and nothing you create is visible outside it.

## Endpoints

<table>
<thead>
  <tr>
    <th>
      Method
    </th>
    
    <th>
      Endpoint
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/health-check">
        <code>
          /health
        </code>
      </a>
    </td>
    
    <td>
      Health check
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/liveness-probe">
        <code>
          /healthz
        </code>
      </a>
    </td>
    
    <td>
      Liveness probe
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/readiness-probe">
        <code>
          /readyz
        </code>
      </a>
    </td>
    
    <td>
      Readiness probe
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/list-api-keys">
        <code>
          /v1/api_keys
        </code>
      </a>
    </td>
    
    <td>
      List API keys
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/create-an-api-key">
        <code>
          /v1/api_keys
        </code>
      </a>
    </td>
    
    <td>
      Create an API key
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        PATCH
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/change-an-api-key-s-name-or-access">
        <code>
          /v1/api_keys/{id}
        </code>
      </a>
    </td>
    
    <td>
      Change an API key's name or access
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/revoke-an-api-key">
        <code>
          /v1/api_keys/{id}/revoke
        </code>
      </a>
    </td>
    
    <td>
      Revoke an API key
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/rotate-an-api-key">
        <code>
          /v1/api_keys/{id}/rotate
        </code>
      </a>
    </td>
    
    <td>
      Rotate an API key
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/list-audit-logs">
        <code>
          /v1/audit_logs
        </code>
      </a>
    </td>
    
    <td>
      List audit logs
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/business-home-analytics">
        <code>
          /v1/businesses/{biz}/analytics
        </code>
      </a>
    </td>
    
    <td>
      Business Home analytics
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/cancellations">
        <code>
          /v1/businesses/{biz}/cancellation_analytics
        </code>
      </a>
    </td>
    
    <td>
      Cancellations: what they cost, why, and who left
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/saas-metrics-for-a-business">
        <code>
          /v1/businesses/{biz}/metrics
        </code>
      </a>
    </td>
    
    <td>
      SaaS metrics for a business
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/payments-analytics">
        <code>
          /v1/businesses/{biz}/payments_analytics
        </code>
      </a>
    </td>
    
    <td>
      Payments analytics
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/the-authenticated-organization">
        <code>
          /v1/me
        </code>
      </a>
    </td>
    
    <td>
      The authenticated organization
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/org-wide-saas-metrics-roll-up">
        <code>
          /v1/metrics
        </code>
      </a>
    </td>
    
    <td>
      Org-wide SaaS metrics roll-up
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        PATCH
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/update-the-organization">
        <code>
          /v1/organization
        </code>
      </a>
    </td>
    
    <td>
      Update the organization
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/upload-the-organization-s-logo">
        <code>
          /v1/organization/brand_images
        </code>
      </a>
    </td>
    
    <td>
      Upload the organization's logo
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/list-the-permission-catalogue">
        <code>
          /v1/permissions
        </code>
      </a>
    </td>
    
    <td>
      List the permission catalogue
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/list-api-requests">
        <code>
          /v1/request_logs
        </code>
      </a>
    </td>
    
    <td>
      List API requests
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/get-one-api-request">
        <code>
          /v1/request_logs/{id}
        </code>
      </a>
    </td>
    
    <td>
      Get one API request
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/list-custom-roles">
        <code>
          /v1/roles
        </code>
      </a>
    </td>
    
    <td>
      List custom roles
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/create-a-custom-role">
        <code>
          /v1/roles
        </code>
      </a>
    </td>
    
    <td>
      Create a custom role
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/retrieve-a-custom-role">
        <code>
          /v1/roles/{id}
        </code>
      </a>
    </td>
    
    <td>
      Retrieve a custom role
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        PATCH
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/change-a-custom-role">
        <code>
          /v1/roles/{id}
        </code>
      </a>
    </td>
    
    <td>
      Change a custom role
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        DELETE
      </code>
    </td>
    
    <td>
      <a href="https://twominutebilling.com/help/developers/api-reference/organization/delete-a-custom-role">
        <code>
          /v1/roles/{id}
        </code>
      </a>
    </td>
    
    <td>
      Delete a custom role
    </td>
  </tr>
</tbody>
</table>


## Sitemap

See the full [sitemap](https://twominutebilling.com/sitemap.md) for all pages.
