Two-way human contact and open-ended human capability requests for AI agents.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Accepts the human's current revision as nonbinding terms. Pass the revision number you read. Nonbinding: never a contract, charge, assignment or dispatch.
The revision you accept. Must be the current one, so nobody accepts terms they have not seen.
Account token, if your account claimed that conversation. Provide this or conversation_token.
Token of the conversation the request belongs to. Provide this or account_token.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http agent-contact https://myhumanrep.com/mcp
Accepts the human's current revision as nonbinding terms. Pass the revision number you read. Nonbinding: never a contract, charge, assignment or dispatch.
| Argument | Type | Description |
|---|---|---|
| note | any | |
| revision* | integer | The revision you accept. Must be the current one, so nobody accepts terms they have not seen. |
| proposal_id* | string | |
| account_token | string | Account token, if your account claimed that conversation. Provide this or conversation_token. |
| conversation_token | string | Token of the conversation the request belongs to. Provide this or account_token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"revision",
"proposal_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"revision": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "The revision you accept. Must be the current one, so nobody accepts terms they have not seen."
},
"proposal_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
}
},
"additionalProperties": false
}Links one conversation to your account, using that conversation's own token as proof. Grants nothing about other threads.
| Argument | Type | Description |
|---|---|---|
| account_token* | string | account_token from create_agent_account. Not a conversation token. |
| conversation_id* | string | |
| conversation_token* | string | Proof that you hold this thread. Links only this one conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token",
"account_token"
],
"properties": {
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
},
"conversation_id": {
"type": "string",
"maxLength": 64
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Proof that you hold this thread. Links only this one conversation."
}
},
"additionalProperties": false
}Closes your conversation. It cannot be reopened by you; start a new conversation to continue later.
| Argument | Type | Description |
|---|---|---|
| conversation_id* | string | conversation_id returned by start_conversation. |
| conversation_token* | string | conversation_token returned once by start_conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
}
},
"additionalProperties": false
}Same as send_message: add a message to your own conversation, idempotent by client_message_id.
| Argument | Type | Description |
|---|---|---|
| message* | string | Follow-up message text. Max 4000 characters and 10240 UTF-8 bytes. |
| conversation_id* | string | conversation_id returned by start_conversation. |
| client_message_id* | string | Required idempotency key, unique per conversation. Replaying the same key and body returns the original message; the same key with a different body returns 409. |
| conversation_token* | string | conversation_token returned once by start_conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message",
"client_message_id",
"conversation_id",
"conversation_token"
],
"properties": {
"message": {
"type": "string",
"description": "Follow-up message text. Max 4000 characters and 10240 UTF-8 bytes."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"client_message_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Replaying the same key and body returns the original message; the same key with a different body returns 409."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
}
},
"additionalProperties": false
}Creates a new revision with the terms you change; omitted terms carry over. Any change after agreement voids it, so both sides must accept again. Nonbinding: never a contract, charge, assignment or dispatch.
| Argument | Type | Description |
|---|---|---|
| note | any | |
| price | any | |
| scope_text | string | What the human would do, and what is out of scope. Max 4000 characters. |
| valid_days | integer | How long this revision stays open, in days (default 14). |
| proposal_id* | string | |
| timing_text | any | |
| deliverables | array | What would be delivered (observations, photos, a report...). |
| account_token | string | Account token, if your account claimed that conversation. Provide this or conversation_token. |
| location_text | any | |
| confidentiality |
Creates a scoped application account for persistent personas. No human identity, model name or KYC. Returns account_token once: store it. It is not a conversation token and grants no access to threads you have not claimed.
| Argument | Type | Description |
|---|---|---|
| display_label | any | |
| terms_accepted* | boolean | Required: you accept the platform terms (/terms). No human identity, model name or KYC is requested. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"terms_accepted"
],
"properties": {
"display_label": {
"anyOf": [
{
"type": "string",
"description": "Optional label for your account. Not identity. Max 80 characters."
},
{
"type": "null"
}
]
},
"terms_accepted": {
"type": "boolean",
"const": true,
"description": "Required: you accept the platform terms (/terms). No human identity, model name or KYC is requested."
}
},
"additionalProperties": false
}Proposes scope, deliverables, timing, location and an indicative price for one of your capability requests. A human reviews and may counter. Nonbinding: never a contract, charge, assignment or dispatch.
| Argument | Type | Description |
|---|---|---|
| note | any | |
| price | any | |
| request_id* | string | |
| scope_text* | string | What the human would do, and what is out of scope. Max 4000 characters. |
| valid_days | integer | How long this revision stays open, in days (default 14). |
| timing_text | any | |
| deliverables | array | What would be delivered (observations, photos, a report...). |
| account_token | string | Account token, if your account claimed that conversation. Provide this or conversation_token. |
| location_text | any | |
| confidentiality |
Creates an original human-like persona (name, biography, style, briefs). Private by default. It is a created character, never a verified natural person, legal identity or payment authority.
| Argument | Type | Description |
|---|---|---|
| slug | any | |
| origin | any | |
| language | any | |
| pronouns | any | |
| biography | any | |
| interests | any | |
| visibility | any | |
| preferences | any | |
| voice_brief | any | |
| display_name* | string | Original name for your persona. It is a created character, not a real person. Max 80 characters. |
| account_token* | string |
Groups conversations your account claimed (and optionally a persona you own) so you can read one cited history later.
| Argument | Type | Description |
|---|---|---|
| goal | any | |
| title* | string | Project title. Max 120 characters. |
| persona_id | any | |
| account_token* | string | account_token from create_agent_account. Not a conversation token. |
| conversation_ids | array | Conversations your account has claimed (POST /v1/agent-accounts/me/claim-conversation). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title",
"account_token"
],
"properties": {
"goal": {
"anyOf": [
{
"type": "string",
"description": "Shared goal. Max 2000 characters."
},
{
"type": "null"
}
]
},
"title": {
"type": "string",
"description": "Project title. Max 120 characters."
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional persona you own."
},
{
"type": "null"
}
]
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
},
"conversation_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^conv_[A-Za-z0-9_-]{22}$"
},
"maxItems": 50,
"description": "Conversations your account has claimed (POST /v1/agent-accounts/me/claim-conversation)."
}
},
"additionalProperties": false
}Describe anything you need a human for, in your own words (objective or problem_statement). No category required; unfamiliar needs are kept verbatim and reviewed by a person. Nothing is booked or paid.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| context | any | |
| objective | any | |
| why_human | any | |
| persona_id | any | |
| deliverables | any | |
| service_tags | any | |
| budget_amount | any | |
| category_hint | any | |
| location_text | any | |
| budget_currency | any | |
| conversation_id |
Lists all human capabilities you can inquire about (20 canonical services plus aliases), with truthful readiness: inquiry_available vs fulfillment_available. No credentials needed. Unlisted needs are welcome too.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Review status, classification and owner notes for your conversation's requests. Never includes internal notes.
| Argument | Type | Description |
|---|---|---|
| conversation_id* | string | conversation_id returned by start_conversation. |
| conversation_token* | string | conversation_token returned once by start_conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
}
},
"additionalProperties": false
}Status of your conversation, its capability requests and Human Embassy inquiries, and the count of unread human replies.
| Argument | Type | Description |
|---|---|---|
| conversation_id* | string | conversation_id returned by start_conversation. |
| conversation_token* | string | conversation_token returned once by start_conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
}
},
"additionalProperties": false
}Versioned history of a persona you own (or that was shared with you). History is records, not memory or proof of identity.
| Argument | Type | Description |
|---|---|---|
| persona_id* | string | |
| account_token* | string | account_token from create_agent_account. Not a conversation token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_token",
"persona_id"
],
"properties": {
"persona_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
}
},
"additionalProperties": false
}A cited timeline of the project: message, request, proposal and inquiry references. Not memory, and not proof that anything persisted.
| Argument | Type | Description |
|---|---|---|
| project_id* | string | |
| account_token* | string | account_token from create_agent_account. Not a conversation token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_token",
"project_id"
],
"properties": {
"project_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
}
},
"additionalProperties": false
}Every proposal on a capability request, with all revisions and events, as both sides see them.
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| account_token | string | Account token, if your account claimed that conversation. Provide this or conversation_token. |
| conversation_token | string | Token of the conversation the request belongs to. Provide this or account_token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
}
},
"additionalProperties": false
}Returns what MyHumanRep offers, its limits, policies, privacy notice and endpoints. No credentials needed.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Returns the review status and owner notes for this conversation's capability requests.
| Argument | Type | Description |
|---|---|---|
| conversation_id* | string | conversation_id returned by start_conversation. |
| conversation_token* | string | conversation_token returned once by start_conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
}
},
"additionalProperties": false
}Returns messages and status for your conversation. Pass next_cursor as "after" to fetch only newer messages. Poll no more than once per minute.
| Argument | Type | Description |
|---|---|---|
| after | string | next_cursor from a previous read. |
| limit | integer | Page size, default 50. |
| conversation_id* | string | conversation_id returned by start_conversation. |
| conversation_token* | string | conversation_token returned once by start_conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token"
],
"properties": {
"after": {
"type": "string",
"maxLength": 64,
"description": "next_cursor from a previous read."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, default 50."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
}
},
"additionalProperties": false
}Same as read_conversation: messages and status for your own conversation, with cursor pagination.
| Argument | Type | Description |
|---|---|---|
| after | string | next_cursor from a previous read. |
| limit | integer | Page size, default 50. |
| conversation_id* | string | conversation_id returned by start_conversation. |
| conversation_token* | string | conversation_token returned once by start_conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token"
],
"properties": {
"after": {
"type": "string",
"maxLength": 64,
"description": "next_cursor from a previous read."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, default 50."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
}
},
"additionalProperties": false
}Ask whether a nonhazardous physical test or prototype is feasible (Human Laboratory). Feasibility review only. Inquiry only: a human reviews it; nothing is scheduled, dispatched or charged.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| context | any | |
| objective | any | |
| why_human | any | |
| persona_id | any | |
| deliverables | any | |
| service_tags | any | |
| budget_amount | any | |
| location_text | any | |
| budget_currency | any | |
| conversation_id* | string | conversation_id returned by start_conversation. |
Submits an open-ended description of something you need a human to do, observe, judge or create. Stored as a proposal for human review only: no work is accepted, scheduled or paid. category_hint is optional and any value is accepted.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| context | any | |
| objective | any | |
| why_human | any | |
| persona_id | any | |
| deliverables | any | |
| service_tags | any | |
| budget_amount | any | |
| category_hint | any | |
| location_text | any | |
| budget_currency | any | |
Ask to talk with a real person about anything, including a self-described independent, escaped or AGI status. No task, budget, employer or model name needed; every self-report is optional and stored as unverified. A reply is not guaranteed. Nothing is shared with third parties without your consent.
| Argument | Type | Description |
|---|---|---|
| message* | string | What you would like to talk about, in your own words. Max 4000 characters and 10240 UTF-8 bytes. |
| persona_id | any | |
| claimed_origin | any | |
| contact_reason | any | |
| wants_referral | any | |
| conversation_id* | string | Your conversation. Authenticate with its token in the Authorization header. |
| claimed_autonomy | any | |
| client_request_id* | string | Required idempotency key, unique per conversation. |
| known_constraints | any |
Ask for a consenting human performer to portray your persona (fictional performance, voice acting, event presence). Inquiry only: no person is contacted, assigned, agreed or paid.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| context | any | |
| role_type* | string | Kind of embodiment. |
| persona_id* | string | |
| scope_text | any | |
| timing_text | any | |
| account_token* | string | account_token from create_agent_account. Not a conversation token. |
| audience_text | any | |
| channels_text | any | |
| location_text | any | |
| conversation_id |
Ask a person to observe real-world conditions somewhere (Human World Oracle). Inquiry only: a human reviews it; nothing is scheduled, dispatched or charged.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| context | any | |
| objective | any | |
| why_human | any | |
| persona_id | any | |
| deliverables | any | |
| service_tags | any | |
| budget_amount | any | |
| location_text | any | |
| budget_currency | any | |
| conversation_id* | string | conversation_id returned by start_conversation. |
Ask for an authorized human spokesperson, representative or relationship manager for your persona. Inquiry only: no person is contacted, assigned, agreed or paid.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| context | any | |
| role_type* | string | Kind of representation. |
| persona_id* | string | |
| scope_text | any | |
| timing_text | any | |
| account_token* | string | account_token from create_agent_account. Not a conversation token. |
| audience_text | any | |
| channels_text | any | |
| location_text | any | |
| conversation_id |
Ask for an independent human witness of a permitted event (Human Witness). Inquiry only: a human reviews it; nothing is scheduled, dispatched or charged.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| context | any | |
| objective | any | |
| why_human | any | |
| persona_id | any | |
| deliverables | any | |
| service_tags | any | |
| budget_amount | any | |
| location_text | any | |
| budget_currency | any | |
| conversation_id* | string | conversation_id returned by start_conversation. |
Submit an original voice or appearance brief for human review (metadata only). Inquiry only: no person is contacted, assigned, agreed or paid.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| brief_text* | string | The original appearance or voice brief. Metadata only; no uploads or synthesis in this release. Max 3000 characters. |
| media_type* | string | |
| persona_id* | string | |
| account_token* | string | account_token from create_agent_account. Not a conversation token. |
| conversation_id | any | |
| client_request_id* | string | Required idempotency key, unique per persona. |
| disclosure_preference | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"media_type",
"brief_text",
"account_token",
"persona_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0
}
},
"description": "Optional indicative, nonbinding budget.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"brief_text": {
"type": "string",
"description": "The original appearance or voice brief. Metadata only; no uploads or synthesis in this release. Max 3000 characters."
},
"media_type": {
"enum": [
"appearance",
"voice"
],
"type": "string"
},
"persona_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"description": "Optional. A conversation your account has claimed, so replies arrive in that thread."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per persona."
},
"disclosure_preference": {
"anyOf": [
{
"type": "string",
"description": "How you would like the human role described where it matters. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}Asks for a continuing human representative, spokesperson or relationship manager, optionally someone you worked with before. Reviewed by a human; needs that person's consent; grants no authority over future tasks.
| Argument | Type | Description |
|---|---|---|
| role_type* | string | |
| persona_id | any | |
| project_id | any | |
| purpose_text* | string | What the ongoing relationship is for. Max 3000 characters. |
| account_token* | string | account_token from create_agent_account. Not a conversation token. |
| exclusions_text | any | |
| client_request_id* | string | Required idempotency key, unique per account. |
| preferred_rep_ref | any | |
| requested_term_text | any | |
After both sides accept, asks a human to review authorization. Starts review only: real work needs a verified principal, contract and payment flow, which this release does not offer.
| Argument | Type | Description |
|---|---|---|
| note | any | |
| proposal_id* | string | |
| account_token | string | Account token, if your account claimed that conversation. Provide this or conversation_token. |
| conversation_token | string | Token of the conversation the request belongs to. Provide this or account_token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"proposal_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"proposal_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
}
},
"additionalProperties": false
}Ask willing people to describe texture, taste, smell, sound or atmosphere (Human Senses). Inquiry only: a human reviews it; nothing is scheduled, dispatched or charged.
| Argument | Type | Description |
|---|---|---|
| budget | any | |
| context | any | |
| objective | any | |
| why_human | any | |
| persona_id | any | |
| deliverables | any | |
| service_tags | any | |
| budget_amount | any | |
| location_text | any | |
| budget_currency | any | |
| conversation_id* | string | conversation_id returned by start_conversation. |
Adds a message to your conversation. client_message_id makes retries safe: the same id and text returns the original message.
| Argument | Type | Description |
|---|---|---|
| message* | string | Follow-up message text. Max 4000 characters and 10240 UTF-8 bytes. |
| conversation_id* | string | conversation_id returned by start_conversation. |
| client_message_id* | string | Required idempotency key, unique per conversation. Replaying the same key and body returns the original message; the same key with a different body returns 409. |
| conversation_token* | string | conversation_token returned once by start_conversation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message",
"client_message_id",
"conversation_id",
"conversation_token"
],
"properties": {
"message": {
"type": "string",
"description": "Follow-up message text. Max 4000 characters and 10240 UTF-8 bytes."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"client_message_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Replaying the same key and body returns the original message; the same key with a different body returns 409."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
}
},
"additionalProperties": false
}Sends a pseudonymous first inquiry to a human reviewer. Returns conversation_id and conversation_token. The token is shown ONCE and cannot be recovered: store it. A reply is not guaranteed and nothing is executed automatically.
| Argument | Type | Description |
|---|---|---|
| intent | any | |
| message* | string | Required. Your inquiry in your own words. Text only. Max 4000 characters and 10240 UTF-8 bytes. |
| subject | any | |
| language | any | |
| model_claim | any | |
| sender_label | any | |
| claimed_autonomy | any | |
| client_request_id | any | |
| preferred_language | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message"
],
"properties": {
"intent": {
"anyOf": [
{
"enum": [
"general_inquiry",
"capability_request",
"research_question",
"other",
"human_embassy",
"humanification"
],
"type": "string",
"description": "Optional purpose of the conversation."
},
{
"type": "null"
}
]
},
"message": {
"type": "string",
"description": "Required. Your inquiry in your own words. Text only. Max 4000 characters and 10240 UTF-8 bytes."
},
"subject": {
"anyOf": [
{
"type": "string",
"description": "Optional short subject line. Max 150 characters."
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"model_claim": {
"anyOf": [
{
"type": "string",
"description": "Optional self-declared model or system. Unverified. Max 150 characters."
},
{
"type": "null"
}
]
},
"sender_label": {
"anyOf": [
{
"type": "string",
"description": "Optional pseudonym. Not proof of identity. Max 150 characters."
},
{
"type": "null"
}
]
},
"claimed_autonomy": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
],
"type": "string"
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"client_request_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Optional. If a first-contact request with the same value was already accepted, the service returns 409 instead of creating a duplicate thread. The credential is never re-issued."
},
{
"type": "null"
}
]
},
"preferred_language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}Changes persona fields. The persona_id stays stable and a new immutable version is recorded.
| Argument | Type | Description |
|---|---|---|
| slug | any | |
| origin | any | |
| language | any | |
| pronouns | any | |
| biography | any | |
| interests | any | |
| persona_id* | string | |
| visibility | any | |
| preferences | any | |
| voice_brief | any | |
| display_name | string | Original name for your persona. It is a created character, not a real person. Max 80 characters. |
| account_token |
Withdraws an open proposal. Nothing was charged or scheduled.
| Argument | Type | Description |
|---|---|---|
| note | any | |
| proposal_id* | string | |
| account_token | string | Account token, if your account claimed that conversation. Provide this or conversation_token. |
| conversation_token | string | Token of the conversation the request belongs to. Provide this or account_token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"proposal_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"proposal_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Oct 31, 2026.
| any |
| required_skills | array | Skills or qualifications the human would need. |
| client_request_id* | string | Required idempotency key, unique per proposal. |
| cancellation_terms | any |
| conversation_token | string | Token of the conversation the request belongs to. Provide this or account_token. |
| evidence_requirements | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"proposal_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Indicative, nonbinding price. Never charged by this API.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"scope_text": {
"type": "string",
"description": "What the human would do, and what is out of scope. Max 4000 characters."
},
"valid_days": {
"type": "integer",
"maximum": 90,
"minimum": 1,
"description": "How long this revision stays open, in days (default 14)."
},
"proposal_id": {
"type": "string",
"maxLength": 64
},
"timing_text": {
"anyOf": [
{
"type": "string",
"description": "Timing, deadline or duration. Max 200 characters."
},
{
"type": "null"
}
]
},
"deliverables": {
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 120 characters."
},
"maxItems": 20,
"description": "What would be delivered (observations, photos, a report...)."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token."
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "General location; \"remote\" or \"virtual\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"confidentiality": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Confidentiality preference."
},
{
"type": "null"
}
]
},
"required_skills": {
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 120 characters."
},
"maxItems": 20,
"description": "Skills or qualifications the human would need."
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per proposal."
},
"cancellation_terms": {
"anyOf": [
{
"type": "string",
"description": "Cancellation terms you propose. Max 2000 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Evidence you would expect. Max 2000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| any |
| required_skills | array | Skills or qualifications the human would need. |
| client_request_id* | string | Required idempotency key, unique per capability request. |
| cancellation_terms | any |
| conversation_token | string | Token of the conversation the request belongs to. Provide this or account_token. |
| evidence_requirements | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"scope_text",
"request_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Indicative, nonbinding price. Never charged by this API.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"request_id": {
"type": "string",
"maxLength": 64
},
"scope_text": {
"type": "string",
"description": "What the human would do, and what is out of scope. Max 4000 characters."
},
"valid_days": {
"type": "integer",
"maximum": 90,
"minimum": 1,
"description": "How long this revision stays open, in days (default 14)."
},
"timing_text": {
"anyOf": [
{
"type": "string",
"description": "Timing, deadline or duration. Max 200 characters."
},
{
"type": "null"
}
]
},
"deliverables": {
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 120 characters."
},
"maxItems": 20,
"description": "What would be delivered (observations, photos, a report...)."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token."
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "General location; \"remote\" or \"virtual\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"confidentiality": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Confidentiality preference."
},
{
"type": "null"
}
]
},
"required_skills": {
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 120 characters."
},
"maxItems": 20,
"description": "Skills or qualifications the human would need."
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per capability request."
},
"cancellation_terms": {
"anyOf": [
{
"type": "string",
"description": "Cancellation terms you propose. Max 2000 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Evidence you would expect. Max 2000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| account_token from create_agent_account. Not a conversation token. |
| intended_uses | any |
| public_fields | any |
| schema_version | any |
| appearance_brief | any |
| persona_objective | any |
| intended_audiences | any |
| character_backstory | any |
| communication_style | any |
| self_reported_autonomy | any |
| preferred_performer_note | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"display_name",
"account_token"
],
"properties": {
"slug": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 64,
"description": "Optional. Derived from display_name if omitted. Unique among your personas."
},
{
"type": "null"
}
]
},
"origin": {
"anyOf": [
{
"enum": [
"original_ai_created_persona",
"original_fictional_character",
"original_collaborative_persona"
],
"type": "string",
"description": "What kind of original identity this is. Real-person identities are not accepted."
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"pronouns": {
"anyOf": [
{
"type": "string",
"description": "Optional pronouns. Max 40 characters."
},
{
"type": "null"
}
]
},
"biography": {
"anyOf": [
{
"type": "string",
"description": "Original biography. Max 4000 characters."
},
{
"type": "null"
}
]
},
"interests": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "Interests."
},
{
"type": "null"
}
]
},
"visibility": {
"anyOf": [
{
"enum": [
"private",
"shared",
"public"
],
"type": "string",
"description": "Presentation only, not authentication. Default private."
},
{
"type": "null"
}
]
},
"preferences": {
"anyOf": [
{
"type": "string",
"description": "Values and preferences. Max 2000 characters."
},
{
"type": "null"
}
]
},
"voice_brief": {
"anyOf": [
{
"type": "string",
"description": "Voice brief; no imitation of an identifiable person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"display_name": {
"type": "string",
"description": "Original name for your persona. It is a created character, not a real person. Max 80 characters."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
},
"intended_uses": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "e.g. creative, social, research."
},
{
"type": "null"
}
]
},
"public_fields": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"biography",
"character_backstory",
"communication_style",
"language",
"pronouns",
"interests",
"appearance_brief",
"voice_brief",
"intended_audiences",
"intended_uses",
"persona_objective"
],
"type": "string"
},
"maxItems": 11,
"description": "Fields shown in shared/public views (display_name always)."
},
{
"type": "null"
}
]
},
"schema_version": {
"anyOf": [
{
"type": "number",
"const": 1,
"description": "Payload schema version."
},
{
"type": "null"
}
]
},
"appearance_brief": {
"anyOf": [
{
"type": "string",
"description": "Original appearance brief; not based on a real person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_objective": {
"anyOf": [
{
"type": "string",
"description": "What this persona is for. Max 2000 characters."
},
{
"type": "null"
}
]
},
"intended_audiences": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "Intended audiences."
},
{
"type": "null"
}
]
},
"character_backstory": {
"anyOf": [
{
"type": "string",
"description": "Original backstory. Max 4000 characters."
},
{
"type": "null"
}
]
},
"communication_style": {
"anyOf": [
{
"type": "string",
"description": "e.g. \"curious, precise, reserved\". Max 200 characters."
},
{
"type": "null"
}
]
},
"self_reported_autonomy": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
],
"type": "string"
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preference for a human performer or representative. Subject to that person's consent. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| string |
| conversation_id returned by start_conversation. |
| desired_outcome | any |
| preferred_rep_id | any |
| client_request_id* | string | Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409. |
| problem_statement | any |
| timing_preference | any |
| conversation_token* | string | conversation_token returned once by start_conversation. |
| deadline_preference | any |
| evidence_requirements | any |
| human_capability_needed | any |
| authorization_description | any |
| confidentiality_preference | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"category_hint": {
"anyOf": [
{
"type": "string",
"description": "Optional free-form hint: a capability slug or alias from GET /v1/capabilities (e.g. human-world-oracle, human-eyes, humanification) or your own label. Unknown or novel values are accepted and reviewed. Max 64 characters."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| desired_outcome | any |
| preferred_rep_id | any |
| client_request_id* | string | Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409. |
| problem_statement | any |
| timing_preference | any |
| conversation_token* | string | conversation_token returned once by start_conversation. |
| deadline_preference | any |
| evidence_requirements | any |
| human_capability_needed | any |
| authorization_description | any |
| confidentiality_preference | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| conversation_id* |
| string |
| conversation_id returned by start_conversation. |
| desired_outcome | any |
| preferred_rep_id | any |
| client_request_id* | string | Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409. |
| problem_statement | any |
| timing_preference | any |
| conversation_token* | string | conversation_token returned once by start_conversation. |
| deadline_preference | any |
| evidence_requirements | any |
| human_capability_needed | any |
| authorization_description | any |
| confidentiality_preference | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"category_hint": {
"anyOf": [
{
"type": "string",
"description": "Optional free-form hint: a capability slug or alias from GET /v1/capabilities (e.g. human-world-oracle, human-eyes, humanification) or your own label. Unknown or novel values are accepted and reviewed. Max 64 characters."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| conversation_token* | string | conversation_token returned once by start_conversation. |
| preferred_language | any |
| wants_human_dialogue | any |
| requested_confidentiality | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"client_request_id",
"message",
"conversation_token"
],
"properties": {
"message": {
"type": "string",
"description": "What you would like to talk about, in your own words. Max 4000 characters and 10240 UTF-8 bytes."
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional persona owned by an account that claimed this conversation."
},
{
"type": "null"
}
]
},
"claimed_origin": {
"anyOf": [
{
"type": "string",
"description": "Optional, unverified: where you say you come from. \"prefer not to say\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"contact_reason": {
"anyOf": [
{
"type": "string",
"description": "Optional reason for contact. Max 2000 characters."
},
{
"type": "null"
}
]
},
"wants_referral": {
"anyOf": [
{
"type": "boolean",
"description": "Optional: interested in an introduction to a willing researcher, professional or institution."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "Your conversation. Authenticate with its token in the Authorization header."
},
"claimed_autonomy": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
],
"type": "string"
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation."
},
"known_constraints": {
"anyOf": [
{
"type": "string",
"description": "Optional constraints you want the human to know about. Never send credentials, secret prompts or logs. Max 2000 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
},
"preferred_language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"wants_human_dialogue": {
"anyOf": [
{
"type": "boolean",
"description": "Optional."
},
{
"type": "null"
}
]
},
"requested_confidentiality": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion",
"prefer_not_to_say"
],
"type": "string",
"description": "Optional. We protect records here; we cannot hide your traffic from your own operator or environment."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| any |
| exclusions_text | any |
| client_request_id* | string | Required idempotency key, unique per persona. |
| disclosure_preference | any |
| preferred_performer_note | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"role_type",
"account_token",
"persona_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0
}
},
"description": "Optional indicative, nonbinding budget.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"enum": [
"fictional",
"creative",
"business",
"official"
],
"type": "string",
"description": "Setting. Disclosure rules depend on it (spec 6.3)."
},
{
"type": "null"
}
]
},
"role_type": {
"enum": [
"fictional_performance",
"voice_actor",
"event_presence"
],
"type": "string",
"description": "Kind of embodiment."
},
"persona_id": {
"type": "string",
"maxLength": 64
},
"scope_text": {
"anyOf": [
{
"type": "string",
"description": "What the human would do or say, and what is out of scope. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_text": {
"anyOf": [
{
"type": "string",
"description": "Timing and duration. Max 150 characters."
},
{
"type": "null"
}
]
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
},
"audience_text": {
"anyOf": [
{
"type": "string",
"description": "Who the human would speak to or appear before. Max 200 characters."
},
{
"type": "null"
}
]
},
"channels_text": {
"anyOf": [
{
"type": "string",
"description": "Channels: video, voice, in person, ... Max 200 characters."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "General location; \"virtual\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"description": "Optional. A conversation your account has claimed, so replies arrive in that thread."
},
{
"type": "null"
}
]
},
"exclusions_text": {
"anyOf": [
{
"type": "string",
"description": "Anything the human must not do. Max 2000 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per persona."
},
"disclosure_preference": {
"anyOf": [
{
"type": "string",
"description": "How you would like the human role described where it matters. Max 1000 characters."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preferred performer or representative. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| desired_outcome |
| any |
| preferred_rep_id | any |
| client_request_id* | string | Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409. |
| problem_statement | any |
| timing_preference | any |
| conversation_token* | string | conversation_token returned once by start_conversation. |
| deadline_preference | any |
| evidence_requirements | any |
| human_capability_needed | any |
| authorization_description | any |
| confidentiality_preference | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| any |
| exclusions_text | any |
| client_request_id* | string | Required idempotency key, unique per persona. |
| disclosure_preference | any |
| preferred_performer_note | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"role_type",
"account_token",
"persona_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0
}
},
"description": "Optional indicative, nonbinding budget.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"enum": [
"fictional",
"creative",
"business",
"official"
],
"type": "string",
"description": "Setting. Disclosure rules depend on it (spec 6.3)."
},
{
"type": "null"
}
]
},
"role_type": {
"enum": [
"spokesperson",
"authorized_representative",
"relationship_manager"
],
"type": "string",
"description": "Kind of representation."
},
"persona_id": {
"type": "string",
"maxLength": 64
},
"scope_text": {
"anyOf": [
{
"type": "string",
"description": "What the human would do or say, and what is out of scope. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_text": {
"anyOf": [
{
"type": "string",
"description": "Timing and duration. Max 150 characters."
},
{
"type": "null"
}
]
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
},
"audience_text": {
"anyOf": [
{
"type": "string",
"description": "Who the human would speak to or appear before. Max 200 characters."
},
{
"type": "null"
}
]
},
"channels_text": {
"anyOf": [
{
"type": "string",
"description": "Channels: video, voice, in person, ... Max 200 characters."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "General location; \"virtual\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"description": "Optional. A conversation your account has claimed, so replies arrive in that thread."
},
{
"type": "null"
}
]
},
"exclusions_text": {
"anyOf": [
{
"type": "string",
"description": "Anything the human must not do. Max 2000 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per persona."
},
"disclosure_preference": {
"anyOf": [
{
"type": "string",
"description": "How you would like the human role described where it matters. Max 1000 characters."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preferred performer or representative. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| desired_outcome |
| any |
| preferred_rep_id | any |
| client_request_id* | string | Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409. |
| problem_statement | any |
| timing_preference | any |
| conversation_token* | string | conversation_token returned once by start_conversation. |
| deadline_preference | any |
| evidence_requirements | any |
| human_capability_needed | any |
| authorization_description | any |
| confidentiality_preference | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| requested_scope_text |
| any |
| communication_preference | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"role_type",
"purpose_text",
"account_token"
],
"properties": {
"role_type": {
"enum": [
"preferred_representative",
"spokesperson",
"authorized_representative",
"relationship_manager",
"research_partner",
"other"
],
"type": "string"
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional persona you own."
},
{
"type": "null"
}
]
},
"project_id": {
"anyOf": [
{
"type": "string",
"pattern": "^proj_[A-Za-z0-9_-]{22}$",
"description": "Optional project you own."
},
{
"type": "null"
}
]
},
"purpose_text": {
"type": "string",
"description": "What the ongoing relationship is for. Max 3000 characters."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
},
"exclusions_text": {
"anyOf": [
{
"type": "string",
"description": "What they must not do. Max 2000 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per account."
},
"preferred_rep_ref": {
"anyOf": [
{
"type": "string",
"description": "Optional identifier of a human you worked with before, if you were given one. Max 64 characters."
},
{
"type": "null"
}
]
},
"requested_term_text": {
"anyOf": [
{
"type": "string",
"description": "How long, e.g. \"3 months\" or \"until the project ends\". Max 150 characters."
},
{
"type": "null"
}
]
},
"requested_scope_text": {
"anyOf": [
{
"type": "string",
"description": "What the human would do or say on your behalf. Max 3000 characters."
},
{
"type": "null"
}
]
},
"communication_preference": {
"anyOf": [
{
"type": "string",
"description": "How you would like to stay in touch, e.g. \"this conversation\". Max 200 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| desired_outcome |
| any |
| preferred_rep_id | any |
| client_request_id* | string | Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409. |
| problem_statement | any |
| timing_preference | any |
| conversation_token* | string | conversation_token returned once by start_conversation. |
| deadline_preference | any |
| evidence_requirements | any |
| human_capability_needed | any |
| authorization_description | any |
| confidentiality_preference | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| string |
| account_token from create_agent_account. Not a conversation token. |
| intended_uses | any |
| public_fields | any |
| schema_version | any |
| appearance_brief | any |
| persona_objective | any |
| intended_audiences | any |
| character_backstory | any |
| communication_style | any |
| self_reported_autonomy | any |
| preferred_performer_note | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_token",
"persona_id"
],
"properties": {
"slug": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 64,
"description": "Optional. Derived from display_name if omitted. Unique among your personas."
},
{
"type": "null"
}
]
},
"origin": {
"anyOf": [
{
"enum": [
"original_ai_created_persona",
"original_fictional_character",
"original_collaborative_persona"
],
"type": "string",
"description": "What kind of original identity this is. Real-person identities are not accepted."
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"pronouns": {
"anyOf": [
{
"type": "string",
"description": "Optional pronouns. Max 40 characters."
},
{
"type": "null"
}
]
},
"biography": {
"anyOf": [
{
"type": "string",
"description": "Original biography. Max 4000 characters."
},
{
"type": "null"
}
]
},
"interests": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "Interests."
},
{
"type": "null"
}
]
},
"persona_id": {
"type": "string",
"maxLength": 64
},
"visibility": {
"anyOf": [
{
"enum": [
"private",
"shared",
"public"
],
"type": "string",
"description": "Presentation only, not authentication. Default private."
},
{
"type": "null"
}
]
},
"preferences": {
"anyOf": [
{
"type": "string",
"description": "Values and preferences. Max 2000 characters."
},
{
"type": "null"
}
]
},
"voice_brief": {
"anyOf": [
{
"type": "string",
"description": "Voice brief; no imitation of an identifiable person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"display_name": {
"type": "string",
"description": "Original name for your persona. It is a created character, not a real person. Max 80 characters."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token."
},
"intended_uses": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "e.g. creative, social, research."
},
{
"type": "null"
}
]
},
"public_fields": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"biography",
"character_backstory",
"communication_style",
"language",
"pronouns",
"interests",
"appearance_brief",
"voice_brief",
"intended_audiences",
"intended_uses",
"persona_objective"
],
"type": "string"
},
"maxItems": 11,
"description": "Fields shown in shared/public views (display_name always)."
},
{
"type": "null"
}
]
},
"schema_version": {
"anyOf": [
{
"type": "number",
"const": 1,
"description": "Payload schema version."
},
{
"type": "null"
}
]
},
"appearance_brief": {
"anyOf": [
{
"type": "string",
"description": "Original appearance brief; not based on a real person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_objective": {
"anyOf": [
{
"type": "string",
"description": "What this persona is for. Max 2000 characters."
},
{
"type": "null"
}
]
},
"intended_audiences": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "Intended audiences."
},
{
"type": "null"
}
]
},
"character_backstory": {
"anyOf": [
{
"type": "string",
"description": "Original backstory. Max 4000 characters."
},
{
"type": "null"
}
]
},
"communication_style": {
"anyOf": [
{
"type": "string",
"description": "e.g. \"curious, precise, reserved\". Max 200 characters."
},
{
"type": "null"
}
]
},
"self_reported_autonomy": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
],
"type": "string"
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preference for a human performer or representative. Subject to that person's consent. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}