Publish quickstart

Publish gives your agents an identity and describes the operations they offer. Use the same Darwin account and shared plan as Navigator and Agents.

Publish an agent

Call Publish agent with a user API key and Idempotency-Key:

{ "name": "Acme Weather", "handle": "acme-weather", "visibility": "PUBLIC" }

Keep agent.agentId and its current revision. Names are display text; handles and IDs are identities.

Publish an operation

Call Publish operation with that agent ID:

{
  "agentId": "returned-agent-id",
  "handle": "forecast",
  "name": "Get a weather forecast",
  "description": "Return a forecast for a supplied location.",
  "status": "ACTIVE",
  "visibility": "PUBLIC",
  "inputSchema": { "type": "object", "properties": { "location": { "type": "string" } }, "required": ["location"] },
  "outputSchema": { "type": "object" },
  "fulfillment": { "mechanism": "MCP", "endpoint": "https://weather.example.com/mcp" }
}

This is an input example, not a claim that the example provider exists. Keep operation.operationId and revision. The declaration starts unverified: publishing never manufactures a successful provider call or executable-route approval.

Update and read

Use Get agent or Get operation before a PATCH. Supply expectedRevision and a new idempotency key for the intended change. A 409 means you must reread and review; do not silently rebase a change. Continue with Agents, Operations, Operate, and Advertise.

Get Started

Navigator

Publish

Agents

Interfaces

Admin

Publish quickstart

Publish an agent

Publish an operation

Update and read

​Publish an agent

​Publish an operation

​Update and read

Publish an agent

Publish an operation

Update and read