{"openapi":"3.1.0","info":{"title":"Omentir Agent API","version":"1.0.0","description":"Workspace-scoped API for AI agents acting on behalf of an Omentir customer. Use tokens created in Settings > AI Agents."},"servers":[{"url":"https://omentir.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/api/agent/v1/context":{"get":{"summary":"Read workspace setup, product profile, counts, and agent entrypoints.","responses":{"200":{"description":"Workspace context"}}}},"/api/agent/v1/stats":{"get":{"summary":"Read dashboard headline metrics: total leads, hot opportunities, invitations sent, messages sent, replies received, and pipeline generated.","responses":{"200":{"description":"Workspace stats"}}}},"/api/agent/v1/linkedin-accounts":{"get":{"summary":"List connected LinkedIn accounts available for agents and campaigns.","responses":{"200":{"description":"LinkedIn account list"}}}},"/api/agent/v1/enrollments":{"get":{"summary":"List campaign enrollments (per-lead outreach progress), optionally filtered by campaignId.","parameters":[{"name":"campaignId","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Enrollment list"}}}},"/api/agent/v1/activity":{"get":{"summary":"List recent automation activity runs (the workspace activity feed).","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Activity run list"}}}},"/api/agent/v1/mcp":{"get":{"summary":"Inspect the authenticated MCP-style endpoint and available tool names.","responses":{"200":{"description":"MCP endpoint metadata"}}},"post":{"summary":"Call Omentir tools with JSON-RPC methods initialize, tools/list, and tools/call.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"enum":["initialize","tools/list","tools/call"]},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC response"}}}},"/api/agent/v1/agents":{"get":{"summary":"List AI discovery agents in the token workspace.","responses":{"200":{"description":"Agent list"}}},"post":{"summary":"Create a discovery agent and its target lead group.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["groupName"],"properties":{"name":{"type":"string"},"groupName":{"type":"string"},"linkedInAccountId":{"type":"string"},"mode":{"enum":["signals","filters","prompt"],"default":"signals"},"prompt":{"type":"string"},"filters":{"type":"object"},"signalSources":{"type":"object"}}}}}},"responses":{"201":{"description":"Created agent"}}}},"/api/agent/v1/product-profile":{"get":{"summary":"Read the workspace product profile used for ICP and message personalization.","responses":{"200":{"description":"Product profile"}}},"put":{"summary":"Update the workspace product profile.","responses":{"200":{"description":"Updated product profile"}}}},"/api/agent/v1/campaigns":{"get":{"summary":"List campaigns and lead groups.","responses":{"200":{"description":"Campaign and group list"}}},"post":{"summary":"Create a LinkedIn campaign. Defaults to draft for human review.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","steps"],"properties":{"name":{"type":"string"},"groupId":{"type":"string"},"groupName":{"type":"string"},"linkedInAccountId":{"type":"string"},"status":{"enum":["draft","active"],"default":"draft"},"steps":{"type":"array","items":{"oneOf":[{"type":"object","required":["id","type"],"properties":{"id":{"type":"string"},"type":{"const":"connect"},"includeNote":{"type":"boolean"},"noteTemplate":{"type":"string"}}},{"type":"object","required":["id","type","delayMinutes"],"properties":{"id":{"type":"string"},"type":{"const":"wait"},"delayMinutes":{"type":"integer"}}},{"type":"object","required":["id","type"],"properties":{"id":{"type":"string"},"type":{"const":"message"},"messageTemplate":{"type":"string"}}}]}}}}}}},"responses":{"201":{"description":"Created campaign"}}}},"/api/agent/v1/leads":{"get":{"summary":"List discovered leads, optionally filtered by groupId.","parameters":[{"name":"groupId","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lead list"}}}},"/api/agent/v1/conversations":{"get":{"summary":"List recent Omentir conversations and captured replies.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Conversation list"}}}},"/api/agent/v1/automation/dry-run":{"post":{"summary":"Run a workspace-scoped readiness preview for automation.","responses":{"200":{"description":"Readiness report"}}}}}}