Guides

External APIs 4.5 (2404.1)

Released March 2025

Changelog

What's Changed

  1. GET/compliance/{tenant_id}/assessment_history/list List Compliance Control Assessment History
  • Return Type
    • Change assessment_history.assessment_status (Added Enum)

What's Coming in the Next Release (2501)?

What's Changing:

Changelog

  1. GET/cost/markups_and_discounts/{tenant_id}/list List Cost Markup Rules
    • Return Type

      • Change rule_type (Added Enum)
  2. POST/cost_anomaly/billing_cost_anomaly Get Account wise daily Billing Cost Anomaly
    • Parameter

      • Add CostAnomalySummaryRequest.service_account_ids//Service Account IDs
      • Add CostAnomalySummaryRequest.filters//Query expression to filter line items
      • Add CostAnomalySummaryRequest.anomaly_status//Required Anomaly status
      • DeleteCostAnomalySummaryRequest.filter
      • DeleteCostAnomalySummaryRequest.currency//currency of the cost. Example 'currency':'USD'
    • Return Type

      • Add details.categories//categories wise daily cost anomaly summary
      • Add details.service_account_level_anomalies.reject_until//Rejected Until time for the anomaly
      • Add details.service_account_level_anomalies.reject_reason//Rejected Reason
      • Deletedetails.product_categories//Product category wise daily cost anomaly summary
      • Change details.bill_date
  3. GET/tenants List Tenant
    • Return Type

      • Add tenants.fiscal_year_configuration//Fiscal Year settings
      • Add tenants.cost_anomaly_settings
      • Add tenants.azure_hybrid_benefits_enabled//azure hybrid benefits enabled under finOps
  4. PUT/tenants/{tenant_id} Update Tenant
    • Parameter

      • Add UpdateTenantRequest.fiscal_year_configuration//Fiscal Year settings
      • Add UpdateTenantRequest.cost_anomaly_settings
      • Add UpdateTenantRequest.azure_hybrid_benefits_enabled//azure hybrid benefits enabled under finOps
  5. GET/users/filter-options List Users
    • Return Type

      • Add tenants.tags//List of tag key/value pairs
      • Add tenants.cloud_providers.cloud_accounts.tags//List of tag key/value pairs
      • Deleteproduct_categories
      • Deleteregions
  6. POST/v1/executive_dashboard_version/parseImport Parse Dashboard Definition Version
    • Return Type

      • Add flavor//Flavor of the dashboard
      • Add cloud//Cloud provider for the dashboard. If not specified, the dashboard is considered multi-cloud.
      • Add filterScope//Scope for the data available in the dashboard
      • Add savedViews
  7. GET/v1/feature_requirements/list List Feature requirements
    • Return Type

      • Change feature (Added Enum)
      • Change providers.mandatory_dependent_features
      • Change providers.optional_dependent_features
      • Change providers.ondemand_dependent_features
  8. POST/v1/master_accounts
    • Parameter

      • Add CreateMasterAccountRequest.fiscal_year_configuration//Fiscal Year settings
  9. GET/v1/master_accounts/item/{master_account_id} Master Account View
    • Return Type

      • Add fiscal_year_configuration//Fiscal Year settings
      • Add cost_anomaly_settings
  10. PUT/v1/master_accounts/item/{master_account_id} Master Account Update
    • Parameter

      • Add MasterAccountDetails.fiscal_year_configuration//Fiscal Year settings
      • Add MasterAccountDetails.cost_anomaly_settings
    • Return Type

      • Add fiscal_year_configuration//Fiscal Year settings
      • Add cost_anomaly_settings
  11. GET/v1/products/list List Products
    • Return Type

      • Change features
  12. GET/v1/role_templates/list List Role Templates
    • Return Type

      • Change policies.policy (Added Enum)
  13. POST/v1/schedules/list List Schedules of given category
    • Parameter

      • Change ScheduleListRequest.sort.column (Added Enum)
  14. POST/v1/tag_posture/snapshot/item/{snapshot_id}/resource_summary Summarize the tag posture matching the filtering criteria returning resource coverage counts
    • Return Type

      • Add missing_tag_keys//List of missing tag keys
      • Add invalid_tag_values//Map of invalid tag values
  15. POST/v2/audit/auditlog/list Audit List
    • Parameter

      • Change AuditLogListRequest.filters.event_types
  16. POST/v2/service_account/create Create a new Service Account
    • Parameter

      • Change ServiceAccountDetails.onboarded_features.feature (Added Enum)
  17. POST/v2/service_account/item/{service_account_id} Update Service Account details
    • Parameter

      • Change ServiceAccountDetails.onboarded_features.feature (Added Enum)
    • Return Type

      • Change onboarded_features.feature (Added Enum)
  18. GET/v2/service_account/item/{service_account_id} Get Service Account details
    • Return Type

      • Change onboarded_features.feature (Added Enum)
  19. GET/v2/service_account/item/{service_account_id}/credentials_validation Validate Service Account Credentials
    • Return Type

      • Change onboarded_features.feature (Added Enum)
  20. POST/v2/service_account/item/{service_account_id}/dry_run Validate update of Service Account details
    • Parameter

      • Change ServiceAccountDetails.onboarded_features.feature (Added Enum)
    • Return Type

      • Change onboarded_features.feature (Added Enum)
  21. POST/v2/service_account/item/{service_account_id}/extended_dry_run Validate update of Service Account details and check if the Governance Configuration can be accepted by the Cloud/Tool provider
    • Parameter

      • Change ServiceAccountDetails.onboarded_features.feature (Added Enum)
    • Return Type

      • Change onboarded_features.feature (Added Enum)
  22. POST/v2/service_account/item/{service_account_id}/sync_status Trigger refresh of Sync Status
    • Parameter

      • Add ServiceAccountSync.finops__enterprise_discount_program//Enterprise Discount Program current status
    • Return Type

      • Add finops__enterprise_discount_program//Enterprise Discount Program current status
  23. GET/v2/service_account/item/{service_account_id}/sync_status Get Current Sync Status
    • Return Type

      • Add finops__enterprise_discount_program//Enterprise Discount Program current status
  24. GET/v2/service_account/item/{service_account_id}/sync_status_history Get Sync Status History
    • Return Type

      • Add finops__enterprise_discount_program//Enterprise Discount Program status history
  25. POST/v2/service_account/list List Service Accounts
    • Parameter

      • Add ServiceAccountListRequest.filters.sync_status.finops__enterprise_discount_program//Enterprise Discount Program current status
      • Change ServiceAccountListRequest.filters.onboarded_any
      • Change ServiceAccountListRequest.filters.onboarded_all
  26. POST/v2/service_account/summary Summarize Service Accounts
    • Parameter

      • Add ServiceAccountSummaryRequest.filters.sync_status.finops__enterprise_discount_program//Enterprise Discount Program current status
      • Change ServiceAccountSummaryRequest.filters.onboarded_any
      • Change ServiceAccountSummaryRequest.filters.onboarded_all
  27. POST/v2/user_groups/list User Group List
    • Parameter

      • Add UserGroupListRequest.filters//Filters for the request