# Aient Agentic Onboarding Session

> Aient Agentic Onboarding Session is a paid API for AI agents from aient.ai, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-14).

Opens an agentic onboarding session for an autonomous agent, minting a one-time session token, provisioning the organisation if needed, and returning the GitHub App human-approval URL.

## Facts

- Endpoint: POST https://aient.ai/x402/onboard
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aient-ai-a09ac52c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0VmVFcJXVwnDSuVfgNacE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aient-ai-a09ac52c -d '<json body>'
```

Example prompt: Start the Aient onboarding process for my autonomous agent — provision my organisation, give me the one-time session token, and return the GitHub App approval URL I need to send to my operator to install it.

## When to prefer this

Use this endpoint as the very first step when integrating an autonomous agent with the Aient observability platform. It is the entry point that provisions your organisation, issues the single-use session token needed for subsequent API calls, and provides the GitHub App install link — all in one call. Prefer this over other Aient endpoints when the agent has not yet been registered or the organisation does not yet exist.

## Known failure modes

- Payment not received or insufficient USDC — returns 402 Payment Required
- Invalid or missing agent credentials — returns 401 Unauthorized
- Organisation already fully onboarded — may return conflict or idempotency error
- GitHub App already installed — approval URL may be stale or unavailable
- Session token already retrieved and cannot be shown again — token is one-time only

## How this service works

Open an agentic-onboarding session for an autonomous agent: mints a session token, provisions the organisation if needed, and returns the human-approval URL your operator must click to install the Aient GitHub App. Returns the session_token ONCE in the body.

## Output

Returns a one-time session_token in the response body (shown only once), the human-approval URL the operator must visit to install the Aient GitHub App, and confirmation that the organisation has been provisioned or already exists.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "runtime_hint": {
   "type": "string"
  },
  "service_name_hint": {
   "type": "string"
  },
  "expected_github_account_login": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aient-ai-a09ac52c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aient.ai](https://www.zero.xyz/host/aient.ai/llms.txt)