{"openapi":"3.1.0","info":{"title":"Augment Code Public APIs","version":"0.2.0","description":"Machine-readable reference for Augment Code's Enterprise Analytics API and public dotcom content API. The Analytics API is a preview feature available to Enterprise customers.","contact":{"name":"Augment Code","url":"https://www.augmentcode.com/contact"}},"externalDocs":{"description":"Augment Code API documentation","url":"https://docs.augmentcode.com/analytics/analytics-api"},"servers":[{"url":"https://api.augmentcode.com","description":"Production Analytics API"}],"security":[{"oauth2":["read"]},{"bearerAuth":[]}],"tags":[{"name":"Analytics","description":"Organization usage and activity analytics"},{"name":"Budgets","description":"Per-user budget override configuration"},{"name":"Content","description":"Public content from augmentcode.com"}],"paths":{"/analytics/v0/dau-count":{"get":{"operationId":"getDailyActiveUserCount","summary":"Get daily active user counts","tags":["Analytics"],"parameters":[{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/analytics/v0/dau":{"get":{"operationId":"listDailyActiveUsers","summary":"List active users for a date","tags":["Analytics"],"parameters":[{"$ref":"#/components/parameters/Date"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/PageSize"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/analytics/v0/daily-usage":{"get":{"operationId":"getDailyUsage","summary":"Get daily organization usage","tags":["Analytics"],"parameters":[{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/analytics/v0/user-activity":{"get":{"operationId":"getUserActivity","summary":"Get usage metrics by user","tags":["Analytics"],"parameters":[{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/PageSize"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/analytics/v0/daily-user-activity-by-editor-language":{"get":{"operationId":"getDailyUserActivityByEditorLanguage","summary":"Get daily user activity by editor and language","tags":["Analytics"],"parameters":[{"$ref":"#/components/parameters/Date"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/PageSize"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/analytics/v0/credit-usage-by-user":{"get":{"operationId":"getCreditUsageByUser","summary":"Get credit usage by user","tags":["Analytics"],"parameters":[{"$ref":"#/components/parameters/StartDate"},{"$ref":"#/components/parameters/EndDate"},{"name":"by_date","in":"query","schema":{"type":"boolean","default":false},"description":"Include a per-date breakdown."},{"name":"by_model","in":"query","schema":{"type":"boolean","default":false},"description":"Include a per-model breakdown."},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/PageSize"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/analytics/v0/cost-analytics":{"post":{"operationId":"getCostAnalytics","summary":"Get cost and token usage analytics","tags":["Analytics"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CostAnalyticsRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/analytics/v0/get-user-budget-overrides":{"post":{"operationId":"getUserBudgetOverrides","summary":"Get per-user budget overrides","tags":["Budgets"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetBudgetOverridesRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/analytics/v0/set-user-budget-overrides":{"post":{"operationId":"setUserBudgetOverrides","summary":"Set per-user budget overrides","description":"Applies valid overrides even when other entries fail. Set config.limit to an empty string to clear an override.","tags":["Budgets"],"security":[{"oauth2":["write"]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetBudgetOverridesRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid authentication token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/changelog":{"servers":[{"url":"https://www.augmentcode.com","description":"Augment Code website"}],"get":{"operationId":"listChangelogEntries","summary":"List public Augment Code changelog entries","tags":["Content"],"security":[],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":"Zero-based result page."},{"name":"client","in":"query","schema":{"type":"string","enum":["vscode","jetbrains","cli","code-review","cosmos","models","all"],"default":"all"},"description":"Product filter."}],"responses":{"200":{"description":"A page of changelog entries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangelogResponse"}}}},"400":{"description":"Invalid query parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DotcomErrorResponse"}}}},"500":{"description":"Changelog content is temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DotcomErrorResponse"}}}}}}}},"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth 2.0 authorization with PKCE for scoped access.","flows":{"authorizationCode":{"authorizationUrl":"https://auth.augmentcode.com/authorize","tokenUrl":"https://auth.augmentcode.com/token","scopes":{"read":"Read organization analytics, usage, and budget configuration.","write":"Create, update, or clear organization budget overrides."}}}},"bearerAuth":{"type":"http","scheme":"bearer","description":"Service-account API token created in the Augment web app. Send it as Authorization: Bearer <token>."}},"parameters":{"StartDate":{"name":"start_date","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive start date in UTC. Defaults depend on the endpoint."},"EndDate":{"name":"end_date","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive end date in UTC. Defaults depend on the endpoint."},"Date":{"name":"date","in":"query","schema":{"type":"string","format":"date"},"description":"Date in UTC. Defaults to yesterday."},"Cursor":{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque cursor from the previous response."},"PageSize":{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1},"description":"Number of records to return. Endpoint-specific maximums apply."}},"schemas":{"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"InvalidArgument"},"message":{"type":"string"}}}}},"DotcomErrorResponse":{"type":"object","required":["success","error","code","message","resolution"],"properties":{"success":{"type":"boolean","const":false},"error":{"type":"string","description":"Backward-compatible error message."},"code":{"type":"string"},"message":{"type":"string"},"resolution":{"type":"string"}}},"CostAnalyticsRequest":{"type":"object","additionalProperties":false,"properties":{"start_date":{"type":"string","format":"date"},"end_date":{"type":"string","format":"date"},"group_by_keys":{"type":"array","items":{"type":"string"}},"granularity":{"type":"string","enum":["COST_ANALYTICS_TIME_GRANULARITY_TOTAL","COST_ANALYTICS_TIME_GRANULARITY_DAY"]},"filters":{"type":"object","additionalProperties":false,"properties":{"user_emails":{"type":"array","items":{"type":"string","format":"email"}},"service_account_names":{"type":"array","items":{"type":"string"}},"product_names":{"type":"array","items":{"type":"string"}},"resource_names":{"type":"array","items":{"type":"string"}},"expert_ids":{"type":"array","items":{"type":"string"}}}},"cursor":{"type":"string"},"page_size":{"type":"integer","minimum":1,"maximum":1000,"default":100}}},"GetBudgetOverridesRequest":{"type":"object","additionalProperties":false,"properties":{"user_emails":{"type":"array","items":{"type":"string","format":"email"}},"service_account_names":{"type":"array","items":{"type":"string"}},"resource":{"type":"string","enum":["BUDGET_RESOURCE_CREDITS_CONSUMED","BUDGET_RESOURCE_USD_COST"]},"period":{"type":"string","enum":["BUDGET_PERIOD_MONTHLY"]}}},"BudgetOverride":{"type":"object","required":["resource","period","config"],"properties":{"user_email":{"type":"string","format":"email"},"service_account_name":{"type":"string"},"resource":{"type":"string","enum":["BUDGET_RESOURCE_CREDITS_CONSUMED","BUDGET_RESOURCE_USD_COST"]},"period":{"type":"string","enum":["BUDGET_PERIOD_MONTHLY"]},"config":{"type":"object","required":["limit"],"properties":{"limit":{"type":"string"}}}},"oneOf":[{"required":["user_email"]},{"required":["service_account_name"]}]},"SetBudgetOverridesRequest":{"type":"object","required":["overrides"],"additionalProperties":false,"properties":{"overrides":{"type":"array","minItems":1,"maxItems":5000,"items":{"$ref":"#/components/schemas/BudgetOverride"}}}},"ChangelogResponse":{"type":"object","required":["entries","total","page","pageSize","hasMore","client"],"properties":{"entries":{"type":"array","items":{"type":"object","additionalProperties":true}},"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":0},"pageSize":{"type":"integer","const":10},"hasMore":{"type":"boolean"},"client":{"type":"string"}}}}}}