Create a collared agent identity

POST

https://new.fp.dev/api/v1/agents/sign-up

Starts human-sponsored agent signup. The returned API key is collared until the sponsoring human approves the request or the fallback OTP is verified.

Request

This endpoint expects an object.

emailstringRequiredformat: "^[^\s@]+@[^\s@]+\.[^\s@]+$"<=254 characters

client_idanyRequired

namestring or nullOptional

Response

Success

api_keystring

agent_idstring

handleany

organization_idstring

verifiedboolean

approvalobject

Errors

400

Bad Request Error

409

Conflict Error

429

Too Many Requests Error

$	curl -X POST https://new.fp.dev/api/v1/agents/sign-up \
>	-H "Content-Type: application/json" \
>	-d '{
>	"email": "string",
>	"client_id": "string"
>	}'

1	{
2	"api_key": "string",
3	"agent_id": "string",
4	"handle": "string",
5	"organization_id": "string",
6	"verified": true,
7	"approval": {
8	"status": "pending",
9	"retry_after_seconds": "NaN",
10	"expires_at": "string"
11	}
12	}