XY Developer Platform

Automate complex operations with XY.

Install production-ready agents, build organization-scoped workflows, or give XY a guided specification and let us deliver the automation.

Choose a path REST API & schemas MCP tools Manage API keys

Three delivery paths

Choose the result you actually need.

Start with the catalog when it fits. Create a missing API integration from its docs, then use the Planner agent, Browser Studio, credentials, schedules, and observability when your team wants control. When you want XY to own delivery, redirect the partner to the guided specification UI.

1. Use a catalog agent

Discover an Invoice Processing agent, or configure your own Knowledge Base agent with your organization’s sources. Install and run either through REST or MCP.

Explore catalog agents

2. Build a workflow isolated within your XY organization

Use the Integration Factory when an API is missing, then let the Planner agent combine organization-owned capabilities with browser steps, transforms, schedules, and run observability.

Build with the platform

3. Ask XY to build an agent

Create a request, then redirect the partner to the returned secure UI. Guided questions produce a precise specification that XY uses to build and deliver the custom agent.

See the XY-built path

Implementation guides

Guides explain the workflow. The reference defines the contract.

These guides explain how the resources work together and where the current API boundary is. The interactive reference remains the source of truth for exact routes and fields.

Choose the right surface

Understand agents, installations, executions, Planner agent builds, definitions, schedules, MCP, scopes, and custom requests.

Open guide

Create a missing API integration

Turn public or private API docs into validated, organization-owned capabilities, then use them in a durable workflow.

Open guide

Build a workflow in your XY organization

Build, test, accept, promote, schedule, and observe a workflow isolated within your XY organization.

Open guide

Design a workflow queue

Release preview: not yet available in production. After the Queue UI routes and tools are deployed, compare previews and publish after human review or explicitly scoped system approval. Verify the live contract before use.

Open guide

Develop a browser activity

Attach Browser Studio to a Planner agent browser step, observe portal endpoints, and return the draft to the Planner agent.

Open guide

Handle credentials and MFA

Create a secure credential reference, bind it to an API integration or Planner agent, use MFA gates, then rotate without rebuilding.

Open guide

Quick start

Your first request takes three steps.

01Create an API key in Organization settings.
02Store it in your server-side secret manager.
03Verify the key, then discover available agents.

Platform guide REST API reference MCP setup guide

Terminal

export XY_API_BASE='https://api.xy.ai/api/v1'
export XY_API_KEY='xy_prod_…'


curl --fail-with-body \
  --header "Authorization: Bearer ${XY_API_KEY}" \
  "${XY_API_BASE}/auth/check"


curl --fail-with-body \
  --header "Authorization: Bearer ${XY_API_KEY}" \
  "${XY_API_BASE}/agents"