{ "openapi": "3.1.0", "info": { "title": "Mondo Pizzaiolo Assistant Connector", "version": "0.1.0", "description": "Pre-release, disabled by default. API documentation does not mean the provider integration has been activated or approved. All writes require exact end-user approval. Operator: Vomero LLC, Atlanta, Georgia.", "contact": { "name": "Mondo Pizzaiolo", "email": "mondopizzaiolo@gmail.com" } }, "servers": [ { "url": "https://mondopizzaiolo.com" } ], "paths": { "/api/agent": { "get": { "operationId": "readMarketplaceTool", "summary": "Read public information or the connected account", "description": "Use query op=read (default), and tool. Public tools require no token; private tools require their corresponding :read scope. Read calls do not send emails or mark messages read. Job search returns at most 20 records; title/country/currentness/pay filters give useful structured information, not just page links.", "x-muse-classification": "read", "security": [ {}, { "oauth": [] } ], "parameters": [ { "name": "op", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "read", "tools" ] } }, { "name": "tool", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "search_jobs", "job_details", "country_job_counts", "profile_options", "own_profile", "profile_readiness", "own_work_history", "own_applications", "own_messages", "own_interviews" ] } }, { "name": "id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "jobId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "withId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "employmentType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "style", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "roleLevel", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "package", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payMin", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payCurrency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payPeriod", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "payShown", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sponsorship", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "nearLat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "nearLon", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Verified handler result or explicit action status", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "201": { "description": "Prepared action saved, not executed", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing/expired authorization", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "Insufficient scope or missing human approval", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "Not found in connected account", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "409": { "description": "Changed source, reused idempotency key, or concurrency conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "Expired review", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "Native profile/application validation failed", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "Disabled, unconfigured, unavailable or uncertain", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "post": { "operationId": "prepareExecuteOrCheckAgentAction", "summary": "Prepare a write, execute a human-approved action, or check its status", "description": "prepare saves an encrypted draft, returns exact summary and approvalUrl; no message/application is sent. The user reviews that URL and approves the exact action themselves; never have an agent impersonate the human or send x-session-token. execute can run only that approved payload once. status returns prepared/approved/denied/running/completed/failed/uncertain. Running or uncertain is not success and must not be retried with a new idempotency key. This combined operation is sensitive because it includes execution.", "x-muse-classification": "sensitive_write", "x-openai-isConsequential": true, "security": [ { "oauth": [] } ], "parameters": [ { "name": "op", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "prepare", "execute", "status" ] } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "required": [ "tool", "args", "idempotencyKey" ], "properties": { "tool": { "type": "string", "enum": [ "save_profile", "save_application_preferences", "add_work_history", "submit_application", "send_message", "manage_interview" ] }, "args": { "type": "object", "additionalProperties": true, "description": "Exact fields supplied by the user, as documented in the tool catalog. Do not invent qualifications, consent, work history, visas or results." }, "idempotencyKey": { "type": "string", "pattern": "^[A-Za-z0-9_-]{16,128}$" } }, "additionalProperties": false }, { "type": "object", "required": [ "actionId" ], "properties": { "actionId": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "additionalProperties": false } ] } } } }, "responses": { "200": { "description": "Verified handler result or explicit action status", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "201": { "description": "Prepared action saved, not executed", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing/expired authorization", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "Insufficient scope or missing human approval", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "Not found in connected account", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "409": { "description": "Changed source, reused idempotency key, or concurrency conflict", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "Expired review", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "413": { "description": "Payload too large", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "Native profile/application validation failed", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "Disabled, unconfigured, unavailable or uncertain", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } } }, "components": { "securitySchemes": { "oauth": { "type": "oauth2", "flows": { "authorizationCode": { "authorizationUrl": "https://mondopizzaiolo.com/agent-connect.html", "tokenUrl": "https://mondopizzaiolo.com/api/agent-oauth?op=token", "scopes": { "profile:read": "Access only the connected account; writes still need human review", "profile:write": "Access only the connected account; writes still need human review", "applications:read": "Access only the connected account; writes still need human review", "applications:write": "Access only the connected account; writes still need human review", "messages:read": "Access only the connected account; writes still need human review", "messages:write": "Access only the connected account; writes still need human review", "interviews:read": "Access only the connected account; writes still need human review", "interviews:write": "Access only the connected account; writes still need human review" } } } } } } }