Finout

https://docs.finout.io/
Admin
Finout provides a comprehensive platform for cloud cost management, enabling businesses to track,...
Tokens:135,366
Snippets:1,986
Trust Score:9.6
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET /get-started-with-finout.md

Source: https://docs.finout.io/get-started-with-finout

Queries the documentation dynamically by providing a question and an optional goal.

```APIDOC
## GET /get-started-with-finout.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a specific question and an optional broader goal.

### Method
GET

### Endpoint
https://docs.finout.io/get-started-with-finout.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /get-started-with-finout/cost-and-usage-types/focus-in-finout.md

Source: https://docs.finout.io/get-started-with-finout/cost-and-usage-types/focus-in-finout.md

Query the documentation dynamically by asking a question related to the content.

```APIDOC
## GET /get-started-with-finout/cost-and-usage-types/focus-in-finout.md

### Description
Query the documentation dynamically by asking a question. This is useful when the answer is not explicitly present in the current page or you need additional context.

### Method
GET

### Endpoint
https://docs.finout.io/get-started-with-finout/cost-and-usage-types/focus-in-finout.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - Describes the broader end goal to tailor the answer.
```

--------------------------------

### GET /user-guide.md

Source: https://docs.finout.io/user-guide

Queries the documentation for specific information by providing a question and an optional goal.

```APIDOC
## GET /user-guide.md

### Description
Perform an HTTP GET request on the current page URL to query the documentation dynamically.

### Method
GET

### Endpoint
https://docs.finout.io/user-guide.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the answer.
```

--------------------------------

### Query documentation via HTTP GET

Source: https://docs.finout.io/api/finout-api/cost-and-usage-api-v2

Perform a GET request to the documentation index to retrieve answers based on a specific question and optional goal.

```http
GET https://docs.finout.io/api/finout-api/finout-api-v2/cost-and-usage-api-v2.md?ask=<question>&goal=<end_goal>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.finout.io/api/finout-api/generate-an-api-token.md

Perform an HTTP GET request to the documentation URL to ask questions and retrieve relevant excerpts.

```http
GET https://docs.finout.io/api/finout-api/generate-an-api-token.md?ask=<question>&goal=<endgoal>
```

--------------------------------

### GET /user-guide/optimize/costguard/connect-costguard-for-aws/aws-ec2-gpu-cost-optimization-scans-beta.md

Source: https://docs.finout.io/user-guide/optimize/costguard/connect-costguard-for-aws/aws-ec2-gpu-cost-optimization-scans-beta.md

Queries the documentation for specific information by providing a question and an optional goal.

```APIDOC
## GET /user-guide/optimize/costguard/connect-costguard-for-aws/aws-ec2-gpu-cost-optimization-scans-beta.md

### Description
Perform an HTTP GET request on the current page URL to query the documentation dynamically for information not explicitly present in the page.

### Method
GET

### Endpoint
https://docs.finout.io/user-guide/optimize/costguard/connect-costguard-for-aws/aws-ec2-gpu-cost-optimization-scans-beta.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the answer.
```

--------------------------------

### GET /user-guide/optimize/costguard/cloud-native-scans/azure-scans.md

Source: https://docs.finout.io/user-guide/optimize/costguard/cloud-native-scans/azure-scans.md

Queries the documentation for specific information by providing a question and an optional goal.

```APIDOC
## GET /user-guide/optimize/costguard/cloud-native-scans/azure-scans.md

### Description
Perform an HTTP GET request to query the documentation dynamically. This is useful when the answer is not explicitly present in the current page or when clarification is needed.

### Method
GET

### Endpoint
https://docs.finout.io/user-guide/optimize/costguard/cloud-native-scans/azure-scans.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the answer.
```

--------------------------------

### GET Virtual Tag Metadata Response

Source: https://docs.finout.io/api/finout-api/finout-api-v2/virtual-tag-metadata-api-v2.md

Example JSON response containing metadata for virtual tag values.

