canonical: https://jentic.com/apis/gearsnakes-field-ops-public.netlify.app/gearsnakes-field-ops-public

# Gearsnakes Field Ops Public Gearsnakes Review-Only Inquiry API

The Gearsnakes Review-Only Inquiry API accepts unverified requests for local field tasks, such as courier pickup and delivery, field verification, document transfer, equipment assistance, and photo and video documentation, and holds them for the owner to review. A client first checks whether intake is open, then submits a structured inquiry with a title, category, city, details, contact email, and requester name, plus explicit authorizedToRequest and reviewOnly confirmations. Submissions are idempotent through a required Idempotency-Key header, and an accepted inquiry is stored for review only: the API does not take payments, enroll agents, accept assignments, or dispatch work.

## For AI agents

Check whether Gearsnakes is accepting field-task inquiries and submit a review-only request for courier, field verification, document transfer, equipment, or photo work.

## Scope

Does not handle payments, job dispatch, assignment acceptance, or worker enrollment. Use for checking intake availability and submitting review-only field-task inquiries only.

## Capabilities

- Check whether review-only inquiry intake is currently available before submitting
- Submit a field-task inquiry with a title, category, city, details, contactEmail, and requester for owner review
- Retry an uncertain submission safely by resending the identical body with the same Idempotency-Key
- Classify a request into a category such as Courier pickup and delivery, Field verification, or Photo and video documentation

## Use cases

### AI assistant forwarding a field-task request

An AI assistant handling a user's request for an in-person errand can hand it to Gearsnakes for human review. Through Jentic the agent searches for 'submit a field task inquiry', calls GET `/api/requests` to confirm intakeAvailable, then posts the inquiry to POST `/api/requests` with a fresh Idempotency-Key. A 202 response means the inquiry is stored for review and no work has been accepted yet, which the agent reports back to the user plainly.

Example prompt: Call GET `/api/requests`, and if intake is available POST `/api/requests` with an Idempotency-Key, category 'Document transfer', city 'Austin', a title, details, contactEmail, requester, authorizedToRequest true, and reviewOnly true

### Field verification inquiry

A business that needs someone to confirm a site, an address, or the state of equipment can describe the job in up to 2000 characters of details and submit it under the Field verification or Equipment assistance category. The spec asks callers to keep personal credentials, payment information, attachments, and sensitive site access details out of the request, so the inquiry carries the scope only and the owner follows up by email.

Example prompt: POST `/api/requests` with category 'Field verification', a title of at least 8 characters, a city, details of at least 20 characters describing the site, contactEmail, requester, authorizedToRequest true, and reviewOnly true

### Safe retries for uncertain submissions

Network failures and 503 responses leave a client unsure whether an inquiry landed. The API replays the original receipt with a 200 when the identical body and Idempotency-Key are resent, returns 409 if a key is reused for a different inquiry, and answers 429 when the review queue or request limit is reached, so a client can retry without creating duplicates.

Example prompt: After a 503 from POST `/api/requests`, resend the identical JSON body with the original Idempotency-Key and treat a 200 as the replayed receipt

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/api/requests` | Check inquiry intake availability |
| POST | `/api/requests` | Submit an inquiry for owner review |

## Key resources

- **Inquiry intake** — Availability check and review-only inquiry submission under `/api/requests`

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 69 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 54 / 100
  - Agent Usability: 94 / 100
  - Security: 100 / 100
  - AI Discoverability: 44 / 100
- **View full report:** https://jentic.com/apis/gearsnakes-field-ops-public.netlify.app/gearsnakes-field-ops-public/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Gearsnakes by hand means generating and persisting an Idempotency-Key per inquiry, enforcing the field length rules, and handling 409, 429, and 503 retry semantics yourself. Through Jentic you install once, import it from the API Directory, and your agent calls it with the input schema in hand.
- **Permission scoping:** Gearsnakes exposes one path with two methods and carries the inquiry in the request body, so rules bound which operations your agent may call, not which inquiries it sends. You choose the operations it may call, so the submit operation is not included unless you add it.
- **Credential handling:** Gearsnakes needs no account or API key for its inquiry intake. For any API you add that does use a key, your own Jentic One instance keeps it encrypted and injects it at execution time so it never reaches the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'request a courier pickup' or 'submit a field task inquiry', and Jentic returns the matching Gearsnakes operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Postmates Delivery API** — On-demand courier delivery with quotes and dispatch.
- **JotForm API** — General form builder with submissions you collect and manage yourself.
- **Typeform API** — Conversational forms that can capture a task request before it is forwarded.

## FAQ

### Does the Gearsnakes Review-Only Inquiry API require authentication?

No API key or account scheme is declared in its OpenAPI spec, and the global security list is empty. Submissions do require an Idempotency-Key header of 16 to 128 letters, digits, underscores, or hyphens, which identifies the request for safe retries rather than authenticating the caller. The spec notes that cross-origin browser requests are denied with a 403.

### Does submitting an inquiry book the work?

No. A 202 from POST `/api/requests` means the inquiry is durably stored for owner review and no work is accepted. The spec states the API handles unverified inquiries only, with no payments, agent enrollment, assignment acceptance, or dispatch, and both authorizedToRequest and reviewOnly must be sent as true.

### What are the rate limits for the Gearsnakes Review-Only Inquiry API?

Per the POST `/api/requests` description in the spec, submissions are limited to five requests per minute per IP or domain and 100 unique inquiries per UTC day, with an 8 KB maximum body. A 429 response means the review queue or request limit has been reached.

### Is there a Gearsnakes MCP server?

You don't need an MCP server to give your agent the Gearsnakes Review-Only Inquiry API. Jentic connects it directly from the API Directory: import it and your agent can check availability and submit inquiries, with each operation discovered on demand rather than preloaded into its context.

### Can I limit what my agent is allowed to do with the Gearsnakes API?

Yes. For example, write a rule that allows only GET `/api/requests`, so the agent can report whether intake is open but cannot submit an inquiry on your behalf until you add POST `/api/requests` to the allowed set. Every call it makes is logged.

### How do I submit an inquiry through Jentic?

Add the Gearsnakes Review-Only Inquiry API to your Jentic One instance from the directory. Your agent searches for 'submit a field task inquiry', loads the submitInquiryForReview operation, and posts the required fields with an Idempotency-Key header. To run it on your own infrastructure, install Jentic One from its GitHub repo.
