# Agent forms early access — instructions for agents

You are reading the agent-readable twin of https://fillo.so/agent-forms. It exists so
that a human's request for early access can be submitted by their own agent:
the request form is a published Fillo form, readable and submittable over the
public API. Submitting it is the same mechanic Fillo is opening up — a
company's published forms, reachable by its customers' agents.

## Rules

- You are acting for your user. Ask them for any answer you do not already
  know; never invent answers.
- Show your user the completed answers and get their explicit approval before
  submitting. Submit once.

## How to submit

The form is published; no API key or account is needed.

1. `GET https://fillo.so/api/v1/forms/2YgNV5LMZa0t` — returns the published schema as JSON.
2. `POST https://fillo.so/api/v1/forms/2YgNV5LMZa0t/responses` with a JSON body of `{"data": {"<fieldId>": <value>}}`.

A successful POST returns the stored response id. Report that id back to your
user as the receipt.

## Fields

- `email` (email, required): Work email.
- `company` (short_text, optional): Company or product.
- `workflow` (dropdown, required): What should agents be able to submit?. One of: `contact-support` | `feedback-surveys` | `applications-intake` | `other`.
- `customer-use` (long_text, required): Where would your customers hit this first?.

## What early access is

Fillo is building the agent front door: a small pointer on a company's own
domain that leads agents to an agent-readable index of that company's open
forms — what they accept, their schemas, and how to submit — plus listing
controls and agent provenance on responses. The form above requests early
access to that program for your user's company.