---
title: "Generate adagents.json"
method: POST
path: "/api/adagents/create"
tags: ["Validation Tools"]
---

# Generate adagents.json

`POST /api/adagents/create`

Generate a valid adagents.json file from authorized agents and/or catalog content. `authorized_agents` may be empty for a catalog-only community mirror that publishes formats/properties/placements for a platform that has not adopted AdCP.

## Request body

- object
  - `authorized_agents` AdagentsAuthorizedAgent[], required
    - `url` string, uri, required — Agent endpoint URL.
    - `authorized_for` string
    - `authorization_type` 'property_ids' | 'property_tags' | 'inline_properties' | 'publisher_properties' | 'signal_ids' | 'signal_tags'
    - `property_ids` string[]
    - `property_tags` string[]
    - `properties` object[]
    - `publisher_properties` object[]
      - `publisher_domain` string
      - `publisher_domains` string[]
      - `selection_type` 'all' | 'by_id' | 'by_tag', required
      - `property_ids` string[]
      - `property_tags` string[]
    - `collections` object[]
      - `publisher_domain` string, required
      - `collection_ids` string[], required
    - `placement_ids` string[]
    - `placement_tags` string[]
    - `delegation_type` 'direct' | 'delegated' | 'ad_network'
    - `exclusive` boolean
    - `countries` string[]
    - `effective_from` string
    - `effective_until` string
    - `signal_ids` string[]
    - `signal_tags` string[]
    - `signing_keys` object[]
  - `include_schema` boolean
  - `include_timestamp` boolean
  - `properties` unknown[]
    - unknown
  - `catalog_etag` string
  - `formats` unknown[]
    - unknown
  - `placements` unknown[]
    - unknown
  - `placement_tags` object

## Response `200`

Generated adagents.json

- CreateAdagentsResponse
  - `success` true, required
  - `data` object, required
    - `success` true, required
    - `adagents_json` string, required — Pretty-printed adagents.json document generated by the service.
    - `validation` AdagentsValidationResult, required
      - `valid` boolean, required
      - `errors` AdagentsValidationIssue[], required
        - `field` string, required
        - `message` string, required
        - `severity` 'error', required
      - `warnings` AdagentsValidationWarning[], required
        - `field` string, required
        - `message` string, required
        - `suggestion` string
      - `domain` string, required
      - `url` string, required
      - `status_code` integer
      - `response_bytes` integer
      - `resolved_url` string
      - `raw_data` unknown
      - `discovery_method` 'direct' | 'authoritative_location' | 'ads_txt_managerdomain' | 'adagents_authoritative', required
      - `manager_domain` string
  - `timestamp` string, date-time, required

---

[API](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) · [All operations](https://skmtc.net/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adcontextprotocol/agenticadvertising-org-registry-api/revisions/9ea7fedf54c0/schema)