ATatlassian

Get tenant usage information

Changed on

Retrieves comprehensive usage statistics for the current tenant including total object counts and a per-schema breakdown for billing and analytics.

get/usage

Request

  • Base URL
    https://api.atlassian.com/ex/jira/{cloudId}/jsm/assets/workspace/workspaceId/v1
  • URL
    https://api.atlassian.com/ex/jira/{cloudId}/jsm/assets/workspace/workspaceId/v1/usage
  • Auth
    • OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: read:cmdb-config:jira
    • or HTTP bearer

Response

Tenant usage data retrieved successfully

totalObjectsCountinteger required

Total number of objects across all schemas in the tenant.

Example response

{
  "totalObjectsCount": 1234,
  "perSchemaUsageInfo": [
    {
      "schemaId": 1,
      "schemaName": "hardware-assets",
      "displayName": "Hardware Assets",
      "schemaCreatedAt": "2025-01-15T10:30:00Z",
      "objectCount": 567
    }
  ]
}

Changes

  • 83fc72ce3b1eRevision changes
    • info

      added the optional property // to the response with the status