External APIs 5.0 (2501)

April 2025

Changelog

Changelog

Versions


Changes from 1.0.0 to 1.0.0.

What's New


  1. POST/cost_anomaly/reject_anomaly Reject Billing Cost Anomaly
  2. POST/v1/ai_agent/chat/create Returns created chat id and chat name
  3. PUT/v1/ai_agent/chat/item/{chat_id} Updates Chat Name
  4. POST/v1/ai_agent/chat/item/{chat_id} Chat History
  5. DELETE/v1/ai_agent/chat/item/{chat_id} Deletes Chat
  6. POST/v1/ai_agent/chat/item/{chat_id}/converse Returns the conversation
  7. POST/v1/ai_agent/chat/list Returns List of created chats id with chat name and conversation length
  8. POST/v1/ai_agent/template Returns the sample questions
  9. GET/v1/ai_agent/{tenant_id}/list List the agents available
  10. POST/v1/billing/commitment Get billing commitment details
  11. POST/v1/billing/commitment/events List all billing commitment events
  12. POST/v1/billing_plans/batch Fetch all Billing Plan definitions
  13. POST/v1/billing_plans/create Create a new Billing Plan definition
  14. POST/v1/billing_plans/list Fetch all Billing Plan definitions for the user
  15. POST/v1/billing_plans/version/batch Fetch Billing Plan versions by ids
  16. POST/v1/billing_plans/version/create Create a new version of a Billing Plan
  17. POST/v1/billing_plans/version/parse_import Parse Billing Plan Version
  18. GET/v1/billing_plans/version/{version_id} Get Billing Plan version details by version_id
  19. PATCH/v1/billing_plans/version/{version_id}/make_head Make a Billing Plan version the head version
  20. PATCH/v1/billing_plans/version/{version_id}/make_release Make a Billing Plan version the release version
  21. GET/v1/billing_plans/{plan_definition_id} Get Billing Plan definition by id
  22. DELETE/v1/billing_plans/{plan_definition_id} Delete Billing Plan by plan_id
  23. GET/v1/billing_plans/{plan_definition_id}/history Get Billing Plan definition history by definition id
  24. POST/v1/billing_plans/{plan_definition_id}/set_state Set the state of a Billing Plan definition
  25. POST/v1/currency_exchange_configuration/batch Batch Currency Exchange Configuration
  26. POST/v1/currency_exchange_configuration/create Create Currency Exchange Configuration
  27. GET/v1/currency_exchange_configuration/item/{item_id} Get Currency Exchange Configuration
  28. POST/v1/currency_exchange_configuration/item/{item_id} Update Currency Exchange Configuration
  29. DELETE/v1/currency_exchange_configuration/item/{item_id} Delete Currency Exchange Configuration
  30. POST/v1/currency_exchange_configuration/list List Currency Exchange Configuration
  31. POST/v1/executive_dashboard/report/generate Schedule the generation of a report for a dashboard
  32. GET/v1/executive_dashboard/report/item/{report_id} Fetch a report by ID
  33. POST/v1/master_data/categories/list List Master data
  34. POST/v1/recommendations/batch Get the List of Recommendation Details
  35. POST/v1/recommendations/exclusion_rule/apply Apply all the Recommendation Exclusion Rules which are available/applicable/provided in the tenant
  36. POST/v1/recommendations/exclusion_rule/batch Fetch a Recommendation Exclusion Rule Details
  37. POST/v1/recommendations/exclusion_rule/create Creates a Recommendation Exclusion Rule
  38. GET/v1/recommendations/exclusion_rule/item/{rule_id} Get Recommendation Exclusion Rule
  39. POST/v1/recommendations/exclusion_rule/item/{rule_id} Update Recommendation Exclusion Rule
  40. DELETE/v1/recommendations/exclusion_rule/item/{rule_id} Delete Recommendation Exclusion Rule
  41. POST/v1/recommendations/exclusion_rule/list List of Recommendation Exclusion Rules
  42. POST/v1/recommendations/list List of Recommendations
  43. POST/v1/recommendations/resources/batch List of Resource Recommendation Details
  44. POST/v1/recommendations/resources/list Fetch a List of Resource Recommendation
  45. POST/v2/billing/aggregation Aggregate costs based on input criteria
  46. POST/v2/billing/aggregation/batch Aggregate costs based on input criteria
  47. POST/v2/billing/aggregation/trend Aggregate costs in a trend based on input criteria
  48. POST/v2/billing/extras List extra keys used in service accounts
  49. POST/v2/billing/line_items_summary List values for group_by key used in service accounts
  50. POST/v2/billing/rate/aggregation/trend Aggregate rate in a trend based on input criteria
  51. POST/v2/billing/tags List tag keys used in service accounts
  52. POST/v2/billing/usage/aggregation/trend Aggregate usage in a trend based on input criteria
  53. POST/v2/billing_info/batch Fetch Billing Information
  54. POST/v2/billing_metrics/batch Batch of Billing Metrics
  55. POST/v2/billing_metrics/create Create new Billing Metrics
  56. POST/v2/billing_metrics/item/{billing_metrics_id} Update Billing Metrics
  57. DELETE/v2/billing_metrics/item/{billing_metrics_id} Delete Billing Metrics
  58. GET/v2/billing_metrics/list List Billing Metrics
  59. POST/v1/workload-query/resource/filters/service-resource Returns list of WorkloadServiceResource with all possible filter values for the given cloud accounts

