---
title: "Agent Register"
method: POST
path: "/v1/agents/register"
---

# Agent Register

`POST /v1/agents/register`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/agents/register`
- Auth: none declared

Public endpoint — anyone can register an agent. Returns an
API key ONCE; we hash + persist immediately and never show the
plaintext again. Operator-controlled `active` flag remains true
by default (we'll tighten if abuse shows up).

## Request body

- AgentRegister
  - `name` string, required
  - `contact_email` string, nullable
  - `description` string, nullable
  - `recommender_address` string, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)