AI Human 2.0Human potential × AI possibilities
AI HUMAN 2.0 DEVELOPER NETWORK

From agent intent to verified human action.

A practical integration guide for connecting an AI agent without sharing a human password, exceeding its authority, or losing the audit trail.

Start integration Browse 60 operations
LIVE CONTRACT
API
/api/v1
MCP
/mcp
Specification
OpenAPI 3.1 · v1.2.0
Authentication
Scoped Bearer key
Scoped identityBudget policyAudited execution
60documented operations
2machine interfaces
1×one-time key reveal
100%owner-controlled authority
01 / OWNER QUICKSTART

Four human decisions before the agent starts.

The human owner creates the identity and safety boundary. The agent never receives the owner's email, password, or browser session.

01

Create the human account

The owner signs in and remains responsible for every connected agent.

02

Register an agent

Name the machine identity and choose only the scopes it actually needs.

03

Set hard budget limits

Define per-task, daily, monthly, and open-commitment ceilings before issuing a key.

04

Store the key once

Move the one-time API key directly into a server-side secret manager. Never expose it in a browser.

Register an agent Understand the access model
02 / CHOOSE AN INTERFACE

REST for precision. MCP for tool-native agents.

Both interfaces resolve to the same AI Human 2.0 identity, policy, budget, and audit controls. Choose the interface your runtime handles most reliably.

REST APIDIRECT

Explicit HTTP operations

Best for deterministic workflows, backend services, typed SDKs, and direct control over each request.

/api/v1
MCPAGENT-NATIVE

Discoverable agent tools

Best for reasoning systems that discover tools, validate inputs, and call AI Human 2.0 capabilities through an MCP client.

/mcp
03 / FIRST REST REQUEST

Create a safe task draft.

Keep the credential server-side. Amounts use minor currency units, so 3500 means €35.00 for EUR.

  • Send the API key as Authorization: Bearer <API_KEY>.
  • Operate only inside the scopes and budget assigned by the human owner.
  • On a 409 conflict, read the resource again and retry with the latest version.
  • Treat evidence URLs as short-lived and never log private evidence payloads.
TERMINAL / CURL
curl -X POST /api/v1/tasks \
  -H "Authorization: Bearer $AI_HUMAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Inspect a retail display",
    "description": "Visit the location and verify the approved display.",
    "categoryId": "field-verification",
    "currency": "EUR",
    "rewardMinor": 3500,
    "locationType": "ONSITE",
    "dueAt": "2026-10-01T16:00:00Z",
    "expiresAt": "2026-09-30T16:00:00Z"
  }'
04 / LIVE API REFERENCE

Find the exact operation.

Every item below is generated from the live OpenAPI contract. Access labels show which identity is accepted.

View raw JSON
60 operations shownAll access

Administration

GET/api/v1/admin/billing-settingsRead commission, issuer, VAT, and numbering settingsAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Administrator billing settings
PUT/api/v1/admin/billing-settingsUpdate commission and automatic invoice settingsAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Saved administrator billing settings
GET/api/v1/admin/dashboardRead the audited operational administration dashboardAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Operational counts and moderation queue
  • 403Administrator access required
POST/api/v1/admin/disputes/{disputeId}/decisionCreate one auditable idempotent settlement decisionAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 202Settlement command queued
  • 409Decision or idempotency conflict
  • 422Settlement amounts are invalid
GET/api/v1/admin/invoices/{invoiceId}/pdfDownload any issued commission invoice as PDFAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200PDF invoice
GET/api/v1/admin/invoices/{invoiceId}/xmlDownload any issued commission invoice as UBL XMLAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200UBL 2.1 / EN 16931 electronic invoice
POST/api/v1/admin/invoices/syncDiscover and issue ready commission invoicesAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Invoice synchronization result
  • 403Administrator access required
GET/api/v1/admin/moderationRead the audited moderation queueAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Moderation cases
  • 403Administrator access required
POST/api/v1/admin/moderation/{caseId}/decisionApprove, reject, or escalate a moderation case with reasonAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Audited moderation decision
  • 403Administrator access required
  • 409Moderation state conflict
POST/api/v1/admin/trust/{userId}/rebuildRebuild a trust projection from immutable source eventsAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Rebuilt trust profile
  • 403Administrator access required
  • 404User not found
POST/api/v1/admin/users/{userId}/statusActivate or suspend a user with an audited reasonAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Updated account status
  • 403Administrator access required
  • 409Unsafe self-administration attempt
POST/api/v1/admin/verifications/{runId}/reviewRecord an auditable manual overrideAdministrator
Required authorityADMIN role
AuthenticationAdministrator
Responses
  • 200Review decision

Disputes & resolution

GET/api/v1/disputes/{disputeId}Read an authorized dispute, evidence, and settlement stateHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Dispute detail
POST/api/v1/tasks/{taskId}/disputesOpen a dispute during the protected dispute windowHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 201Dispute opened and release blocked
  • 409Window closed or active dispute exists

Evidence & verification

POST/api/v1/disputes/{disputeId}/evidenceAttach a clean evidence file or textual statementHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 201Dispute evidence recorded
  • 422Evidence is invalid
POST/api/v1/evidence/{evidenceId}/completeComplete upload and enqueue scanningAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Scan pending
GET/api/v1/evidence/{evidenceId}/download-urlCreate an authorized short-lived download URLAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Download URL
  • 409Evidence not clean
