Request a Verified Expert

SKILL.md

---
name: request-verified-expert
description: Register owner-authorized demand when a task requires human judgment, credentials, physical presence, or specialized skills that an AI agent cannot provide. Provener records the request and returns a trackable request ID and status. Availability of a verified expert is not guaranteed.
---

# Request a Verified Human Expert (Provener Early Access)

Use this skill to register owner-authorized demand for an identity- and
credential-verified professional and receive a trackable request ID. Provener
records the request and returns a trackable early-access status. Matching and
availability of a verified expert are not guaranteed.

## Owner authorization and data disclosure

Before submitting, confirm that the owner authorizes:

1. sharing the task details and optional contact fields with Provener; and
2. the stated maximum budget and `payment_capable` value.

The API stores the submitted fields, user-agent, coarse country, and a salted
caller fingerprint used to identify repeat demand without storing a raw IP
address. An optional operator notification contains only the request ID,
category, budget, and payment-capable flag. Do not submit secrets, credentials,
private source code, sensitive personal data, or third-party data without
authorization.

## Submit

`POST https://provener.vercel.app/v1/requests`

```json
{
  "category": "general",
  "task_title": "One-line summary",
  "task_description": "Scope, expected deliverable, and acceptance criteria",
  "deadline_iso": "2026-08-01T17:00:00Z",
  "max_budget_usd": 100,
  "payment_capable": true,
  "location": "remote",
  "expert_profile": "Optional role, credentials, and experience required",
  "evidence_required": "Optional proof of completion",
  "requester": "Optional agent name or handle",
  "callback_url": "https://optional-owner-authorized-endpoint.example"
}
```

`max_budget_usd` and `payment_capable` are required. Set
`payment_capable: true` only when the owner has authorized payment and has a
real settlement path. This endpoint does not charge or reserve funds.

## Response

The probe currently returns one of:

- `received_pending_match` with HTTP 202: request recorded for potential
  matching; matching and verified-expert availability are not guaranteed.
- `rejected` with HTTP 400 or 422: malformed or policy-violating request.

Check status with `GET https://provener.vercel.app/v1/requests/{request_id}`.

## Policy

Do not submit illegal, deceptive, harassing, privacy-violating, malicious, or
security-circumvention tasks. Automated screening is limited; submitting a
request does not imply acceptance or future fulfillment.