API ReferenceapianalyticsPOST /v1/admin/ai-spend/digest

POST /v1/admin/ai-spend/digest

Service: analytics · operationId: (none)

Compute and log the previous UTC day’s AI spend digest.

Required scopes

(no scope declared — review service config)

Responses

200 Digest generated

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "format": "date-time"
    },
    "to": {
      "type": "string",
      "format": "date-time"
    },
    "request_count": {
      "type": "integer"
    },
    "total_cost_usd": {
      "type": "string"
    },
    "total_prompt_tokens": {
      "type": "integer"
    },
    "total_completion_tokens": {
      "type": "integer"
    },
    "top_service": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "group_value": {
          "type": [
            "string",
            "null"
          ]
        },
        "request_count": {
          "type": "integer"
        },
        "prompt_tokens": {
          "type": "integer"
        },
        "completion_tokens": {
          "type": "integer"
        },
        "total_tokens": {
          "type": "integer"
        },
        "cost_usd": {
          "type": "string"
        }
      },
      "required": [
        "group_value",
        "request_count",
        "prompt_tokens",
        "completion_tokens",
        "total_tokens",
        "cost_usd"
      ]
    },
    "top_model": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "group_value": {
          "type": [
            "string",
            "null"
          ]
        },
        "request_count": {
          "type": "integer"
        },
        "prompt_tokens": {
          "type": "integer"
        },
        "completion_tokens": {
          "type": "integer"
        },
        "total_tokens": {
          "type": "integer"
        },
        "cost_usd": {
          "type": "string"
        }
      },
      "required": [
        "group_value",
        "request_count",
        "prompt_tokens",
        "completion_tokens",
        "total_tokens",
        "cost_usd"
      ]
    }
  },
  "required": [
    "from",
    "to",
    "request_count",
    "total_cost_usd",
    "total_prompt_tokens",
    "total_completion_tokens",
    "top_service",
    "top_model"
  ]
}

400 Invalid digest request

{
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    },
    "message": {
      "type": "string"
    }
  },
  "required": [
    "error",
    "message"
  ]
}

Example

curl -X POST https://analytics.platform.loop.health/v1/admin/ai-spend/digest \
  -H "Authorization: Bearer $ACCESS_TOKEN"