---
title: "Auth Status"
method: GET
path: "/v1/auth/status"
tags: ["agent-cost"]
---

# Auth Status

`GET /v1/auth/status`

Validate the configured workspace credential without conflating it
with a paid/trial entitlement.

This endpoint contains no customer content and remains available after a
trial expires so the CLI can explain "auth valid, optimization inactive"
instead of incorrectly reporting an authentication failure.

## Response `200`

Successful Response

- AuthStatusResponse
  - `authenticated` boolean
  - `credential_type` 'oauth' | 'api_key', required
  - `org_id` string, required
  - `org_name` string, required
  - `plan_tier` string, required
  - `subscription_status` string
  - `role` string
  - `trial_active` boolean, required
  - `trial_ends_at` string, date-time, nullable
  - `optimization_entitled` boolean, required
  - `policy` WorkspacePolicy, required
    - `mode` 'disabled' | 'audit' | 'optimize', required
    - `pinned_client_version` string
    - `enabled_actions` string[]
    - `required_metrics` boolean

---

[API](https://skmtc.net/codag/apis/infra-logs-templater.md) · [All operations](https://skmtc.net/codag/apis/infra-logs-templater/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/codag/infra-logs-templater/revisions/44d8ea826f48/schema)