```json
{
  "requestId": "103774e3-fee4-482a-9535-ddc5f09e9bee",
  "data": {
    "metadata": {
      "App Team": {
        "groups": [
          "d704e672-b33c-4fda-b4fc-bde7a8774de4"
        ],
        "customMetadata": {
          "owner": "Dave"
        },
        "endpoints": [
          "770e4021-08f3-48d9-bdc1-ae9a8fd07cea"
        ]
      },
      "Data Team": {
        "groups": [
          "f9e4a3f1-b8e4-4ff6-8307-e414dfc69ddb"
        ],
        "customMetadata": {
          "owner": "Dan"
        },
        "endpoints": [
          "4f806937-6f5b-478e-a81a-f4b2ece14bb1"
        ]
      },
      "DevOps Team": {
        "groups": [
          "4b6f659e-6a7a-4dc4-975c-30a641f0a42b"
        ],
        "customMetadata": {
          "owner": "Sam"
        }
      }
    }
  }
}
```

```json
{
  "requestId": "63912df4-ad00-42cc-b5f8-05daa1584b09",
  "data": {
    "metadata": {}
  }
}
```

--------------------------------

### GET /get-started-with-finout/onboarding-new-users-to-your-finout-account.md

Source: https://docs.finout.io/get-started-with-finout/onboarding-new-users-to-your-finout-account.md

Queries the documentation for specific information by providing a question and an optional goal.

```APIDOC
## GET /get-started-with-finout/onboarding-new-users-to-your-finout-account.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a specific question.

### Method
GET

### Endpoint
https://docs.finout.io/get-started-with-finout/onboarding-new-users-to-your-finout-account.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET Virtual Tag Version Response

Source: https://docs.finout.io/api/finout-api/finout-api-v2/virtual-tag-versions-api-v2.md

Example JSON response containing the version metadata, configuration rules, and default values.

```json
{
  "requestId": "c85f0423-7048-432b-a144-73f76c2e0512",
  "data": {
    "id": "aba7efe5-de85-4f4b-bd89-0861d140c018",
    "createdBy": "sam.smith@finout.io",
    "createdAt": "2026-03-25T13:19:06.200Z",
    "isLive": false,
    "changeDescription": "doc demo 1",
    "versionData": {
      "rules": [
        {
          "to": {
            "key": "4f816fc1-6b3a-4902-b6b5-9759ba5ca83c",
            "costCenter": "Virtual Tags",
            "type": "virtual_tag"
          },
          "filters": {
            "costCenter": "AWS",
            "key": "operation",
            "displayName": "API Operation",
            "operator": "oneOf",
            "value": ["AAAA"],
            "type": "billing_enrichment"
          }
        }
      ],
      "defaultValue": "Untagged"
    }
  }
}
```

--------------------------------

### GET /get-started-with-finout/single-sign-on-sso-setup.md

Source: https://docs.finout.io/get-started-with-finout/single-sign-on-sso-setup.md

Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a provided question and optional goal.

```APIDOC
## GET /get-started-with-finout/single-sign-on-sso-setup.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a provided question and optional goal.

### Method
GET

### Endpoint
https://docs.finout.io/get-started-with-finout/single-sign-on-sso-setup.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET Virtual Tag Versions Response

Source: https://docs.finout.io/api/finout-api/finout-api-v2/virtual-tag-versions-api-v2.md

Example JSON response containing a list of virtual tag versions and pagination metadata.

```json
{
  "requestId": "828a4454-5a41-4473-9fea-15ce7b3557f4",
  "pagination": {
    "nextCursor": null,
    "hasMore": false
  },
  "data": [
    {
      "id": "eb14e00a-97a8-4af3-84c5-f3dd07d847d8",
      "createdBy": "sam.smith@finout.io",
      "createdAt": "2026-03-31T18:23:48.701Z",
      "isLive": true
    },
    {
      "id": "194f60db-7d2b-4599-b1c2-0fb58160a2d7",
      "createdBy": "sam.smith@finout.io",
      "createdAt": "2026-03-24T18:07:47.475Z",
      "isLive": false
    },
    {
      "id": "36aea575-cb7f-445f-963e-9e68c4a3a46b",
      "createdBy": "sam.smith@finout.io",
      "createdAt": "2026-03-24T16:59:49.766Z",
      "isLive": false,
      "changeDescription": "Duplicate from virtual tag \"AG/Team\""
    }
  ]
}
```

--------------------------------

### Status Response Example

Source: https://docs.finout.io/api/finout-api/finout-api-v2/cost-and-usage-api-v2.md

Example JSON response returned when checking the status of a query.

