---
title: "Configure economic-nexus footprint"
method: POST
path: "/api/v1/nexus"
tags: ["Nexus"]
---

# Configure economic-nexus footprint

`POST /api/v1/nexus`

## Request

- Base URL: `https://www.agenttax.io`
- URL: `https://www.agenttax.io/api/v1/nexus`
- Auth: HTTP bearer

Sets the states the entity collects/reports tax in. Used by the daily nexus-monitor to compute approaching-threshold alerts (80% of revenue OR 200 tx).

## Request body

- NexusRequest
  - `nexus` object, required: State-code → { hasNexus, reason } map. Keys must be two-letter US state codes (DC included); lowercase is normalized to uppercase. MERGE semantics: only the states present in the map are written — states absent from the map are left unchanged, and an empty object is a no-op (it does NOT clear the footprint). To remove a state's assertion, send it with hasNexus:false.

## Response `200`

Nexus footprint updated.

## Other responses

- `400`: Validation failure
- `401`: Authentication required

---

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