What's Deprecated


  1. POST/cost/executive_dashboard/cloud_forecaster_for_six_months Get cloud Forecaster for six months
  2. POST/cost/executive_dashboard/spend-by-billing-type Get Cost Spend By Billing Type
  3. POST/cost/executive_dashboard/spend-by-cloud Get Cost Spend By Cloud
  4. POST/cost/executive_dashboard/spend-by-cloud-account Get Cost Spend By Cloud Account
  5. POST/cost/executive_dashboard/spend_by_cloud_resource_category Get Cost Spend By Cloud and Resource Category
  6. POST/cost/executive_dashboard/spend_by_cloud_tenant Get Cost Spend By Cloud and Tenant
  7. POST/cost/executive_dashboard/spend_by_region Get Cost Spend By Region
  8. POST/cost/executive_dashboard/spend_by_tagged_untagged Get Tag And Untag Cloudwise Trend
  9. POST/cost/executive_dashboard/spend_trend_by_cloud Get Cost Trend By Cloud
  10. POST/cost/executive_dashboard/spend_trend_by_cloud_resource_category Get Cost Spend Trend By Product Category
  11. POST/cost/executive_dashboard/tagged_and_untagged_spend_by_cloud Get Tagged and Untagged Spend Cloud Wise
  12. POST/cost/trend_analysis/tag CostTag Report
  13. POST/cost/trend_analysis/trend Cost Trend Report
  14. POST/v1/cost/estimated_cost Returns a forecast monthly costs for service accounts
  15. POST/v1/cost/resource_wise_billing_monthly/aggregate Returns a resource wise monthly bill for given service account and sku list
  16. POST/v1/cost/resource_wise_billing_monthly/latest Returns the latest resource wise monthly bill for given service account and resource id
  17. GET/v1/workload-query/resource/filters/service-resource Returns list of WorkloadServiceResource with all possible filter values

What's Changed


  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. POST/governance/guardrails/{tenant_id}/policies/list List Policies
    • Parameter

      • Change PolicyListRequest.classification (Added Enum)
    • Return Type

      • Change policies.classification (Added Enum)
  4. 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
  5. 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
  6. 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
  7. 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
  8. 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
  9. POST/v1/master_accounts
    • Parameter

      • Add CreateMasterAccountRequest.fiscal_year_configuration//Fiscal Year 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/master_accounts/item/{master_account_id} Master Account View
    • Return Type

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

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

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

      • Change ScheduleListRequest.sort.column (Added Enum)
  15. 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
  16. POST/v1/well-architected-framework/assessment-run/batch Get a batch of assessment run details
    • Return Type

      • Add assessment_definition//The Assessment this run is for
  17. POST/v1/well-architected-framework/assessment-run/create Start an assessment run for the assessment definition
    • Return Type

      • Add assessment_definition//The Assessment this run is for
  18. GET/v1/well-architected-framework/assessment-run/item/{assessment_run_id} Fetch the details for an assessment run by ID
    • Return Type

      • Add assessment_definition//The Assessment this run is for
  19. POST/v1/well-architected-framework/assessment-run/item/{assessment_run_id}/set-state Set the state for an assessment run
    • Return Type

      • Add assessment_definition//The Assessment this run is for
  20. POST/v2/audit/auditlog/list Audit List
    • Parameter

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

      • Change ServiceAccountDetails.onboarded_features.feature (Added Enum)
  22. 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)
  23. GET/v2/service_account/item/{service_account_id} Get Service Account details
    • Return Type

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

      • Change onboarded_features.feature (Added Enum)
  25. 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)
  26. 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)
  27. 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
  28. 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
  29. 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
  30. 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
  31. 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
  32. POST/v2/user_groups/list User Group List
    • Parameter

      • Add UserGroupListRequest.filters//Filters for the request