# Analytics

## Get Project Analytics Data Api

> Project analytics. List with the flow run logs matching the given filters.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"ProjectRunSummary":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"date":{"type":"string","format":"date-time","title":"Date"},"is_flow_successful":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Flow Successful"},"state":{"anyOf":[{"$ref":"#/components/schemas/WorkflowState"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"latency":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latency"},"total_tokens":{"type":"integer","title":"Total Tokens"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"inputs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inputs"},"outputs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outputs"},"llms":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llms"},"feedback":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback"}},"type":"object","required":["run_id","date","is_flow_successful","state","error","latency","total_tokens","user_id","inputs","outputs","llms","feedback"],"title":"ProjectRunSummary","description":"A row with information about a run log."},"WorkflowState":{"type":"string","enum":["PENDING","PAUSED","RESUMED","COMPLETED","FAILED"],"title":"WorkflowState","description":"Enum representing the possible states of a workflow."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/analytics/org/{org_id}/flows/{flow_id}":{"get":{"tags":["analytics"],"summary":"Get Project Analytics Data Api","description":"Project analytics. List with the flow run logs matching the given filters.","operationId":"get_analytics_data_api_analytics_org__org_id__flows__flow_id__get","parameters":[{"name":"flow_id","in":"path","required":true,"schema":{"type":"string","title":"Flow Id"}},{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":25,"title":"Page Size"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProjectRunSummary"},"title":"Response Get Analytics Data Api Analytics Org  Org Id  Flows  Flow Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Org Analytics Data Api across all projects

> Org-level analytics for all projects. List with the project run logs matching the given filters.

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"httpBearer":[]}],"components":{"securitySchemes":{},"schemas":{"OrgProjectRunSummary":{"properties":{"project_id":{"type":"string","title":"Project Id"},"project_owner":{"type":"object","properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"avatar_url":{"type":"string","format":"uri","title":"Avatar Url"}},"required":["user_id","email","avatar_url"],"title":"Project Owner"},"project_type":{"type":"string","title":"Project Type"},"project_name":{"type":"string","title":"Project Name"},"total_runs":{"type":"integer","title":"Total Runs"},"total_errors":{"type":"integer","title":"Total Errors"},"total_tokens":{"type":"integer","title":"Total Tokens"},"total_users":{"type":"integer","title":"Total Users"},"is_published":{"type":"boolean","title":"Is Published"},"public_ui_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Ui Url"},"public_ui_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Ui Type"}},"type":"object","required":["project_id","project_owner","project_type","project_name","total_runs","total_errors","total_tokens","total_users","is_published","public_ui_url","public_ui_type"],"title":"OrgProjectRunSummary","description":"A row with information about project run summary at the organization level."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/organizations/analytics/projects-run-summary":{"get":{"tags":["analytics"],"summary":"Get Org Analytics Data Api across all projects","description":"Org-level analytics for all projects. List with the project run logs matching the given filters.","operationId":"get_org_analytics_data_api_organizations_analytics_projects_run_summary_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":25,"title":"Page Size"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrgProjectRunSummary"},"title":"Response Get Org Analytics Data Api Across All Projects Organizations  Analytics Projects Run Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## GET /analytics/storage/total-usage

> Get Storage Usage

```json
{"openapi":"3.1.0","info":{"title":"StackAI API","version":"0.1.0"},"servers":[{"url":"https://api.stack-ai.com","description":"StackAI API Server"}],"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"token"}}}},"schemas":{"StorageUsageResponse":{"properties":{"total_storage_bytes":{"type":"integer","title":"Total Storage Bytes"},"knowledge_bases":{"items":{"$ref":"#/components/schemas/KnowledgeBaseStorageInfo"},"type":"array","title":"Knowledge Bases"}},"type":"object","required":["total_storage_bytes","knowledge_bases"],"title":"StorageUsageResponse"},"KnowledgeBaseStorageInfo":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"storage_bytes":{"type":"integer","title":"Storage Bytes"},"connection_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Connection Id"}},"type":"object","required":["id","name","storage_bytes"],"title":"KnowledgeBaseStorageInfo","description":"Storage information for a knowledge base."}}},"paths":{"/analytics/storage/total-usage":{"get":{"tags":["analytics","storage"],"summary":"Get Storage Usage","operationId":"get_storage_usage_analytics_storage_total_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/StorageUsageResponse"},{"type":"null"}],"title":"Response Get Storage Usage Analytics Storage Total Usage Get"}}}}}}}}}
```