---
title: "Get audit logs [READ] [PRO]"
method: GET
path: "/v2/audit-logs/{namespace}"
tags: ["Audit Logs"]
---

# Get audit logs [READ] [PRO]

`GET /v2/audit-logs/{namespace}`

## Path parameters

- `namespace` string, required

## Query parameters

- `endpoint` string
- `username` string
- `cursor` string
- `limit` integer

## Response `200`

Audit logs returned successfully

- AuditLogs
  - `list` AuditLog[], required — Audit logs
    - `ip` string, nullable
    - `reason` union, required
      - object
        - `endpointCreated` Endpoint, required — Endpoint
          - `cacheHttpResponses` boolean
          - `compute` EndpointCompute, required — Endpoint compute
            - `accelerator` 'cpu' | 'gpu' | 'neuron' | 'zero_gpu', required
            - `id` string, nullable — Only informational, ignored at specification
            - `instanceSize` string, required
            - `instanceType` string, required — Compute instance type
            - `scaling` EndpointScaling, required — Autoscaling configuration
              - …
          - `customRouter` CustomRouterFeature — Custom-router sidecar configuration
            - `env` object — Additional environment variables to set on the custom-router sidecar
            - `port` integer, nullable — Port the custom-router sidecar listens on. Defaults to 3000.
            - `tag` string, nullable — Custom-router sidecar image tag. When null or absent, the custom router is removed.
          - `experimentalFeatures` ExperimentalFeatures — Endpoint experimental features
            - `cacheHttpResponses` boolean — Enable caching of successful HTTP responses. When enabled, responses are cached with a 60min TTL (reset on each cache hit) and served instantly on identical requests. With 100% cache hit rates, endpoints can automatically scale to zero while still serving cached responses, optimizing both latency and cost. Cache hits are indicated by the 'x-cache: HIT' response header, and requests can bypass the cache using 'x-use-cache: false'. Currently only available for HuggingFace Admins.
            - `loadBalancer` 'random' | 'sticky' | 'least_connections' — Load balancer strategy for distributing requests across replicas
            - `mcpLb` McpLbFeature
              - …
            - `skipRepoDownload` boolean, nullable — Skip model repository download on initialization
          - `model` EndpointModel, required — Model and container configuration
            - `args` string[], nullable — Arguments passed to the container command
            - `command` string[], nullable — Override container entrypoint command
            - `env` object — Environment variables
            - `framework` 'custom' | 'pytorch' | 'llamacpp', required — ML framework used by the model
            - `fromCatalog` boolean, nullable — Indicates the endpoint was created from a catalog template
            - `image` union, required
              - …
            - `repository` string, required — HuggingFace model repository (e.g., "meta-llama/Llama-2-7b-hf")
            - `revision` string, nullable — Git commit SHA or branch name (defaults to latest main)
            - `secrets` object — Secret environment variables (values are encrypted at rest)
            - `task` 'custom' | 'any-to-any' | 'audio-classification' | 'automatic-speech-recognition' | 'feature-extraction' | 'fill-mask' | 'image-classification' | 'image-segmentation' | 'image-text-to-text' | 'object-detection' | 'question-answering' | 'sentence-embeddings' | 'sentence-ranking' | 'sentence-similarity' | 'summarization' | 'table-question-answering' | 'text-classification' | 'text-generation' | 'text-ranking' | 'text-to-image' | 'token-classification' | 'translation' | 'zero-shot-classification' — Model task type defining the inference API
          - `name` string, required — Endpoint name. Must only contains lowercase alphanumeric characters or '-' and have a length of 32 characters maximum
          - `network` NetworkSpec — Network access control specification
            - `cidrBlock` boolean, nullable — Enable CIDR-based access restriction
            - `cidrList` string[], nullable — List of allowed CIDR blocks (e.g., ["10.0.0.0/8", "192.168.1.0/24"])
          - `notifications` EndpointNotifications — Endpoint notifications configuration
            - `email` boolean, required — Enable email notifications
            - `push` boolean, required — Enable front push notifications
          - `privateService` EndpointPrivateService — AWS PrivateLink configuration for VPC-connected endpoints
            - `accountId` string, required — AWS account ID allowed to connect via PrivateLink
            - `shared` boolean — Share the PrivateLink service across all endpoints for this owner (reduces costs)
          - `provider` EndpointProvider, required — Endpoint provider
            - `region` string, required — Provider region
            - `vendor` string, required — Provider vendor
          - `route` RouteSpec — Custom domain routing specification
            - `domain` string, required — Custom domain name
            - `path` string, required — Path prefix for routing
          - `tags` string[] — Endpoint tags
          - `type` 'public' | 'authenticated' | 'private', required — Endpoint visibility and authentication mode
      - object
        - `endpointPaused` object, required
      - object
        - `endpointScaledToZero` object, required
      - object
        - `endpointResumed` object, required
      - object
        - `endpointUpdated` union, required
          - object
            - `type` object, required
              - …
          - object
            - `instance` object, required
              - …
          - object
            - `replica` object, required
              - …
          - object
            - `scalingToZero` object, required
              - …
          - object
            - `measure` object, required
              - …
          - object
            - `repository` object, required
              - …
          - object
            - `task` object, required
              - …
          - object
            - `framework` object, required
              - …
          - object
            - `command` object, required
              - …
          - object
            - `image` object, required
              - …
          - object
            - `secrets` object, required
              - …
          - object
            - `env` object, required
              - …
          - object
            - `experimentalFeatures` object, required
              - …
          - object
            - `tags` object, required
              - …
          - object
            - `route` object, required
              - …
      - object
        - `endpointDeleted` object, required
    - `requestId` string, required
    - `user` Account, required
      - `id` string, required
      - `name` string, required
    - `createdAt` string, date-time, required
    - `endpoint` string, required
    - `id` string, required
    - `level` 'debug' | 'info' | 'critical', required
  - `next_cursor` string, nullable — Use as query param `cursor` to fetch previous cursor results
  - `prev_cursor` string, nullable — Use as query param `cursor` to fetch next cursor results

---

[API](https://skmtc.net/huggingface/apis/hf-inference-endpoints-api.md) · [All operations](https://skmtc.net/huggingface/apis/hf-inference-endpoints-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hf-inference-endpoints-api/versions/52e3f4cdbf86/schema)