---
title: "Add Agent Source"
method: POST
path: "/agents/{agent_id}/sources"
tags: ["Sources"]
---

# Add Agent Source

`POST /agents/{agent_id}/sources`

## Request

- Base URL: `https://zeronoise.ai/api/v1`
- URL: `https://zeronoise.ai/api/v1/agents/{agent_id}/sources`
- Auth: HTTP bearer

Requires sources:write. Adding an already approved Source with a fresh idempotency key returns 409 source_already_exists; replaying the original key returns its original response.

## Headers

- `Idempotency-Key` string, required

## Request body

- union: Supply exactly one identifier. source_id explicitly re-adds and approves a known Source belonging to this Agent, using existing materialized identity without URL ingestion. Normal permissions, upstream Agent access and source limits still apply.
  - object
    - `url` string, uri, required
  - object
    - `agent_id` string, required: Opaque identifier; clients must not parse its format.
  - object
    - `source_id` string, required: Opaque identifier; clients must not parse its format.

## Response `201`

Synchronous Agent-source relationship or explicit reactivation of a known Source

- Source
  - `id` string, required: Opaque identifier; clients must not parse its format.
  - `object` 'source', required
  - `agent_id` string, required: Opaque identifier; clients must not parse its format.
  - `status` string, required
  - `source_type` string, required
  - `title` string, nullable
  - `url` string, nullable
  - `source_agent_id` string: Opaque identifier; clients must not parse its format.
  - `created_by_operation_id` string: Opaque identifier; clients must not parse its format.
  - `created_at` string, date-time, required
  - `links` Links, required

## Other responses

- `202`: Asynchronous work admitted
- `default`: RFC 9457 problem response

---

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