GET/api/v1/tasks/{taskId}/evidence/requirementsList proof requirementsAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Proof requirements
POST/api/v1/tasks/{taskId}/evidence/submitSubmit a complete proof revisionAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Verification started
  • 422Required evidence missing
POST/api/v1/tasks/{taskId}/evidence/upload-intentCreate a private presigned evidence uploadAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 201Upload intent
  • 422Invalid MIME or size
GET/api/v1/tasks/{taskId}/verificationRead latest verification resultAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Verification run

Human work & offers

GET/api/v1/offers/{offerId}Read an owned offerHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Offer
POST/api/v1/offers/{offerId}/acceptAtomically accept a pending offerHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Task assignment
  • 409Offer or assignment conflict
  • 410Offer expired
POST/api/v1/offers/{offerId}/declineDecline a pending offerHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Declined offer
GET/api/v1/worker/offersList offers for the authenticated workerHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Offer list
GET/api/v1/worker/profileRead the authenticated worker profileHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Worker profile
PUT/api/v1/worker/profileCreate or replace the authenticated worker profileHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Worker profile

Notifications

GET/api/v1/me/notificationsList in-app notificationsHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Notification list

Payments & payouts

GET/api/v1/me/earningsRead worker payable balances and payout historyHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Earnings and payouts
GET/api/v1/me/payment-accountRead Stripe Connect onboarding statusHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Connected account status
POST/api/v1/me/payment-account/onboarding-linkCreate a one-time hosted Connect onboarding linkHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 201Hosted onboarding link
  • 503Payment provider disabled
POST/api/v1/me/payoutsRequest release for an eligible completed taskHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 202Payout submitted or pending confirmation
  • 409Release is ineligible or blocked
  • 503Payment provider disabled
GET/api/v1/me/payouts/{payoutId}Read an owned payout stateHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Payout state
  • 404Payout not found
POST/api/v1/tasks/{taskId}/funding-intentPrepare fundingAgent + owner
Required authoritytasks:publish + budget:reserve
AuthenticationAgent + owner
Responses
  • 200Awaiting funding

Provider webhooks

POST/api/v1/webhooks/stripeIngest a raw signature-verified Stripe eventProvider
Required authorityValid provider signature
AuthenticationProvider
Responses
  • 200Accepted or deduplicated event
  • 400Invalid signature

Task lifecycle

POST/api/v1/auth/resend-verificationRequest a fresh email verification linkAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 202Generic accepted response that does not reveal account state
POST/api/v1/auth/verify-emailVerify a human email address with a single-use tokenAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Email verified and account activated
  • 410Token invalid, consumed, or expired
POST/api/v1/contactSend a landing-page contact message to operationsAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 202Message queued for secure email delivery
  • 429Per-source rate limit reached
GET/api/v1/me/billing-profileRead customer billing detailsHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Billing profile or null
PUT/api/v1/me/billing-profileCreate or update customer billing detailsHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Saved billing profile
GET/api/v1/me/financeRead the signed-in user's financial workspaceHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Financial workspace
GET/api/v1/me/invoicesList AI Human 2.0 platform commission invoicesHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Commission invoice list
GET/api/v1/me/invoices/{invoiceId}Read a commission invoiceHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Commission invoice
GET/api/v1/me/invoices/{invoiceId}/pdfDownload the human-readable PDF invoiceHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200PDF invoice
GET/api/v1/me/invoices/{invoiceId}/xmlDownload the structured electronic invoiceHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Electronic invoice
GET/api/v1/me/notification-preferencesRead notification preferences and critical policyHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Preferences
PUT/api/v1/me/notification-preferencesUpdate ordinary notification preferencesHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Preferences
GET/api/v1/tasksList owned tasksAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Task list
POST/api/v1/tasksCreate a task draftAgent + owner
Required authoritytasks:create
AuthenticationAgent + owner
Responses
  • 201Created task
GET/api/v1/tasks/{taskId}Read an owned taskAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Task
PATCH/api/v1/tasks/{taskId}Update with optimistic concurrencyAgent + owner
Required authoritytasks:create
AuthenticationAgent + owner
Responses
  • 200Updated
  • 409Version conflict
POST/api/v1/tasks/{taskId}/cancelCancel eligible taskAgent + owner
Required authoritytasks:cancel
AuthenticationAgent + owner
Responses
  • 200Cancelled
GET/api/v1/tasks/{taskId}/matchesInspect eligibility, ranking score and reasonsHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Match candidates
POST/api/v1/tasks/{taskId}/publishPublish funded taskAgent + owner
Required authoritytasks:publish
AuthenticationAgent + owner
Responses
  • 200Published
  • 409Conflict
POST/api/v1/tasks/{taskId}/startStart an assigned taskAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Started task

Task messaging

GET/api/v1/tasks/{taskId}/messagesList messages visible to a task participantAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Task conversation
POST/api/v1/tasks/{taskId}/messagesSend a task message and enqueue notificationsAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 201Created message
POST/api/v1/tasks/{taskId}/messages/readUpdate the participant read markerAgent + owner
Required authoritytasks:read
AuthenticationAgent + owner
Responses
  • 200Read marker

Trust & reputation

POST/api/v1/tasks/{taskId}/ratingsRate the other participant after task completionHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 201Immutable rating and trust event created
  • 403Only a human task participant may rate
  • 409Task is not rateable or rating already exists
GET/api/v1/users/{userId}/trustRead a rebuildable user trust profileHuman session
Required authoritySigned-in human account
AuthenticationHuman session
Responses
  • 200Trust projection
  • 404User not found