---
title: "Create access block"
method: POST
path: "/api/admin/access-blocks"
tags: ["admin"]
---

# Create access block

`POST /api/admin/access-blocks`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Refuse new sign-ups (and, for an IP, sign-ins) from an IP or email
domain. 409 while a block on the same value is in force. Admin-only.

## Request body

- CreateAccessBlockRequest
  - `kind` 'IP' | 'EMAIL_DOMAIN', required
  - `value` string, required
  - `reason` string, required
  - `expires_at` string, date-time, nullable

## Response `201`

Successful Response

- AccessBlock
  - `id` string, required
  - `kind` 'IP' | 'EMAIL_DOMAIN', required
  - `value` string, required
  - `reason` string, required
  - `created_by_id` string, nullable, required
  - `created_by_email` string, nullable, required
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, nullable, required

## Other responses

- `401`: Authentication required
- `422`: Validation Error

## Changes

- **2026-10-21** `b7713814eaed`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/admin/access-blocks/post.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) - [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) - [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/c508818c16ad?raw)