---
title: "Check access"
method: POST
path: "/api/inference-endpoints/{namespace}/{endpoint}/auth-check/{perms}"
tags: ["inference-endpoints"]
---

# Check access

`POST /api/inference-endpoints/{namespace}/{endpoint}/auth-check/{perms}`

Check if the user has access to the inference endpoint

## Path parameters

- `namespace` string, required
- `endpoint` string, required
- `perms` 'read' | 'write' | 'infer', required

## Query parameters

- `own` string
- `is_creator` string
- `creator_id` string
- `incur_cost` string
- `resource_group_id` string
- `repo_id` string

## Response `200`

The user has access to the inference endpoint/resource

- object
  - `namespace` object, required
    - `id` string, required
    - `name` string, required
  - `user` object, required
    - `id` string, required
    - `name` string, required
    - `hasHfLevelAccess` boolean
  - `resourceGroupId` string

## Other responses

- `207` — The user has access to the resource, but the endpoint name is restricted by pattern restrictions. Can only be returned if `endpoint` is not provided in the path

## Changes

- **2026-09-08** `bd17546f47b8` — 3 info
  - for the `query` request parameter `incur_cost`, the type was generalized from no type to `string`
  - for the `query` request parameter `is_creator`, the type was generalized from no type to `string`
  - for the `query` request parameter `own`, the type was generalized from no type to `string`

[Change history](https://skmtc.dev/huggingface/apis/hub-api-endpoints/changes/api/inference-endpoints/:namespace/:endpoint/auth-check/:perms/post.md)

---

[API](https://skmtc.dev/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.dev/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc.dev/huggingface/apis/hub-api-endpoints/revisions/b88d4a4da99f?raw)