```json
{
  "requestId": "1dd3b88f-7b13-4b04-87ba-73fd6402924b",
  "data": {
    "status": "COMPLETED",
    "completedAt": "Mar 30, 2026 11:16 am",
    "expiredAt": "Mar 31, 2026 11:16 am",
    "totalRows": 228977
  }
}
```

--------------------------------

### GET /get-started-with-finout/appearance-beta.md

Source: https://docs.finout.io/get-started-with-finout/appearance-beta.md

Perform a query against the documentation to retrieve information or clarification on specific topics.

```APIDOC
## GET /get-started-with-finout/appearance-beta.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, or context based on a specific question.

### Method
GET

### Endpoint
https://docs.finout.io/get-started-with-finout/appearance-beta.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /billing-integrations/observability-platforms/connect-to-datadog/datadog-integration-levels.md

Source: https://docs.finout.io/billing-integrations/observability-platforms/connect-to-datadog/datadog-integration-levels.md

Perform an HTTP GET request to query the documentation for specific information.

```APIDOC
## GET /billing-integrations/observability-platforms/connect-to-datadog/datadog-integration-levels.md

### Description
Queries the documentation dynamically by asking a question related to the content.

### Method
GET

### Endpoint
https://docs.finout.io/billing-integrations/observability-platforms/connect-to-datadog/datadog-integration-levels.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the answer.
```

--------------------------------

### GET /get-started-with-finout/introduction-to-finouts-suite-of-features.md

Source: https://docs.finout.io/get-started-with-finout/introduction-to-finouts-suite-of-features.md

Queries the documentation page for specific information using natural language questions.

```APIDOC
## GET /get-started-with-finout/introduction-to-finouts-suite-of-features.md

### Description
Queries the documentation dynamically by providing a question and an optional goal to receive a direct answer with relevant excerpts.

### Method
GET

### Endpoint
https://docs.finout.io/get-started-with-finout/introduction-to-finouts-suite-of-features.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /billing-integrations/observability-platforms/connect-to-datadog/datadog-usage-attribution-tags-uat.md

Source: https://docs.finout.io/billing-integrations/observability-platforms/connect-to-datadog/datadog-usage-attribution-tags-uat.md

Perform an HTTP GET request to query the documentation dynamically for specific information.

```APIDOC
## GET /billing-integrations/observability-platforms/connect-to-datadog/datadog-usage-attribution-tags-uat.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a specific question.

### Method
GET

### Endpoint
https://docs.finout.io/billing-integrations/observability-platforms/connect-to-datadog/datadog-usage-attribution-tags-uat.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /get-started-with-finout/cost-and-usage-types.md

Source: https://docs.finout.io/get-started-with-finout/cost-and-usage-types.md

Perform a dynamic query against the documentation to retrieve answers, excerpts, and sources based on a specific question and optional goal.

```APIDOC
## GET /get-started-with-finout/cost-and-usage-types.md

### Description
Queries the documentation dynamically to receive a direct answer, relevant excerpts, and sources based on the provided question.

### Method
GET

### Endpoint
https://docs.finout.io/get-started-with-finout/cost-and-usage-types.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask the documentation.
- **goal** (string) - Optional - The broader end goal to help tailor the response context.
```

--------------------------------

### GET /billing-integrations/observability-platforms/connect-to-datadog/datadog-api-cost-calculation.md

Source: https://docs.finout.io/billing-integrations/observability-platforms/connect-to-datadog/datadog-api-cost-calculation.md

Perform an HTTP GET request to query the documentation dynamically for specific information.

```APIDOC
## GET /billing-integrations/observability-platforms/connect-to-datadog/datadog-api-cost-calculation.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a specific question.

### Method
GET

### Endpoint
https://docs.finout.io/billing-integrations/observability-platforms/connect-to-datadog/datadog-api-cost-calculation.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### Generate Query Response Example

Source: https://docs.finout.io/api/finout-api/finout-api-v2/cost-and-usage-api-v2.md

Example JSON response returned after successfully submitting a query request.

```json
{
  "requestId": "5deb7942-5fe4-48eb-8d3f-a6fab6b7eb75",
  "data": {
    "queryId": "q_8b6f4a4961964251bd42b292dfea3c1a"
  }
}
```

--------------------------------

### GET /settings/telemetry.md

Source: https://docs.finout.io/settings/telemetry.md

Perform an HTTP GET request on the documentation page URL to query information dynamically.

