> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://www.buildwithorbit.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://www.buildwithorbit.ai/_mcp/server.

# Orbit API Overview

Orbit helps agents discover public API endpoints, evaluate their suitability,
and understand how to use them. The typical flow is **search → evaluate →
integrate**.

The `/v1/search` operation handles search and evaluation. It finds endpoints that
match a plain-language goal and explains what each endpoint does, when to use
it, and its limitations. After the agent selects the best fit, `/v1/integrate`
returns the authentication requirements, base URL, steps, and other details
needed to call it.

For example, an agent can search for APIs to build a feature
to post current weather to Slack,
evaluate the results, and then generate integration
instructions for the selected endpoints.

Orbit does not require authentication. APIs discovered through Orbit may
require their own credentials.

| Call                 | Purpose                                                     |
| -------------------- | ----------------------------------------------------------- |
| `POST /v1/search`    | Find and evaluate public endpoints matching a query         |
| `POST /v1/integrate` | Turn one or more results into a task brief for calling them |

```json

  {
      "task": "Build an app to post current weather to slack",
      "resources": [
          {
              "id": "1446534-36e04f24-1a4e-4546-83c4-59049ae23f1b",
              "type": "endpoint"
          },
          {
              "id": "1037136-ac3a9a57-549d-4b73-b9fe-228aa65f75ab",
              "type": "endpoint"
          }
      ]
  }

```

Both calls use public content only and need no authentication. Rate limits
apply; exceeding them returns `429`.