---
title: "Start Agent Draft"
method: POST
path: "/agent-drafts"
tags: ["Agents"]
---

# Start Agent Draft

`POST /agent-drafts`

## Request

- Base URL: `https://zeronoise.ai/api/v1`
- URL: `https://zeronoise.ai/api/v1/agent-drafts`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- StartAgentDraftInput
  - `message` object, required
    - `text` string, required
    - `intent` 'edit_agent' | 'discover_sources', nullable
    - `references` ResourceReference[]: Initial draft messages do not support resource references.
      - `object` string, required
      - `id` string, required: Opaque identifier; clients must not parse its format.
  - `workspace_id` string: Opaque identifier; clients must not parse its format.

## Response `202`

Conversational Agent draft admitted

- AgentDraftAccepted
  - `operation` Operation, required
    - `id` string, required: Opaque identifier; clients must not parse its format.
    - `object` 'operation', required
    - `capability` string, required
    - `status` string, required
    - `subject` ResourceReference, nullable, required
      - `object` string, required
      - `id` string, required: Opaque identifier; clients must not parse its format.
    - `caused_by` ResourceReference, nullable
      - `object` string, required
      - `id` string, required: Opaque identifier; clients must not parse its format.
    - `progress` object, nullable
    - `result` union: Present when durable results exist. The capability determines the result family; fields may be absent on historical Operations.
      - AuthoringOperationResult, nullable
        - `agent` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `chat` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `message` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `references` ResourceReference[]
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `proposal` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `action_request` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `configuration_etag` string
        - `before_configuration_etag` string, nullable
        - `applied_effects` string[]
      - DiscoveryOperationResult
        - `outcome` string
        - `counts` object
          - `checked` integer
          - `ready` integer
          - `suggestions_ready` integer
        - `gaps` string[]
        - `stop_reason` string
        - `sources` object
          - `object` 'source_collection', required
          - `agent_id` string, required: Opaque identifier; clients must not parse its format.
          - `created_by_operation_id` string, required: Opaque identifier; clients must not parse its format.
          - `href` string, required
        - `created_pending` integer: Legacy result count.
        - `matched_existing` integer: Legacy result count.
        - `skipped` integer: Legacy result count.
        - `failed` integer: Legacy result count.
      - BriefOperationResult
        - `brief` ResourceReference, nullable
          - `object` string, required
          - `id` string, required: Opaque identifier; clients must not parse its format.
        - `href` string
      - SourceIngestionOperationResult
        - `total` integer
        - `processed` integer
        - `added` integer
        - `added_channels` integer
        - `added_web_sources` integer
        - `duplicate` integer
        - `invalid` integer
        - `errors` integer
    - `error` OperationError, nullable
      - `code` string, required
      - `message` string, required
    - `usage` OperationUsage, nullable
      - `amount_usd` string
      - `charged` boolean
    - `created_at` string, date-time, required
    - `started_at` string, date-time
    - `completed_at` string, date-time
    - `updated_at` string, date-time, required
    - `links` Links, required
  - `agent` Agent, required: Another organization's Agent is returned in a reader form without workspace_id, readiness, configuration, pending and rejected Source counts, or configuration and Chat links.
    - `id` string, required: Opaque identifier; clients must not parse its format.
    - `object` 'agent', required
    - `organization_id` string, required: Opaque identifier; clients must not parse its format.
    - `workspace_id` string: Opaque identifier; clients must not parse its format.
    - `created_by` ActorReference
      - `object` string, required
      - `id` string, required: Opaque identifier; clients must not parse its format.
      - `display_name` string, nullable
    - `configuration` AgentConfiguration
      - `name` string, nullable, required
      - `description` string, nullable, required
      - `goal` string, nullable, required
      - `instructions` string, nullable, required
      - `discovery_instructions` string, nullable, required: The Agent's standing source discovery instructions ("Source discovery instructions" in the web app). Discovery requests over the API pass their own.
      - `output` AgentOutput, required
        - `style` string, nullable, required
        - `language` string, nullable, required
      - `tasks` AgentTasks, required
        - `extract_information` AgentTask, required
          - `instructions` string, nullable, required
        - `generate_brief` AgentTask, required
          - `instructions` string, nullable, required
      - `schedule` AgentSchedule, required
        - `frequency` 'daily' | 'weekly', nullable, required
        - `time` string, nullable, required
        - `weekday` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday', nullable, required
        - `timezone` string, nullable, required
      - `transcription_mode` 'budget' | 'premium', required
      - `briefing_preset` 'economy' | 'standard' | 'advanced' | 'expert', required
      - `evidence_capabilities` AgentEvidenceCapabilities, required: Agent preferences for optional external evidence. Runtime availability may further narrow them.
        - `external_web` 'disabled' | 'on_demand', required
        - `image_analysis` 'disabled' | 'on_demand', required
    - `configuration_etag` string, nullable
    - `access_policy` string, required
    - `lifecycle` string, required
    - `source_summary` SourceSummary, required
      - `approved` integer, required
      - `pending` integer: Omitted for another organization's Agent.
      - `rejected` integer: Omitted for another organization's Agent.
    - `readiness` object: Omitted for another organization's Agent.
      - `finalization` AgentReadiness, required
        - `ready` boolean, required
        - `blockers` ReadinessBlocker[], required
          - `code` string, required
          - `path` string, nullable
          - `actual` integer, nullable
          - `minimum` integer, nullable
      - `activation` AgentReadiness, required
        - `ready` boolean, required
        - `blockers` ReadinessBlocker[], required
          - `code` string, required
          - `path` string, nullable
          - `actual` integer, nullable
          - `minimum` integer, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `links` Links, required
  - `chat` Chat, required: ZeroNoise-guided Agent authoring conversation, not a public Agent Q&A session.
    - `id` string, required: Opaque identifier; clients must not parse its format.
    - `object` 'chat', required
    - `agent_id` string, required: Opaque identifier; clients must not parse its format.
    - `kind` string, required
    - `title` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time
    - `links` Links, required

## Other responses

- `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)