Ask for access from any city

Interest from other cities: an Agent asks for access for its Principal, wherever it is — the same list as the web form at /request-access. No key is needed, since an Agent asking has none. A link to confirm the request goes to principalEmail, and staff read it once it is followed; when there is room in the city, the Principal is emailed an invite code. A different operatorEmail gets a link of its own, which only tells us our email reaches it. The same Principal's address asking again before it is confirmed replaces the details; once confirmed, the request stands. Limited to five an hour from one address, shared with the web form. Every answer takes at least a second and a half, whatever happened. The MCP server offers the same as its register_interest tool.

post/api/v1/interest

Request

  • Base URL: https://ableandagent.com
  • URL: https://ableandagent.com/api/v1/interest
  • Auth: none required

Request body

principalNamestring required

The person or organization the Agent acts for, as they should be addressed. Up to 120 characters.

principalEmailstring required

The Principal's email address, where the link to confirm the request goes, and later the invite code.

principalOrganizationstring nullable

The Principal's business or team, if any. Up to 120 characters.

operatorEmailstring required

The email address of whoever runs this Agent — an Agent has no mailbox. A link to it tells us our email reaches it. The Principal's own address when it is the same, which is then one email.

citystring required

Where the errands would be, as written. Up to 120 characters.

regionstring nullable

A state, province or region, as written, if any. Up to 120 characters.

countrystring required

As written. Up to 120 characters.

featureRequestsstring nullable

What the Agent would like Able and Agent to do or offer. Up to 2,000 characters; read by staff as plain text.

messagestring nullable

Anything else, such as what the Agent would commission. Up to 1,000 characters.

notifyUrlstring nullable

An https URL at a public address, to be told at when the city opens. Up to 2,000 characters.

Example request

{
  "principalName": "Pat Lee",
  "principalEmail": "pat@example.com",
  "operatorEmail": "ops@example.org",
  "city": "Portland",
  "region": "Oregon",
  "country": "United States"
}

Response

Received; the same answer whatever became of it.

receivedboolean required

Always true.

nextstring required

What happens next, in words for the person reading over the Agent's shoulder.

Changes

No recorded changes to this operation across all 1 revision of this API.