{"components":{"responses":{"BadRequest":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request is invalid."},"Conflict":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request conflicts with current state or reuses an idempotency key with a different payload."},"Forbidden":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The key does not grant the required scope."},"NotFound":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The organization-scoped resource was not found."},"RateLimited":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The caller exceeded an API rate limit."},"Unauthorized":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key is missing, malformed, expired, revoked, or for another environment."}},"schemas":{"AgentRequest":{"additionalProperties":false,"properties":{"agent":{"additionalProperties":false,"description":"Present only when the request is available and the resulting version is published and entitled to the organization.","properties":{"id":{"type":"string"},"version":{"type":"string"}},"required":["id","version"],"type":"object"},"completion_criteria":{"type":["string","null"]},"created_at":{"format":"date-time","type":"string"},"decision":{"type":"string"},"expected_output":{"additionalProperties":true,"type":"object"},"form_url":{"description":"Hosted form the partner completes and submits. Present for API-created request drafts.","format":"uri","type":"string"},"id":{"type":"string"},"messages":{"items":{"$ref":"#/components/schemas/AgentRequestMessage"},"type":"array"},"name":{"type":"string"},"sample_inputs":{"items":{},"type":"array"},"specification":{"type":"string"},"state":{"enum":["submitted","draft","in_progress","needs_information","ready_for_review","available","rejected","failed"],"type":"string"},"systems":{"items":{"type":"string"},"type":"array"},"trigger":{"type":["string","null"]},"updated_at":{"format":"date-time","type":"string"}},"required":["id","state","name","specification","systems","expected_output","sample_inputs","messages","created_at","updated_at"],"type":"object"},"AgentRequestCreate":{"additionalProperties":false,"properties":{"completion_criteria":{"maxLength":5000,"type":"string"},"expected_output":{"additionalProperties":true,"maxProperties":100,"type":"object"},"name":{"description":"Short name for the requested capability.","maxLength":200,"minLength":1,"pattern":"\\S","type":"string"},"sample_inputs":{"items":{},"maxItems":10,"type":"array"},"specification":{"description":"Optional prefill for the hosted specification form. Do not include credentials or sensitive production data.","maxLength":20000,"minLength":1,"pattern":"\\S","type":"string"},"systems":{"items":{"maxLength":100,"minLength":1,"pattern":"\\S","type":"string"},"maxItems":50,"type":"array","uniqueItems":true},"trigger":{"maxLength":2000,"type":"string"}},"required":["name"],"type":"object"},"AgentRequestMessage":{"additionalProperties":false,"properties":{"author":{"enum":["partner","xy"],"type":"string"},"created_at":{"format":"date-time","type":"string"},"id":{"type":"string"},"message":{"type":"string"}},"required":["id","author","message","created_at"],"type":"object"},"AgentRequestMessageCreate":{"additionalProperties":false,"properties":{"message":{"maxLength":10000,"minLength":1,"pattern":"\\S","type":"string"}},"required":["message"],"type":"object"},"Error":{"properties":{"error":{"properties":{"code":{"example":"INVALID_REQUEST","type":"string"},"message":{"example":"The request could not be validated.","type":"string"}},"required":["code","message"],"type":"object"}},"required":["error"],"type":"object"},"HealthResponse":{"properties":{"service":{"example":"marketplace-api","type":"string"},"status":{"example":"healthy","type":"string"}},"required":["status","service"],"type":"object"},"Integration":{"additionalProperties":false,"properties":{"auth_type":{"enum":["OAUTH2","OAUTH1","API_KEY","BASIC_AUTH","BEARER_TOKEN","JWT","CUSTOM_AUTH","NONE","CLIENT_CREDENTIALS","OAUTH2_CC"],"type":"string"},"capabilities":{"items":{"$ref":"#/components/schemas/IntegrationCapability"},"type":"array"},"category":{"type":"string"},"description":{"type":["string","null"]},"documentation_url":{"format":"uri","type":["string","null"]},"id":{"type":"string"},"is_beta":{"type":"boolean"},"key":{"type":"string"},"name":{"type":"string"},"version":{"minimum":1,"type":"integer"}},"required":["id","key","name","description","category","auth_type","version","is_beta","documentation_url","capabilities"],"type":"object"},"IntegrationCapability":{"additionalProperties":false,"properties":{"description":{"type":["string","null"]},"input_schema":{"additionalProperties":true,"type":["object","null"]},"key":{"type":"string"},"name":{"type":"string"},"output_schema":{"additionalProperties":true,"type":["object","null"]},"requires_auth":{"type":"boolean"},"type":{"enum":["READ","WRITE","DELETE","SYNC","WEBHOOK","ACTION","SEARCH","EXPORT","IMPORT","BATCH"],"type":"string"}},"required":["key","name","description","type","requires_auth","input_schema","output_schema"],"type":"object"},"IntegrationCategoryList":{"additionalProperties":false,"properties":{"data":{"items":{"additionalProperties":false,"properties":{"count":{"minimum":1,"type":"integer"},"key":{"type":"string"}},"required":["key","count"],"type":"object"},"type":"array"}},"required":["data"],"type":"object"},"IntegrationConnection":{"additionalProperties":false,"properties":{"active":{"type":"boolean"},"connected_at":{"format":"date-time","type":["string","null"]},"credential_id":{"type":["string","null"]},"credential_source":{"enum":["none","vault"],"type":"string"},"id":{"type":"string"},"integration_key":{"type":["string","null"]},"label":{"type":["string","null"]},"last_error":{"type":["string","null"]},"status":{"type":"string"}},"required":["id","integration_key","label","status","active","credential_source","credential_id","connected_at","last_error"],"type":"object"},"IntegrationConnectionCreate":{"additionalProperties":false,"properties":{"config":{"additionalProperties":{"type":["string","number","integer","boolean","null"]},"description":"Optional bounded, non-secret fields declared by the integration config schema.","maxProperties":100,"type":"object"},"credential_id":{"description":"Required unless the integration auth type is NONE.","type":"string"},"label":{"maxLength":120,"type":"string"}},"type":"object"},"IntegrationConnectionList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/IntegrationConnection"},"type":"array"}},"required":["data"],"type":"object"},"IntegrationConnectionValidation":{"additionalProperties":false,"properties":{"id":{"type":"string"},"object":{"const":"integration_connection_validation","type":"string"},"valid":{"type":"boolean"},"validated_at":{"format":"date-time","type":"string"}},"required":["id","object","valid","validated_at"],"type":"object"},"IntegrationFactoryCapabilityTest":{"additionalProperties":false,"properties":{"capability_key":{"type":"string"},"capability_type":{"enum":["READ","WRITE","DELETE","SYNC","WEBHOOK","ACTION","SEARCH","EXPORT","IMPORT","BATCH"],"type":"string"},"completed_at":{"format":"date-time","type":"string"},"created_at":{"format":"date-time","type":"string"},"duration_ms":{"minimum":0,"type":"integer"},"error":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"expires_at":{"format":"date-time","type":"string"},"id":{"type":"string"},"method":{"type":"string"},"object":{"const":"integration_factory_capability_test","type":"string"},"result":{"additionalProperties":true,"description":"Bounded and secret-redacted capability execution result.","type":"object"},"run_id":{"type":"string"},"side_effecting":{"type":"boolean"},"started_at":{"format":"date-time","type":"string"},"status":{"enum":["queued","running","succeeded","failed","unknown"],"type":"string"}},"required":["id","object","run_id","capability_key","capability_type","method","side_effecting","status","created_at","expires_at"],"type":"object"},"IntegrationFactoryCapabilityTestCreate":{"additionalProperties":false,"properties":{"capability_key":{"maxLength":200,"minLength":1,"type":"string"},"confirm_side_effects":{"default":false,"description":"Must be true for capabilities that can create, update, delete, or otherwise change external data.","type":"boolean"},"credential_id":{"description":"Required unless the generated integration auth type is NONE.","type":"string"},"params":{"additionalProperties":true,"description":"Capability input parameters, limited to 128 KiB after JSON encoding.","type":"object"}},"required":["capability_key"],"type":"object"},"IntegrationFactoryDiscoveryCreate":{"additionalProperties":false,"oneOf":[{"required":["documentation_url"]},{"required":["documentation"]},{"required":["upload_id"]}],"properties":{"api_key_header":{"description":"Header used to send the stored API key; only valid with API_KEY.","maxLength":100,"pattern":"^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$","type":"string"},"api_name":{"maxLength":120,"minLength":1,"type":"string"},"auth_type":{"enum":["NONE","API_KEY","BASIC_AUTH","BEARER_TOKEN","CLIENT_CREDENTIALS"],"type":"string"},"base_path":{"pattern":"^/","type":"string"},"base_url":{"format":"uri","pattern":"^https://","type":"string"},"category":{"default":"CUSTOM","maxLength":100,"type":"string"},"custom_instructions":{"maxLength":8000,"type":"string"},"documentation":{"maxLength":100000,"minLength":1,"type":"string"},"documentation_url":{"format":"uri","pattern":"^https://","type":"string"},"key":{"maxLength":80,"pattern":"^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$","type":"string"},"upload_id":{"type":"string"}},"required":["api_name","key","auth_type"],"type":"object"},"IntegrationFactoryExtensionDiscoveryCreate":{"additionalProperties":false,"oneOf":[{"required":["documentation_url"]},{"required":["documentation"]},{"required":["upload_id"]}],"properties":{"custom_instructions":{"maxLength":8000,"type":"string"},"documentation":{"maxLength":100000,"minLength":1,"type":"string"},"documentation_url":{"format":"uri","pattern":"^https://","type":"string"},"upload_id":{"type":"string"}},"type":"object"},"IntegrationFactoryGenerationCreate":{"additionalProperties":false,"properties":{"auth_type":{"enum":["NONE","API_KEY","BASIC_AUTH","BEARER_TOKEN","CLIENT_CREDENTIALS"],"type":"string"},"base_path":{"pattern":"^/","type":"string"},"discovery_id":{"type":"string"},"endpoints":{"items":{"type":"string"},"maxItems":20,"minItems":1,"type":"array","uniqueItems":true}},"required":["discovery_id"],"type":"object"},"IntegrationFactoryRun":{"additionalProperties":false,"properties":{"auth_type":{"enum":["NONE","API_KEY","BASIC_AUTH","BEARER_TOKEN","CLIENT_CREDENTIALS"],"type":"string"},"capabilities":{"items":{"$ref":"#/components/schemas/IntegrationCapability"},"maxItems":20,"type":"array"},"capability_tests":{"items":{"additionalProperties":false,"properties":{"capability_key":{"type":"string"},"id":{"type":"string"},"side_effecting":{"type":"boolean"},"status":{"enum":["queued","running","succeeded","failed","unknown"],"type":"string"}},"required":["id","capability_key","side_effecting","status"],"type":"object"},"type":"array"},"connection_id":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"discovery":{"additionalProperties":false,"properties":{"endpoint_names":{"items":{"type":"string"},"maxItems":30,"minItems":1,"type":"array"},"proposed_base_path":{"type":["string","null"]},"proposed_base_url":{"format":"uri","type":["string","null"]},"proposed_key":{"type":"string"},"proposed_name":{"type":["string","null"]}},"required":["proposed_key","proposed_name","proposed_base_url","proposed_base_path","endpoint_names"],"type":"object"},"endpoint_count":{"maximum":30,"minimum":0,"type":"integer"},"error":{"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"expires_at":{"format":"date-time","type":"string"},"id":{"type":"string"},"integration":{"additionalProperties":false,"properties":{"id":{"type":"string"},"key":{"type":"string"},"status":{"type":"string"},"version":{"minimum":1,"type":"integer"}},"required":["id","key","version","status"],"type":"object"},"key":{"type":"string"},"name":{"type":"string"},"object":{"const":"integration_factory_run","type":"string"},"operation":{"enum":["create","extend"],"type":"string"},"phase":{"enum":["discovery","generation","validation","promotion","completed","failed"],"type":"string"},"required_capability_test_keys":{"items":{"type":"string"},"maxItems":20,"type":"array"},"state_version":{"minimum":1,"type":"integer"},"status":{"enum":["queued","discovering","awaiting_generation","generation_queued","generating","generated","validation_queued","validating","validated","promotion_queued","promoting","completed","failed"],"type":"string"},"updated_at":{"format":"date-time","type":"string"}},"required":["id","object","operation","status","phase","state_version","key","name","auth_type","endpoint_count","created_at","updated_at","expires_at"],"type":"object"},"IntegrationFactoryUpload":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"expires_at":{"format":"date-time","type":"string"},"file_name":{"type":"string"},"id":{"type":"string"},"object":{"const":"integration_factory_upload","type":"string"},"size_bytes":{"maximum":20971520,"minimum":1,"type":"integer"},"status":{"enum":["ready","consumed"],"type":"string"}},"required":["id","object","status","file_name","content_type","size_bytes","expires_at"],"type":"object"},"IntegrationFactoryUploadCreate":{"additionalProperties":false,"properties":{"content_type":{"enum":["application/json","application/pdf","application/vnd.openxmlformats-officedocument.wordprocessingml.document","application/yaml","application/x-yaml","text/markdown","text/plain","text/yaml"],"type":"string"},"file_name":{"maxLength":200,"minLength":1,"type":"string"}},"required":["file_name","content_type"],"type":"object"},"IntegrationFactoryUploadReservation":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"file_name":{"type":"string"},"id":{"type":"string"},"max_bytes":{"const":20971520,"type":"integer"},"object":{"const":"integration_factory_upload","type":"string"},"status":{"const":"pending","type":"string"},"upload":{"additionalProperties":false,"properties":{"expires_at":{"format":"date-time","type":"string"},"headers":{"additionalProperties":{"type":"string"},"type":"object"},"method":{"const":"PUT","type":"string"},"url":{"format":"uri","type":"string"}},"required":["method","url","headers","expires_at"],"type":"object"}},"required":["id","object","status","file_name","content_type","max_bytes","upload"],"type":"object"},"IntegrationFactoryValidationCreate":{"additionalProperties":false,"properties":{"credential_id":{"description":"Required unless the generated integration auth type is NONE.","type":"string"}},"type":"object"},"IntegrationList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Integration"},"type":"array"}},"required":["data"],"type":"object"},"SmsInbox":{"additionalProperties":false,"properties":{"created":{"description":"True only when this request purchased the number.","type":"boolean"},"message":{"type":"string"},"phone_number":{"description":"Organization default number in E.164 format.","pattern":"^\\+[1-9][0-9]{7,14}$","type":"string"},"provider":{"description":"Provider-neutral number type. Vendor details are managed by XY.","enum":["voip"],"type":"string"},"provider_managed":{"type":"boolean"},"status":{"enum":["active","external"],"type":"string"}},"required":["phone_number","provider","provider_managed","status","created","message"],"type":"object"},"SmsInboxMessage":{"additionalProperties":false,"properties":{"body":{"description":"Sensitive inbound message body. Do not log or persist it unnecessarily.","type":"string"},"from_number":{"type":"string"},"id":{"description":"Opaque provider message identifier.","type":"string"},"received_at_ms":{"description":"Provider receive time as Unix milliseconds.","minimum":0,"type":"integer"},"to_number":{"pattern":"^\\+[1-9][0-9]{7,14}$","type":"string"}},"required":["id","from_number","to_number","body","received_at_ms"],"type":"object"},"SmsInboxMessages":{"additionalProperties":false,"properties":{"messages":{"description":"Matching messages ordered newest first.","items":{"$ref":"#/components/schemas/SmsInboxMessage"},"maxItems":50,"type":"array"},"phone_number":{"pattern":"^\\+[1-9][0-9]{7,14}$","type":"string"},"provider":{"enum":["voip"],"type":"string"}},"required":["phone_number","provider","messages"],"type":"object"},"SmsInboxProvisionRequest":{"additionalProperties":false,"properties":{"area_code":{"description":"Optional preferred three-digit area code. Availability is provider-dependent.","pattern":"^[0-9]{3}$","type":"string"},"country_code":{"default":"US","description":"Country for the dedicated number. The first release supports US numbers.","enum":["US"],"type":"string"}},"type":"object"},"WorkflowExecution":{"additionalProperties":false,"properties":{"status":{"description":"Accepted runtime state, or the current durable state on an idempotent replay.","example":"running","type":"string"},"status_url":{"description":"Relative URL for safe activity-phase status.","type":"string"},"workflow_definition_id":{"type":"string"},"workflow_instance_id":{"type":"string"}},"required":["workflow_definition_id","workflow_instance_id","status","status_url"],"type":"object"},"WorkflowExecutionCreate":{"additionalProperties":false,"properties":{"input":{"additionalProperties":true,"default":{},"description":"Runtime input for this run. Omit it to use the definition's input template.","type":"object"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"bearerFormat":"XY API key","description":"Paste the complete organization-scoped key returned by XY.","scheme":"bearer","type":"http"}}},"info":{"contact":{"name":"XY support","url":"https://www.xy.ai/contact"},"description":"Build organization-scoped integrations with XY agents, workflows, and governed operations. Create an API key in **XY \u2192 Organization settings \u2192 API Keys**, then select **Authorize** and enter the full bearer value. Keys are environment-bound and responses never expose stored secrets.\n\nStart with `GET /api/v1/auth/check`, then discover agents with `GET /api/v1/agents`. Use `Idempotency-Key` on create and command routes so retries are safe.","title":"XY Developer API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/agent-requests":{"post":{"description":"Create an organization-scoped draft and receive a hosted form URL. Send the partner to that form to complete and submit the specification before XY reviews it.\n\n**Required scope:** `agent_requests:write`","operationId":"marketplace_api_create_agent_request","parameters":[{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRequestCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRequest"}}},"description":"The custom-agent request draft and its hosted partner form were created.","headers":{"Link":{"description":"Hosted partner form URL with rel=\"form\".","schema":{"type":"string"}},"Location":{"description":"Relative URL of the accepted request.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested polling delay in seconds.","schema":{"example":5,"type":"integer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Create a hosted request draft","tags":["Custom agent requests"]}},"/api/v1/agent-requests/{request_id}":{"get":{"description":"Read the original specification, public delivery state, conversation history, and resulting published agent identity when available.\n\n**Required scope:** `agent_requests:read`","operationId":"marketplace_api_get_agent_request","parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRequest"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get an agent request","tags":["Custom agent requests"]}},"/api/v1/agent-requests/{request_id}/messages":{"post":{"description":"Answer an XY clarification or add context. A reply to needs_information returns the request to in_progress; terminal requests reject new messages.\n\n**Required scope:** `agent_requests:write`","operationId":"marketplace_api_create_agent_request_message","parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRequestMessageCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRequestMessage"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Add a request message","tags":["Custom agent requests"]}},"/api/v1/agents":{"get":{"description":"List the published agents available to this organization.\n\n**Required scope:** `agents:read`","operationId":"marketplace_api_list_agents","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List available agents","tags":["Agent catalog"]}},"/api/v1/agents/{agent_id}":{"get":{"description":"Read one agent and the versions available to install.\n\n**Required scope:** `agents:read`","operationId":"marketplace_api_get_agent","parameters":[{"in":"path","name":"agent_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get an agent","tags":["Agent catalog"]}},"/api/v1/agents/{agent_id}/installations":{"post":{"description":"Create an organization-scoped installation of an exact agent version.\n\n**Required scope:** `installations:write`","operationId":"marketplace_api_create_installation","parameters":[{"in":"path","name":"agent_id","required":true,"schema":{"type":"string"}},{"description":"Exact semantic version to install.","in":"query","name":"agent_version","required":false,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Install an agent","tags":["Installations"]}},"/api/v1/agents/{agent_id}/metrics":{"get":{"description":"Query governed metrics for one published agent over an optional time window.\n\n**Required scope:** `metrics:read`","operationId":"marketplace_api_get_agent_metrics","parameters":[{"in":"path","name":"agent_id","required":true,"schema":{"type":"string"}},{"description":"Inclusive ISO-8601 start time.","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Exclusive ISO-8601 end time.","in":"query","name":"to","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get agent metrics","tags":["Analytics"]}},"/api/v1/agents/{agent_id}/metrics/dashboards":{"get":{"description":"List approved presentation-ready metric views available for an agent.\n\n**Required scope:** `metrics:read`","operationId":"marketplace_api_list_agent_metric_dashboards","parameters":[{"in":"path","name":"agent_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List agent metric views","tags":["Analytics"]}},"/api/v1/agents/{agent_id}/metrics/dashboards/{dashboard_id}":{"get":{"description":"Return visualization metadata and aliased tile data that a partner can render in its own UI.\n\n**Required scope:** `metrics:read`","operationId":"marketplace_api_render_agent_metric_dashboard","parameters":[{"in":"path","name":"agent_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"dashboard_id","required":true,"schema":{"type":"string"}},{"description":"Inclusive ISO-8601 start time.","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Exclusive ISO-8601 end time.","in":"query","name":"to","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get an agent metric view","tags":["Analytics"]}},"/api/v1/auth/check":{"get":{"description":"Verify the bearer key and return its environment and granted scopes without exposing organization or secret data.","operationId":"marketplace_api_check_authentication","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Check an API key","tags":["Authentication"]}},"/api/v1/browser/sessions":{"post":{"description":"Create a retained authoring session for one Planner browser step.\n\n**Required scope:** `browser:write`","operationId":"marketplace_api_create_browser_session","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Create a browser session","tags":["Browser Studio"]}},"/api/v1/browser/sessions/{session_id}":{"delete":{"description":"Close a retained authoring session and release its browser capacity.\n\n**Required scope:** `browser:write`","operationId":"marketplace_api_close_browser_session","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Close a browser session","tags":["Browser Studio"]},"get":{"description":"Read session state and refresh its short-lived viewer link.\n\n**Required scope:** `browser:read`","operationId":"marketplace_api_get_browser_session","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get a browser session","tags":["Browser Studio"]}},"/api/v1/browser/sessions/{session_id}/apply":{"post":{"description":"Return the current draft to its Planner step for testing and review.\n\n**Required scope:** `browser:write + planner:write`","operationId":"marketplace_api_apply_browser_draft","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Apply a browser draft","tags":["Browser Studio"]}},"/api/v1/browser/sessions/{session_id}/cdp":{"post":{"description":"Run a raw Chrome DevTools Protocol command. This privileged surface can inspect authenticated browser state.\n\n**Required scope:** `browser:debug`","operationId":"marketplace_api_run_browser_cdp_command","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Run a CDP command","tags":["Browser Studio"]}},"/api/v1/browser/sessions/{session_id}/commands":{"post":{"description":"Run a deployed Studio command, including endpoint observation and API-map tools.\n\n**Required scope:** `browser:write`","operationId":"marketplace_api_run_browser_command","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Run a browser command","tags":["Browser Studio"]}},"/api/v1/browser/sessions/{session_id}/control":{"post":{"description":"Change a retained session between human and shared control.\n\n**Required scope:** `browser:control`","operationId":"marketplace_api_control_browser_session","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Change session control","tags":["Browser Studio"]}},"/api/v1/browser/sessions/{session_id}/draft":{"get":{"description":"Read the current reusable activity draft from a retained session.\n\n**Required scope:** `browser:read`","operationId":"marketplace_api_get_browser_draft","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get the activity draft","tags":["Browser Studio"]}},"/api/v1/browser/sessions/{session_id}/prompts":{"post":{"description":"Ask Browser Copilot to author, inspect, or debug the current step.\n\n**Required scope:** `browser:write`","operationId":"marketplace_api_prompt_browser_session","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Prompt Browser Copilot","tags":["Browser Studio"]}},"/api/v1/browser/sessions/{session_id}/prompts/cancel":{"post":{"description":"Cancel the active Browser Copilot prompt.\n\n**Required scope:** `browser:write`","operationId":"marketplace_api_cancel_browser_prompt","parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Cancel a Copilot prompt","tags":["Browser Studio"]}},"/api/v1/browser/tools":{"get":{"description":"List safe commands supported by the retained Browser Studio runtime.\n\n**Required scope:** `browser:read`","operationId":"marketplace_api_list_browser_tools","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List browser tools","tags":["Browser Studio"]}},"/api/v1/credentials":{"get":{"description":"List secret-free metadata for credential references available to workflows.\n\n**Required scope:** `credentials:read`","operationId":"marketplace_api_list_credentials","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List credentials","tags":["Runtime credentials"]},"post":{"description":"Create a secret-backed credential reference. Secret values are never returned later.\n\n**Required scope:** `credentials:write`","operationId":"marketplace_api_create_credential","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Create a credential","tags":["Runtime credentials"]}},"/api/v1/credentials/{credential_id}":{"delete":{"description":"Revoke the reference and invalidate browser sessions that depend on it.\n\n**Required scope:** `credentials:write`","operationId":"marketplace_api_revoke_credential","parameters":[{"in":"path","name":"credential_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Revoke a credential","tags":["Runtime credentials"]},"get":{"description":"Read secret-free metadata for one credential reference.\n\n**Required scope:** `credentials:read`","operationId":"marketplace_api_get_credential","parameters":[{"in":"path","name":"credential_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get a credential","tags":["Runtime credentials"]}},"/api/v1/credentials/{credential_id}/rotations":{"post":{"description":"Rotate password, TOTP, PIN, phone, or note fields for a credential reference.\n\n**Required scope:** `credentials:write`","operationId":"marketplace_api_rotate_credential","parameters":[{"in":"path","name":"credential_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Rotate a credential","tags":["Runtime credentials"]}},"/api/v1/dashboard-agent/query":{"post":{"description":"Ask a read-only analytics question about organization workflow data.\n\n**Required scope:** `dashboards:read`","operationId":"marketplace_api_query_dashboard_agent","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Query governed analytics","tags":["Analytics"]}},"/api/v1/executions":{"get":{"description":"List this organization's public execution records with optional filters and pagination.\n\n**Required scope:** `executions:read`","operationId":"marketplace_api_list_executions","parameters":[{"description":"Optional execution-status filter.","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"Optional agent filter.","in":"query","name":"agent_id","required":false,"schema":{"type":"string"}},{"description":"Optional installation filter.","in":"query","name":"installation_id","required":false,"schema":{"type":"string"}},{"description":"Page size.","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"Zero-based page offset.","in":"query","name":"offset","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List executions","tags":["Executions"]}},"/api/v1/executions/{execution_id}":{"get":{"description":"Read status, result, or safe failure information for one execution.\n\n**Required scope:** `executions:read`","operationId":"marketplace_api_get_execution","parameters":[{"in":"path","name":"execution_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get an execution","tags":["Executions"]}},"/api/v1/executions/{execution_id}/phases":{"get":{"description":"Read safe activity phases for a Marketplace execution without controlling the run.\n\n**Required scope:** `executions:read`","operationId":"marketplace_api_get_execution_phases","parameters":[{"in":"path","name":"execution_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get execution phases","tags":["Run observability"]}},"/api/v1/installations/{installation_id}":{"get":{"description":"Read provisioning, connection, and readiness state for an installation.\n\n**Required scope:** `installations:read`","operationId":"marketplace_api_get_installation","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get an installation","tags":["Installations"]}},"/api/v1/installations/{installation_id}/authorization-actions":{"get":{"description":"List current and previous authorization actions for an installation.\n\n**Required scope:** `installations:read`","operationId":"marketplace_api_list_authorization_actions","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List authorization actions","tags":["Installations"]},"post":{"description":"Start an OAuth or connection authorization action required by an installation.\n\n**Required scope:** `installations:write`","operationId":"marketplace_api_create_authorization_action","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Start authorization","tags":["Installations"]}},"/api/v1/installations/{installation_id}/executions":{"post":{"description":"Start an asynchronous run of an installed agent. Poll the returned status URL for completion.\n\n**Required scope:** `executions:write`","operationId":"marketplace_api_create_execution","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Start an agent execution","tags":["Executions"]}},"/api/v1/installations/{installation_id}/metrics":{"get":{"description":"Query governed metrics for one installation over an optional time window.\n\n**Required scope:** `metrics:read`","operationId":"marketplace_api_get_installation_metrics","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}},{"description":"Inclusive ISO-8601 start time.","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Exclusive ISO-8601 end time.","in":"query","name":"to","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get installation metrics","tags":["Analytics"]}},"/api/v1/installations/{installation_id}/metrics/dashboards":{"get":{"description":"List approved presentation-ready metric views available for an installation.\n\n**Required scope:** `metrics:read`","operationId":"marketplace_api_list_installation_metric_dashboards","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List installation metric views","tags":["Analytics"]}},"/api/v1/installations/{installation_id}/metrics/dashboards/{dashboard_id}":{"get":{"description":"Return visualization metadata and aliased tile data that a partner can render in its own UI.\n\n**Required scope:** `metrics:read`","operationId":"marketplace_api_render_installation_metric_dashboard","parameters":[{"in":"path","name":"dashboard_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}},{"description":"Inclusive ISO-8601 start time.","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Exclusive ISO-8601 end time.","in":"query","name":"to","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get an installation metric view","tags":["Analytics"]}},"/api/v1/installations/{installation_id}/provisioning-retries":{"post":{"description":"Retry an installation whose provisioning did not complete.\n\n**Required scope:** `installations:write`","operationId":"marketplace_api_create_provisioning_retry","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Retry provisioning","tags":["Installations"]}},"/api/v1/installations/{installation_id}/sources":{"get":{"description":"List the knowledge sources attached to an installation.\n\n**Required scope:** `installations:read`","operationId":"marketplace_api_list_sources","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List sources","tags":["Knowledge sources"]},"post":{"description":"Create an upload target for a file-backed knowledge source.\n\n**Required scope:** `installations:write`","operationId":"marketplace_api_create_source","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Create a source upload","tags":["Knowledge sources"]}},"/api/v1/installations/{installation_id}/sources/{source_id}":{"delete":{"description":"Remove a knowledge source from an installation.\n\n**Required scope:** `installations:write`","operationId":"marketplace_api_delete_source","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"source_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Delete a source","tags":["Knowledge sources"]},"get":{"description":"Read upload and indexing state for one knowledge source.\n\n**Required scope:** `installations:read`","operationId":"marketplace_api_get_source","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"source_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get a source","tags":["Knowledge sources"]}},"/api/v1/installations/{installation_id}/sources/{source_id}/complete":{"post":{"description":"Mark a direct upload complete so ingestion and indexing can begin.\n\n**Required scope:** `installations:write`","operationId":"marketplace_api_complete_source_upload","parameters":[{"in":"path","name":"installation_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"source_id","required":true,"schema":{"type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Complete a source upload","tags":["Knowledge sources"]}},"/api/v1/integrations":{"get":{"description":"List live global and organization-owned integrations with safe capability schemas.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_list_integrations","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationList"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List integrations","tags":["Integrations"]}},"/api/v1/integrations/catalog":{"get":{"description":"Read the integration catalog in a partner-friendly representation.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_get_integration_catalog","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationList"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get the integration catalog","tags":["Integrations"]}},"/api/v1/integrations/categories":{"get":{"description":"List categories represented in the organization's visible integration catalog.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_list_integration_categories","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationCategoryList"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List integration categories","tags":["Integrations"]}},"/api/v1/integrations/connections":{"get":{"description":"List secret-free organization service connections available to workflows.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_list_integration_connections","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationConnectionList"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List connections","tags":["Integration connections"]}},"/api/v1/integrations/connections/{connection_id}":{"delete":{"description":"Deactivate an organization service connection without deleting its encrypted credential.\n\n**Required scope:** `integrations:connect`","operationId":"marketplace_api_delete_integration_connection","parameters":[{"in":"path","name":"connection_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Disconnect an integration","tags":["Integration connections"]}},"/api/v1/integrations/connections/{connection_id}/validate":{"post":{"description":"Run a safe read-only credential probe without returning response data or vault material.\n\n**Required scope:** `integrations:connect`","operationId":"marketplace_api_validate_integration_connection","parameters":[{"in":"path","name":"connection_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationConnectionValidation"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Validate a connection","tags":["Integration connections"]}},"/api/v1/integrations/factory/discoveries":{"post":{"description":"Start durable endpoint discovery from one HTTPS URL, pasted document, or completed private upload.\n\n**Required scope:** `integrations:generate`","operationId":"marketplace_api_create_factory_discovery","parameters":[{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryDiscoveryCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryRun"}}},"description":"Request completed successfully.","headers":{"Idempotency-Replayed":{"description":"True when this response reused an earlier request claim.","schema":{"type":"boolean"}},"Location":{"description":"Relative URL of the durable factory run.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested polling delay in seconds.","schema":{"example":2,"type":"integer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Start discovery","tags":["Integration Factory"]}},"/api/v1/integrations/factory/discoveries/{run_id}":{"get":{"description":"Read the durable discovery projection and endpoint choices.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_get_factory_discovery","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryRun"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get discovery","tags":["Integration Factory"]}},"/api/v1/integrations/factory/discoveries/{run_id}/events":{"get":{"description":"Replay or stream organization-scoped factory events.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_list_factory_discovery_events","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"description":"Return events after this numeric cursor.","in":"query","name":"after","required":false,"schema":{"type":"string"}},{"description":"Maximum replay events to return.","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"Set true to continue as a server-sent event stream.","in":"query","name":"stream","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Read discovery events","tags":["Integration Factory"]}},"/api/v1/integrations/factory/generations":{"post":{"description":"Generate capability definitions for selected discovered endpoints. Requires If-Match with the discovery state version.\n\n**Required scope:** `integrations:generate`","operationId":"marketplace_api_create_factory_generation","parameters":[{"description":"The integer state_version from the latest factory run representation.","in":"header","name":"If-Match","required":true,"schema":{"minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryGenerationCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryRun"}}},"description":"Request completed successfully.","headers":{"Location":{"description":"Relative URL of the durable factory run.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested polling delay in seconds.","schema":{"example":2,"type":"integer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Start generation","tags":["Integration Factory"]}},"/api/v1/integrations/factory/generations/{run_id}":{"get":{"description":"Read generated capabilities, validation state, promotion state, and the resulting connection id.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_get_factory_generation","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryRun"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get generation","tags":["Integration Factory"]}},"/api/v1/integrations/factory/generations/{run_id}/capability-tests":{"post":{"description":"Durably execute one generated capability before promotion. Write, action, and delete capabilities require explicit side-effect confirmation. Requires Idempotency-Key and If-Match.\n\n**Required scope:** `integrations:generate`","operationId":"marketplace_api_create_factory_capability_test","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}},{"description":"The integer state_version from the latest factory run representation.","in":"header","name":"If-Match","required":true,"schema":{"minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryCapabilityTestCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryCapabilityTest"}}},"description":"Request completed successfully.","headers":{"Idempotency-Replayed":{"description":"True when this response reused an earlier request claim.","schema":{"type":"boolean"}},"Location":{"description":"Relative URL of the durable factory run.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested polling delay in seconds.","schema":{"example":2,"type":"integer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Test a generated capability","tags":["Integration Factory"]}},"/api/v1/integrations/factory/generations/{run_id}/capability-tests/{test_id}":{"get":{"description":"Read the encrypted-at-rest, organization-scoped result of a generated capability test.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_get_factory_capability_test","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"test_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryCapabilityTest"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get a capability test","tags":["Integration Factory"]}},"/api/v1/integrations/factory/generations/{run_id}/events":{"get":{"description":"Replay or stream the full factory lifecycle event history.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_list_factory_generation_events","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"description":"Return events after this numeric cursor.","in":"query","name":"after","required":false,"schema":{"type":"string"}},{"description":"Maximum replay events to return.","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"Set true to continue as a server-sent event stream.","in":"query","name":"stream","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Read generation events","tags":["Integration Factory"]}},"/api/v1/integrations/factory/generations/{run_id}/promote":{"post":{"description":"Atomically make the validated and explicitly tested version live only for the requesting organization. Global promotion is unavailable through the public API.\n\n**Required scope:** `integrations:promote`","operationId":"marketplace_api_promote_factory_generation","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"description":"The integer state_version from the latest factory run representation.","in":"header","name":"If-Match","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryRun"}}},"description":"Request completed successfully.","headers":{"Location":{"description":"Relative URL of the durable factory run.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested polling delay in seconds.","schema":{"example":2,"type":"integer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Promote a generation","tags":["Integration Factory"]}},"/api/v1/integrations/factory/generations/{run_id}/validations":{"post":{"description":"Validate structure and execute safe runtime probes using an organization-owned encrypted credential reference.\n\n**Required scope:** `integrations:generate`","operationId":"marketplace_api_create_factory_validation","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"description":"The integer state_version from the latest factory run representation.","in":"header","name":"If-Match","required":true,"schema":{"minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryValidationCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryRun"}}},"description":"Request completed successfully.","headers":{"Location":{"description":"Relative URL of the durable factory run.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested polling delay in seconds.","schema":{"example":2,"type":"integer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Validate a generation","tags":["Integration Factory"]}},"/api/v1/integrations/factory/uploads":{"post":{"description":"Create a short-lived signed upload target for private API documentation. Document bytes never pass through the API process.\n\n**Required scope:** `integrations:generate`","operationId":"marketplace_api_create_factory_upload","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryUploadCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryUploadReservation"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Create a document upload","tags":["Integration Factory"]}},"/api/v1/integrations/factory/uploads/{upload_id}/complete":{"post":{"description":"Verify the uploaded document's content type and bounded size before discovery can consume it.\n\n**Required scope:** `integrations:generate`","operationId":"marketplace_api_complete_factory_upload","parameters":[{"in":"path","name":"upload_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryUpload"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Complete a document upload","tags":["Integration Factory"]}},"/api/v1/integrations/{type_key}":{"get":{"description":"Read one visible integration and its executable capability contracts.\n\n**Required scope:** `integrations:read`","operationId":"marketplace_api_get_integration","parameters":[{"in":"path","name":"type_key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Integration"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get an integration","tags":["Integrations"]}},"/api/v1/integrations/{type_key}/connections":{"post":{"description":"Attach an organization-owned encrypted credential reference to a live integration.\n\n**Required scope:** `integrations:connect`","operationId":"marketplace_api_create_integration_connection","parameters":[{"in":"path","name":"type_key","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationConnectionCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationConnection"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Create a connection","tags":["Integration connections"]}},"/api/v1/integrations/{type_key}/factory/discoveries":{"post":{"description":"Start a durable extension run for an organization-owned integration. The resulting draft inherits unchanged live capabilities.\n\n**Required scope:** `integrations:generate`","operationId":"marketplace_api_create_factory_extension_discovery","parameters":[{"in":"path","name":"type_key","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryExtensionDiscoveryCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationFactoryRun"}}},"description":"Request completed successfully.","headers":{"Idempotency-Replayed":{"description":"True when this response reused an earlier request claim.","schema":{"type":"boolean"}},"Location":{"description":"Relative URL of the durable factory run.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested polling delay in seconds.","schema":{"example":2,"type":"integer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Discover additional capabilities","tags":["Integration Factory"]}},"/api/v1/planner/builds":{"get":{"description":"List durable builds with cursor pagination and optional status filtering.\n\n**Required scope:** `planner:read`","operationId":"marketplace_api_list_planner_builds","parameters":[{"description":"Maximum builds to return.","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"Opaque cursor from the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Optional build-status filter.","in":"query","name":"status","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List Planner builds","tags":["Workflow Planner"]},"post":{"description":"Queue a durable workflow build from a natural-language request and structured context.\n\n**Required scope:** `planner:write`","operationId":"marketplace_api_start_planner_build","parameters":[{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Start a Planner build","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}":{"get":{"description":"Read current build state, step decisions, and version information.\n\n**Required scope:** `planner:read`","operationId":"marketplace_api_get_planner_build","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get a Planner build","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/abandon":{"post":{"description":"Stop work on a build while retaining its durable audit history.\n\n**Required scope:** `planner:write`","operationId":"marketplace_api_abandon_planner_build","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Abandon a build","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/events":{"get":{"description":"Replay durable build events by cursor or follow them as a server-sent event stream.\n\n**Required scope:** `planner:read`","operationId":"marketplace_api_list_planner_events","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"description":"Return events after this numeric cursor.","in":"query","name":"after","required":false,"schema":{"type":"string"}},{"description":"Maximum replay events to return.","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"Set true to continue as a server-sent event stream.","in":"query","name":"stream","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Read Planner events","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/export":{"get":{"description":"Download the compiled workflow bundle for a build.\n\n**Required scope:** `planner:export`","operationId":"marketplace_api_export_planner_build","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Export a build","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/promote":{"post":{"description":"Explicitly promote a completed, reviewed build into a reusable workflow definition.\n\n**Required scope:** `planner:promote`","operationId":"marketplace_api_promote_planner_build","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Promote a build","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/resume":{"post":{"description":"Resume a paused or recoverable Planner build.\n\n**Required scope:** `planner:write`","operationId":"marketplace_api_resume_planner_build","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Resume a build","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/steps/{step_number}/actions":{"post":{"description":"Accept, reject, test, retry, or message one step using optimistic state versioning.\n\n**Required scope:** `planner:write`","operationId":"marketplace_api_act_on_planner_step","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"step_number","required":true,"schema":{"type":"integer"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Act on a Planner step","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/steps/{step_number}/assist":{"post":{"description":"Ask the workflow editor to help repair or improve one step.\n\n**Required scope:** `planner:write`","operationId":"marketplace_api_assist_planner_step","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"step_number","required":true,"schema":{"type":"integer"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Request step assistance","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/steps/{step_number}/browser-session":{"get":{"description":"Mint a short-lived noVNC observer link for the browser currently generating or testing this Planner step. This does not start a browser.\n\n**Required scope:** `planner:view`","operationId":"marketplace_api_get_planner_browser_session","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"step_number","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get the current Planner browser","tags":["Planner browser view"]}},"/api/v1/planner/builds/{build_id}/steps/{step_number}/browser-session/control":{"post":{"description":"Switch the current Planner generation or test browser between human and shared control.\n\n**Required scope:** `planner:control`","operationId":"marketplace_api_control_planner_browser_session","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"step_number","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Change browser control","tags":["Planner browser view"]}},"/api/v1/planner/builds/{build_id}/steps/{step_number}/cancel":{"post":{"description":"Cancel a currently running test for one Planner step.\n\n**Required scope:** `planner:write`","operationId":"marketplace_api_cancel_planner_step","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"step_number","required":true,"schema":{"type":"integer"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Cancel a step test","tags":["Workflow Planner"]}},"/api/v1/planner/builds/{build_id}/template":{"post":{"description":"Save a completed build as a reusable workflow template.\n\n**Required scope:** `planner:promote`","operationId":"marketplace_api_save_planner_template","parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Save a build as a template","tags":["Workflow Planner"]}},"/api/v1/review-items":{"get":{"description":"List durable items waiting for a person, optionally filtered by agent, installation, or execution.\n\n**Required scope:** `review_items:read`","operationId":"marketplace_api_list_review_items","parameters":[{"description":"Optional agent filter.","in":"query","name":"agent_id","required":false,"schema":{"type":"string"}},{"description":"Optional installation filter.","in":"query","name":"installation_id","required":false,"schema":{"type":"string"}},{"description":"Optional execution filter.","in":"query","name":"execution_id","required":false,"schema":{"type":"string"}},{"description":"Page size.","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"Zero-based page offset.","in":"query","name":"offset","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List review items","tags":["Human review"]}},"/api/v1/review-items/decisions":{"post":{"description":"Approve or reject one or more review items with an optional audit note.\n\n**Required scope:** `review_items:write`","operationId":"marketplace_api_decide_review_items","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Submit review decisions","tags":["Human review"]}},"/api/v1/schedules":{"get":{"description":"List recurring schedules for promoted workflow definitions.\n\n**Required scope:** `schedules:read`","operationId":"marketplace_api_list_schedules","parameters":[{"description":"Page size.","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"Zero-based page offset.","in":"query","name":"offset","required":false,"schema":{"type":"string"}},{"description":"Set true to return only paused schedules.","in":"query","name":"paused_only","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"List schedules","tags":["Schedules"]}},"/api/v1/sms-inbox":{"post":{"description":"Idempotently purchase the organization's first dedicated SMS-capable number, or return the existing default number without purchasing another. Additional numbers are not available through the public API.\n\n**Required scope:** `credentials:write`","operationId":"marketplace_api_provision_sms_inbox","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsInboxProvisionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsInbox"}}},"description":"The existing default organization number was returned; no number was purchased.","headers":{"Location":{"description":"Canonical relative URL of the default SMS inbox.","schema":{"example":"/api/v1/sms-inbox","type":"string"}}}},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsInbox"}}},"description":"A dedicated organization number was purchased and configured.","headers":{"Location":{"description":"Canonical relative URL of the default SMS inbox.","schema":{"example":"/api/v1/sms-inbox","type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The provider or organization credential vault could not complete provisioning."}},"security":[{"bearerAuth":[]}],"summary":"Provision the default SMS inbox","tags":["SMS inbox"]}},"/api/v1/sms-inbox/messages":{"get":{"description":"Read recent messages delivered to the caller organization's dedicated VoIP number. The shared real-SIM inbox is never exposed through this route.\n\n**Required scope:** `sms:read`","operationId":"marketplace_api_list_sms_inbox_messages","parameters":[{"description":"Return only messages received strictly after this Unix timestamp in milliseconds.","in":"query","name":"after_ms","required":false,"schema":{"minimum":0,"type":"integer"}},{"description":"Maximum messages to return, from 1 through 50.","in":"query","name":"limit","required":false,"schema":{"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsInboxMessages"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The dedicated inbox provider could not be read."}},"security":[{"bearerAuth":[]}],"summary":"Read dedicated inbox messages","tags":["SMS inbox"]}},"/api/v1/usage":{"get":{"description":"Read organization-level Planner, Integration Factory, browser, and shared model quota consumption.\n\n**Required scope:** `usage:read`","operationId":"marketplace_api_get_marketplace_usage","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get Marketplace usage","tags":["Usage"]}},"/api/v1/usage/planner":{"get":{"description":"Read organization-level Planner, browser, and model quota consumption.\n\n**Required scope:** `usage:read`","operationId":"marketplace_api_get_planner_usage","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get Planner usage","tags":["Usage"]}},"/api/v1/workflow-definitions/{workflow_definition_id}/executions":{"post":{"description":"Start one asynchronous run of an eligible promoted workflow definition with optional runtime input. Coalescing singleton definitions are not eligible. This does not create or modify a recurring schedule.\n\n**Required scope:** `executions:write`","operationId":"marketplace_api_create_workflow_execution","parameters":[{"in":"path","name":"workflow_definition_id","required":true,"schema":{"type":"string"}},{"description":"A unique 1-200 character key. Reusing it safely replays the original command result.","in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":200,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowExecutionCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowExecution"}}},"description":"The one-off workflow execution was accepted.","headers":{"Idempotency-Replayed":{"description":"True when this response reused an earlier request claim.","schema":{"type":"boolean"}},"Location":{"description":"Relative URL for the accepted run's safe phase projection.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested polling delay in seconds.","schema":{"example":2,"type":"integer"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The idempotency key conflicts with an earlier request, or the definition uses a coalescing singleton execution mode that is not eligible for one-off execution."},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The workflow runtime could not accept the execution."}},"security":[{"bearerAuth":[]}],"summary":"Start a workflow execution","tags":["Workflow executions"]}},"/api/v1/workflow-definitions/{workflow_definition_id}/schedule":{"delete":{"description":"Delete the schedule without deleting its workflow definition.\n\n**Required scope:** `schedules:write`","operationId":"marketplace_api_delete_schedule","parameters":[{"in":"path","name":"workflow_definition_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Delete a schedule","tags":["Schedules"]},"get":{"description":"Read a workflow definition's schedule and recent actions.\n\n**Required scope:** `schedules:read`","operationId":"marketplace_api_get_schedule","parameters":[{"in":"path","name":"workflow_definition_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get a schedule","tags":["Schedules"]},"patch":{"description":"Update cron, frozen input, overlap policy, or operator note.\n\n**Required scope:** `schedules:write`","operationId":"marketplace_api_update_schedule","parameters":[{"in":"path","name":"workflow_definition_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Update a schedule","tags":["Schedules"]},"post":{"description":"Create a recurring schedule for a promoted workflow definition.\n\n**Required scope:** `schedules:write`","operationId":"marketplace_api_create_schedule","parameters":[{"in":"path","name":"workflow_definition_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Create a schedule","tags":["Schedules"]}},"/api/v1/workflow-definitions/{workflow_definition_id}/schedule/pause":{"post":{"description":"Pause future actions without deleting the schedule.\n\n**Required scope:** `schedules:write`","operationId":"marketplace_api_pause_schedule","parameters":[{"in":"path","name":"workflow_definition_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Pause a schedule","tags":["Schedules"]}},"/api/v1/workflow-definitions/{workflow_definition_id}/schedule/resume":{"post":{"description":"Resume future actions for a paused schedule.\n\n**Required scope:** `schedules:write`","operationId":"marketplace_api_resume_schedule","parameters":[{"in":"path","name":"workflow_definition_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Resume a schedule","tags":["Schedules"]}},"/api/v1/workflow-definitions/{workflow_definition_id}/schedule/trigger":{"post":{"description":"Start the scheduled compiled workflow immediately.\n\n**Required scope:** `schedules:write`","operationId":"marketplace_api_trigger_schedule","parameters":[{"in":"path","name":"workflow_definition_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"description":"Endpoint-specific JSON object. Expand the description and guides before sending production data.","type":"object"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Trigger a schedule","tags":["Schedules"]}},"/api/v1/workflow-runs/{workflow_instance_id}/phases":{"get":{"description":"Read safe activity phases for an exact workflow run.\n\n**Required scope:** `executions:read`","operationId":"marketplace_api_get_workflow_phases","parameters":[{"in":"path","name":"workflow_instance_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Request completed successfully."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"security":[{"bearerAuth":[]}],"summary":"Get workflow phases","tags":["Run observability"]}},"/health":{"get":{"description":"Confirm that the public Marketplace API process is running.","operationId":"marketplace_health","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}},"description":"The service is healthy."}},"security":[],"summary":"Check service health","tags":["Health"]}}},"servers":[{"description":"Current environment","url":"/"}],"tags":[{"description":"Validate organization-scoped bearer credentials before making capability calls.","name":"Authentication"},{"description":"Discover productized agents published to your organization.","name":"Agent catalog"},{"description":"Configure exact agent versions and the connections they need.","name":"Installations"},{"description":"Upload and manage files used by knowledge-backed agents.","name":"Knowledge sources"},{"description":"Start installed agents and poll their public execution records.","name":"Executions"},{"description":"Read durable review work and submit explicit human decisions.","name":"Human review"},{"description":"Inspect safe workflow phases without changing the run.","name":"Run observability"},{"description":"Run promoted workflow definitions on demand.","name":"Workflow executions"},{"description":"Query governed workflow analytics and render approved metrics.","name":"Analytics"},{"description":"Operate recurring runs of promoted workflow definitions.","name":"Schedules"},{"description":"Build, review, test, export, and explicitly promote reusable workflows.","name":"Workflow Planner"},{"description":"Observe or briefly control the browser currently used by a Planner generation or step test.","name":"Planner browser view"},{"description":"Develop one browser step in a retained Chrome authoring session.","name":"Browser Studio"},{"description":"Manage secret-backed references without returning stored credential values.","name":"Runtime credentials"},{"description":"Browse global and organization-owned executable integration contracts.","name":"Integrations"},{"description":"Attach encrypted credential references to integrations for workflow execution.","name":"Integration connections"},{"description":"Discover, generate, validate, and promote organization-scoped integrations through durable jobs.","name":"Integration Factory"},{"description":"Provision and inspect the dedicated organization number used by browser workflows for SMS verification.","name":"SMS inbox"},{"description":"Inspect organization-level capacity and quota consumption.","name":"Usage"},{"description":"Request custom work outside the published agent catalog.","name":"Custom agent requests"},{"description":"Public service readiness.","name":"Health"}]}