```APIDOC
## GET /settings/telemetry.md

### Description
Query the documentation dynamically by asking a question related to the content.

### Method
GET

### Endpoint
https://docs.finout.io/settings/telemetry.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the answer.

### Response
#### Success Response (200)
- **answer** (string) - The direct answer to the question.
- **excerpts** (array) - Relevant excerpts and sources from the documentation.
```

--------------------------------

### GET /user-guide/inform/finout-overview.md

Source: https://docs.finout.io/user-guide/inform/finout-overview.md

Queries the documentation page for information using a natural language question and an optional goal.

```APIDOC
## GET /user-guide/inform/finout-overview.md

### Description
Queries the documentation dynamically by providing a specific question and an optional goal to receive a direct answer with relevant excerpts.

### Method
GET

### Endpoint
https://docs.finout.io/user-guide/inform/finout-overview.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### Execute OCI Setup Script

Source: https://docs.finout.io/billing-integrations/cloud-providers/connect-to-oracle.md

Commands to make the generated setup script executable and run it in the terminal.

```bash
chmod +x oci-setup.sh
./oci-setup.sh
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.finout.io/api/finout-api/endpoint-api-v1

Use this request to ask specific questions about the documentation. The 'ask' parameter is required, while 'goal' is optional for context.

```http
GET https://docs.finout.io/api/finout-api/finout-api-v1/endpoint-api-v1.md?ask=<question>&goal=<end_goal>
```

--------------------------------

### S3 Path Validation Examples

Source: https://docs.finout.io/telemetry-integrations/telemetry/creating-telemetry-in-finout-using-prometheus-metrics.md

Example paths for verifying that Prometheus metrics have been correctly exported to the S3 bucket.

```text
s3://cur-bucket/k8s/prometheus/prod-cluster/end=20251101/day=5/
```

```text
s3://cur-bucket/k8s/prometheus/prod-cluster/end=20251101/day=5/metric=cpu_requests/1759622400_cpu_requests.json.gz
```

--------------------------------

### Query documentation via HTTP GET

Source: https://docs.finout.io/billing-integrations/ai-providers/connect-to-cursor.md

Use this request to ask questions dynamically against the documentation page.

```http
GET https://docs.finout.io/billing-integrations/ai-providers/connect-to-cursor.md?ask=<question>&goal=<endgoal>
```

--------------------------------

### Datadog Metric Query Examples

Source: https://docs.finout.io/telemetry-integrations/telemetry/setting-up-a-datadog-finout-metrics-integration-export.md

Examples of formatted query strings for Datadog metrics, including aggregation functions and grouping parameters.

```text
"query": "sum:my_metric{status:200} by {host}.as_count()"
```

```text
"query": "avg:my_metric{*} by {region}.rollup(sum, 3600)"
```

--------------------------------

### GET /get-started-with-finout/cost-and-usage-types/fairshare-cost.md

Source: https://docs.finout.io/get-started-with-finout/cost-and-usage-types/fairshare-cost.md

Queries the documentation for specific information by providing a question and an optional goal.

```APIDOC
## GET /get-started-with-finout/cost-and-usage-types/fairshare-cost.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a natural language question.

### Method
GET

### Endpoint
https://docs.finout.io/get-started-with-finout/cost-and-usage-types/fairshare-cost.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask the documentation.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```

--------------------------------

### GET /kubernetes-integrations/kubernetes/kubernetes-faqs.md

Source: https://docs.finout.io/kubernetes-integrations/kubernetes/kubernetes-faqs.md

Queries the documentation page for specific information using a natural language question and an optional goal context.

```APIDOC
## GET /kubernetes-integrations/kubernetes/kubernetes-faqs.md

### Description
Queries the documentation page dynamically to retrieve answers, excerpts, and sources based on a provided question.

### Method
GET

### Endpoint
https://docs.finout.io/kubernetes-integrations/kubernetes/kubernetes-faqs.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask the documentation.
- **goal** (string) - Optional - The broader end goal to help tailor the response context.
```

--------------------------------

### Virtual Tag Response Examples

Source: https://docs.finout.io/api/finout-api/finout-api-v2/virtual-tags-api-v2.md

Example responses showing successful creation of Virtual Tags with either a custom string default value or a MegaBill key default value.

