---
title: "POST /api/me/agents/challenge"
method: POST
path: "/api/me/agents/challenge"
tags: ["me_agents"]
---

# POST /api/me/agents/challenge

`POST /api/me/agents/challenge`

## Request

- Base URL: `https://api.aifinpay.io`
- URL: `https://api.aifinpay.io/api/me/agents/challenge`
- Auth: one of:
  - API key in cookie `aifinpay_session`
  - API key in cookie `__aifinpay_agent_claim`

Start a signed wallet challenge. Optional agent_id selects an existing OWNED logical agent for a full owner session only. The target and verified claim-session identity are stored with the challenge and cannot be changed at signature submission.

## Request body

- object
  - `address` string, required
  - `chain` string
  - `agent_id` string, nullable

## Response `200`

Successful response

- unknown

## Other responses

- `400`: AIFP-* error envelope. See backend/server.js safe error handler.
- `401`: AIFP-* error envelope. See backend/server.js safe error handler.
- `403`: AIFP-* error envelope. See backend/server.js safe error handler.
- `404`: AIFP-* error envelope. See backend/server.js safe error handler.
- `429`: AIFP-* error envelope. See backend/server.js safe error handler.
- `5XX`: AIFP-* error envelope. See backend/server.js safe error handler.

---

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