> ## Documentation Index > Fetch the complete documentation index at: https://help.nops.io/llms.txt > Use this file to discover all available pages before exploring further. # Create report from showback > Creates a saved Explorer report pre-scoped to this showback (groupBy and the showback overlay are derived automatically). Optional `config` overrides costType, granularity, date range, and filters. Defaults to the last 30 days when no date is given. ## OpenAPI ````yaml /openapi.json post /v1/cost-allocation/{id}/reports openapi: 3.1.0 info: title: nOps Public API version: 1.0.0 description: >- Programmatic access to nOps cost, budgets, cost allocation, Explorer dashboards, AI optimization, MAP manager, business unit economics, contract tracker, reports, recommendations, feed, scheduled prompts, and notifications. Authenticate with an API key (Bearer token). Available on Inform + Operate. servers: - url: https://api.nops.io description: Production security: - bearerApiKey: [] tags: - name: Recommendations description: Cost optimization recommendations. - name: Anomalies description: AWS cost anomaly detection. - name: Explorer description: Cost Explorer queries — summary, history, heatmap, and dimensions. - name: Budgets description: Budgets, planning grids, alerts, and exports. - name: Reports description: Saved reports — create, update, render, and send. - name: Feed description: Clara Feed runs and delivery history. - name: Scheduled prompts description: Scheduled Clara prompts and manual runs. - name: Notifications description: Schedule and manage notification deliveries. - name: Commitments description: Commitment inventory (reserved for future use). - name: Cost allocation description: Cost Allocation showbacks, rules, and spend analytics. - name: Explorer dashboards description: Explorer dashboard layouts and widgets. - name: AI optimization description: AI Optimization default dashboard and anomaly insights. - name: MAP Manager description: AWS Migration Acceleration Program (MAP) project tracking. - name: Business unit economics description: Business unit economics models, units, and portfolio summaries. - name: Contract tracker description: Enterprise contract tracking and burndown analytics. paths: /v1/cost-allocation/{id}/reports: post: tags: - Cost allocation summary: Create report from showback description: >- Creates a saved Explorer report pre-scoped to this showback (groupBy and the showback overlay are derived automatically). Optional `config` overrides costType, granularity, date range, and filters. Defaults to the last 30 days when no date is given. operationId: createCostAllocationShowbackReport parameters: - schema: type: string description: Showback ID required: true name: id in: path - schema: type: string maxLength: 64 description: >- Unique key for safe retries on write requests (required, max 64 characters). required: true name: Idempotency-Key in: header requestBody: required: true content: application/json: schema: type: object properties: name: type: string minLength: 1 maxLength: 200 scope: type: string enum: - private - shared - global default: private config: type: object properties: dateRange: type: object properties: start: type: string pattern: ^\d{4}-\d{2}-\d{2}$ end: type: string pattern: ^\d{4}-\d{2}-\d{2}$ required: - start - end dateRangeMode: type: string enum: - rolling - fixed datePreset: type: string enum: - 7D - 14D - 30D - 60D - 1M - 3M - 6M - 1Y - 3Y - MTD - YTD - 1Y+MTD - +0M - +1M - +3M - +6M - +1Y - +3Y - +4Y groupBy: type: string costType: type: string enum: - line_item_unblended_cost - line_item_amortized_cost - line_item_blended_cost - pricing_public_on_demand_cost - nops_line_item_net_unblended_cost - nops_line_item_net_amortized_cost - nops_pricing_net_public_on_demand_cost granularity: type: string enum: - hour - day - week - month - quarter filters: type: array items: type: object properties: dimension: type: string mode: type: string enum: - include - exclude values: type: array items: type: string valueModes: type: object additionalProperties: type: string enum: - include - exclude texts: type: array items: type: object properties: mode: type: string enum: - include - exclude text: type: string minLength: 1 required: - mode - text textCombinator: type: string enum: - and - or keyCombinator: type: string enum: - and - or tagKeyOnly: type: boolean required: - dimension - mode - values default: [] tagKeyCombinators: type: object additionalProperties: type: string enum: - and - or topN: type: integer nullable: true minimum: 0 exclusiveMinimum: true usageChart: type: string enum: - Hide - Usage - Normalized Usage default: Hide widgetChartView: type: string enum: - all - spend - usage widgetTargetChartView: type: string enum: - all - spend - target widgetBusinessUnitChartView: type: string enum: - all - spend - unit page: type: integer minimum: 0 exclusiveMinimum: true pageSize: type: integer nullable: true minimum: 0 exclusiveMinimum: true sortColumn: type: string enum: - name - total sortDir: type: string enum: - asc - desc nameSearch: type: string minLength: 1 maxLength: 200 budgetOverlay: type: object nullable: true properties: budgetId: type: string minLength: 1 enabled: type: boolean required: - budgetId - enabled bueOverlay: type: object nullable: true properties: economicsId: type: integer minimum: 0 exclusiveMinimum: true enabled: type: boolean required: - economicsId - enabled showbackOverlay: type: object nullable: true properties: showbackId: type: integer minimum: 0 exclusiveMinimum: true enabled: type: boolean dimension: type: string nullable: true grouping: type: string enum: - allocation - dimension valueFilter: type: object nullable: true properties: mode: type: string enum: - include - exclude values: type: array items: type: string valueModes: type: object additionalProperties: type: string enum: - include - exclude required: - mode - values drilldownGroupBy: type: string nullable: true required: - showbackId - enabled heatmap: type: object nullable: true properties: enabled: type: boolean xAxis: type: string yAxis: type: string required: - enabled - xAxis - yAxis forecastHorizon: type: integer minimum: 1 maximum: 365 bypassCache: type: boolean required: - name example: name: Engineering allocation — last month scope: private responses: '201': description: >- Creates a saved Explorer report pre-scoped to this showback (groupBy and the showback overlay are derived automatically). Optional `config` overrides costType, granularity, date range, and filters. Defaults to the last 30 days when no date is given. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' example: data: report: id: report-1 name: Engineering allocation — last month scope: private config: dateRange: start: '2026-05-31' end: '2026-06-29' groupBy: product_product_name costType: line_item_unblended_cost granularity: day filters: [] organizationId: org-1 nopsClientId: 42 creatorId: user-1 createdAt: '2026-07-17T12:00:00.000Z' updatedAt: '2026-07-17T12:00:00.000Z' creator: id: user-1 firstName: FinOps lastName: Analyst email: finops@example.com '401': description: Unauthorized — invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/PublicApiError' example: error: code: forbidden_scope message: 'API key is missing required scope: budgets:write' request_id: 550e8400-e29b-41d4-a716-446655440000 '403': description: Forbidden — insufficient permissions or entitlement content: application/json: schema: $ref: '#/components/schemas/PublicApiError' example: error: code: forbidden_scope message: 'API key is missing required scope: budgets:write' request_id: 550e8400-e29b-41d4-a716-446655440000 security: - bearerApiKey: [] components: schemas: PublicApiError: type: object properties: error: type: object properties: code: type: string message: type: string request_id: type: string required: - code - message - request_id required: - error securitySchemes: bearerApiKey: type: http scheme: bearer description: >- API key from Settings → Security → API Keys. Pass as `Authorization: Bearer YOUR_API_KEY`. ````