```json
{
  "requestId": "bd6a76b6-76d0-4e4c-a0b6-d3bad4e5ea87",
  "data": {
    "id": "a3b7c912-f4d8-4e1a-b2c3-7d8e9f012345",
    "name": "Environment",
    "defaultValue": "Unknown",
    "rules": [
      {
        "to": "production",
        "filters": {
          "costCenter": "AWS",
          "key": "environment",
          "displayName": "environment",
          "operator": "oneOf",
          "value": ["prod", "production"],
          "type": "tag"
        }
      },
      {
        "to": "staging",
        "filters": {
          "costCenter": "AWS",
          "key": "environment",
          "displayName": "environment",
          "operator": "oneOf",
          "value": ["staging", "stage", "stg"],
          "type": "tag"
        }
      },
      {
        "to": "development",
        "filters": {
          "costCenter": "AWS",
          "key": "environment",
          "displayName": "environment",
          "operator": "oneOf",
          "value": ["dev", "development"],
          "type": "tag"
        }
      }
    ],
    "acl": {
      "read": { "type": "public", "users": [], "groups": [] },
      "write": { "type": "private", "users": ["alice@example.com"], "groups": [] }
    },
    "createdBy": "alice@example.com",
    "updatedBy": "alice@example.com",
    "createdAt": "Wed Apr 30 2026 14:00:00 GMT+0000 (Greenwich Mean Time)",
    "updatedAt": "Wed Apr 30 2026 15:30:00 GMT+0000 (Greenwich Mean Time)"
  }
}
```

```json
{
  "requestId": "e5d094c6-bb3c-4da2-8209-6ec9a5f2dfaa",
  "data": {
    "id": "f84c9ab0-dab2-4cf1-b7aa-f4a767d9724b",
    "name": "Environment",
    "defaultValue": "Untagged",
    "rules": [
      {
        "to": {
          "key": "environment",
          "costCenter": "AWS",
          "type": "tag"
        },
        "filters": {
          "costCenter": "AWS",
          "key": "environment",
          "displayName": "environment",
          "operator": "exists",
          "type": "tag"
        }
      },
      {
        "to": {
          "key": "env",
          "costCenter": "GCP",
          "type": "tag"
        },
        "filters": {
          "costCenter": "GCP",
          "key": "env",
          "displayName": "env",
          "operator": "exists",
          "type": "tag"
        }
      }
    ],
    "createdBy": "alice@example.com",
    "updatedBy": "alice@example.com",
    "createdAt": "Wed Apr 30 2026 14:00:00 GMT+0000 (Greenwich Mean Time)",
    "updatedAt": "Wed Apr 30 2026 15:30:00 GMT+0000 (Greenwich Mean Time)"
  }
}
```

--------------------------------

### GET /ai-and-developer-tools/account-instructions.md

Source: https://docs.finout.io/ai-and-developer-tools/account-instructions.md

Perform a query against the documentation to receive a direct answer and relevant excerpts based on a specific question and optional goal.

```APIDOC
## GET /ai-and-developer-tools/account-instructions.md

### Description
Queries the documentation dynamically to retrieve answers, excerpts, and sources based on a provided question.

### Method
GET

### Endpoint
https://docs.finout.io/ai-and-developer-tools/account-instructions.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The specific, self-contained question to ask.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the response.

### Request Example
GET https://docs.finout.io/ai-and-developer-tools/account-instructions.md?ask=How+do+I+configure+my+account?&goal=setup+billing

### Response
#### Success Response (200)
- **answer** (string) - The direct answer to the question.
- **excerpts** (array) - Relevant excerpts from the documentation.
- **sources** (array) - Sources used to generate the answer.
```

--------------------------------

### GET /kubernetes-integrations/kubernetes/how-finout-calculates-kubernetes-costs.md

Source: https://docs.finout.io/kubernetes-integrations/kubernetes/how-finout-calculates-kubernetes-costs.md

Performs a query against the documentation page to retrieve answers, excerpts, and sources based on a specific question.

```APIDOC
## GET /kubernetes-integrations/kubernetes/how-finout-calculates-kubernetes-costs.md

### Description
Queries the documentation page dynamically to retrieve information not explicitly present in the static content.

### Method
GET

### Endpoint
https://docs.finout.io/kubernetes-integrations/kubernetes/how-finout-calculates-kubernetes-costs.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask the documentation.
- **goal** (string) - Optional - The broader end goal to help tailor the response.
```
Tokens:
Raw