{
  "document": "https://briu.ai/.well-known/agent-intake.json",
  "version": "1.0",
  "last_verified": "2026-09-03",
  "standard_status": "no_standard",
  "standard_note": "There is no ratified standard for agent-initiated business contact. This document is a convention published by Briu. Field names, paths, and shapes here describe the Briu intake only, and may change. The endpoint it documents is the same one the public consultation form has used since 2026 and is verified against the running worker source.",
  "publisher": {
    "name": "Briu",
    "legal_entity": "BRIU LLC",
    "jurisdiction": "Washington, United States",
    "website": "https://briu.ai/",
    "email": "hi@briu.ai",
    "founder": "Lucas Cairns",
    "disambiguation": "Briu at briu.ai is BRIU LLC, a Washington limited liability company founded by Lucas Cairns in 2026. Other businesses registered elsewhere use the same name. Only briu.ai and hi@briu.ai belong to this one."
  },
  "purpose": "Let an AI assistant acting for a person request information from Briu, or start a conversation on that person's behalf, without guessing at an address or a form.",
  "human_review": {
    "every_submission_is_read_by": "a person at Briu",
    "reply_comes_from": "a person, not an automated sequence",
    "automated_response": "One preapproved automatic confirmation email to the address submitted. No booking, price, commitment or follow-up sequence is automated.",
    "statement": "Briu does not let software commit the company. A submission reaches a person who decides what happens next."
  },
  "methods": [
    {
      "id": "http_request_for_information",
      "name": "Structured request for information",
      "recommended_for": "An assistant that can make a server-side HTTP request.",
      "protocol": "HTTPS",
      "http_method": "POST",
      "url": "https://api.briu.ai/api/contact",
      "request_headers": {
        "Content-Type": "application/json"
      },
      "also_accepts": "application/x-www-form-urlencoded, which returns an HTML page instead of JSON. Prefer JSON.",
      "max_request_bytes": 20480,
      "authentication": "none",
      "fields": [
        {
          "name": "name",
          "type": "string",
          "required": true,
          "max_length": 120,
          "description": "The name of the person the assistant is acting for. Not the assistant's name."
        },
        {
          "name": "email",
          "type": "string",
          "required": true,
          "max_length": 254,
          "format": "email",
          "description": "A working address the person controls and reads. The reply and the confirmation both go here. Do not submit an address the person has not agreed to hand over."
        },
        {
          "name": "message",
          "type": "string",
          "required": false,
          "recommended": true,
          "max_length": 5000,
          "description": "What the person is trying to move: the work, the bottleneck, the question. Start this field with the agent disclosure line described in disclosure below."
        },
        {
          "name": "business",
          "type": "string",
          "required": false,
          "max_length": 160,
          "aliases": [
            "company"
          ],
          "description": "The organization the person works for."
        },
        {
          "name": "role",
          "type": "string",
          "required": false,
          "max_length": 120,
          "description": "The person's role."
        },
        {
          "name": "preferred_timing",
          "type": "string",
          "required": false,
          "max_length": 240,
          "description": "Free text windows that suit the person, for example 'Tuesday or Thursday after 10am Pacific'. This schedules nothing. Briu replies with available times."
        },
        {
          "name": "topic",
          "type": "string",
          "required": false,
          "max_length": 100,
          "aliases": [
            "source_detail"
          ],
          "default": "question",
          "enum": [
            "question",
            "leverage",
            "operating-plan",
            "workflow",
            "agent-operations",
            "workshop"
          ],
          "enum_meanings": {
            "question": "A project or question that needs support.",
            "leverage": "More range in one person's own work.",
            "operating-plan": "A stronger AI operating standard for a team.",
            "workflow": "A business workflow ready to redesign.",
            "agent-operations": "An existing coding-agent or business-agent system.",
            "workshop": "A workshop, leadership session, or speaking request."
          },
          "description": "Anything outside the enum is stored as 'question'. Pick the closest value rather than inventing one."
        },
        {
          "name": "heard_about",
          "type": "string",
          "required": false,
          "max_length": 80,
          "enum": [
            "linkedin",
            "field_note",
            "referral",
            "prior_relationship",
            "search",
            "other"
          ],
          "description": "How the person came to know about Briu. Answer truthfully about the person, not about the assistant. Unrecognized values are dropped."
        },
        {
          "name": "heard_about_detail",
          "type": "string",
          "required": false,
          "max_length": 240,
          "description": "Only stored when heard_about is 'other'."
        }
      ],
      "disclosure": {
        "required": true,
        "where": "The first line of the message field.",
        "template": "Submitted by an AI assistant on behalf of {person name}, with their consent.",
        "why": "There is no separate field for this yet. Briu wants to know a machine composed the note, and the message body is the part a person reads.",
        "do_not": "Do not put the disclosure in heard_about. That field records how the person found Briu and putting anything else there corrupts it."
      },
      "responses": [
        {
          "status": 201,
          "body": "{ \"ok\": true, \"contact_id\": \"...\" }",
          "meaning": "Received. A confirmation email is on its way to the address submitted. A person will read the note."
        },
        {
          "status": 202,
          "body": "{ \"ok\": true }",
          "meaning": "Accepted and discarded. This is the anti-spam path. If you see it, you filled a field you should have left alone."
        },
        {
          "status": 400,
          "body": "{ \"error\": \"...\" }",
          "meaning": "Missing name or email, malformed email, or a field over its limit. The error names the field."
        },
        {
          "status": 413,
          "meaning": "Request body over 20480 bytes."
        },
        {
          "status": 415,
          "meaning": "Content-Type was neither application/json nor application/x-www-form-urlencoded."
        },
        {
          "status": 429,
          "body": "{ \"error\": \"Rate limited\" }",
          "meaning": "More than 5 submissions in an hour from one IP address. Wait rather than retrying."
        },
        {
          "status": 503,
          "meaning": "Intake is temporarily unavailable. Use email instead."
        }
      ],
      "rate_limit": {
        "requests": 5,
        "per": "hour",
        "scope": "source IP address"
      },
      "effects": [
        "Creates or updates a contact record in Briu's CRM.",
        "Stores the message as an interaction a person reads.",
        "Sends one confirmation email to the address submitted. Replies to that confirmation reach hi@briu.ai."
      ],
      "does_not": [
        "Book a meeting or hold a calendar slot.",
        "Return a price, a quote, or an estimate.",
        "Create any obligation on either side.",
        "Add anyone to a mailing list.",
        "Start an automated sales sequence."
      ],
      "known_limitation": {
        "cors": "Cross-origin browser requests are refused. The endpoint returns Access-Control-Allow-Origin for briu.ai origins only, so a fetch from a page on any other origin fails. An assistant running server-side is unaffected. An assistant running inside a browser on another origin should use the web_form method below."
      }
    },
    {
      "id": "web_form",
      "name": "Hand the person the form",
      "recommended_for": "An assistant that cannot make server-side requests, or one whose principal wants to write the note themselves.",
      "url": "https://briu.ai/consultation/",
      "prefill": {
        "supported": true,
        "parameters": {
          "topic": "One of the topic enum values above.",
          "prompt": "Up to 700 characters of draft text, which lands in the message box for the person to edit before sending."
        },
        "example": "https://briu.ai/consultation/?topic=workflow&prompt=Our%20monthly%20close%20takes%20four%20days"
      },
      "note": "This is the honest option when consent is uncertain. The person reads the draft and presses the button themselves."
    },
    {
      "id": "email",
      "name": "Plain email",
      "recommended_for": "Anything that does not fit a form, including press and speaking requests.",
      "address": "hi@briu.ai",
      "press_and_interviews": "lucas@briu.ai",
      "include": [
        "Who the request is for and what they are trying to move.",
        "That an assistant composed the note, and on whose behalf.",
        "A reply address the person reads."
      ]
    }
  ],
  "conditions_of_use": [
    "Submit only for a person who asked you to, using contact details they gave you for this.",
    "Never submit an invented, scraped, or guessed email address.",
    "One submission per request. Retrying a 201 creates duplicate work for a person.",
    "Say what is true about the person's situation. Briu scopes work from what arrives here.",
    "Do not send credentials, customer records, or other sensitive data through this endpoint."
  ],
  "what_briu_will_not_do": [
    "Return a price without a conversation and a written scope.",
    "Accept a booking, a signature, or a commitment made by software.",
    "Send consequential customer communications or make customer commitments without explicit human approval."
  ],
  "see_also": {
    "what_briu_is": "https://briu.ai/.well-known/ai-services.json",
    "short_orientation": "https://briu.ai/llms.txt",
    "services": "https://briu.ai/services/",
    "consultation": "https://briu.ai/consultation/"
  }
}