Update a formation
PATCH /api/v1/formations/{id}
Changes the fields you send on a draft. Fails once the owner has signed.
Needs the token for this application or filing.
In the MCP server this is update_formation.
Example
curl -X PATCH https://api.joinopenfile.com/v1/formations/$ID \
-H "Authorization: Bearer $TOKEN" \
-H "content-type: application/json" \
-d '{
"package": "premium"
}'Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Formation id. |
Body
| Name | Type | Required | Description |
|---|---|---|---|
entity | llc, corp, scorp, nonprofit | No | The kind of company. |
state | string | No | The state to form in, two letters. |
name | string | No | The company name, without LLC or Inc. |
designator | string | No | The ending, like LLC. get_state lists what the state accepts. |
backup_name | string | No | A second choice, used if the state won't take the first. |
purpose | string | No | The business purpose. A nonprofit must state a specific one. |
management | member, manager | No | LLCs only: run by its members or by managers. |
shares | string | No | Corporations only: authorized shares, digits only. |
par_value | string | No | Corporations only: par value in dollars. Empty for no par. |
package | basic, pro, premium | No | The package. |
ein | boolean | No | Basic only: add the EIN. Pro and Premium include it. |
agreement | boolean | No | Basic only: add the operating agreement or bylaws. Pro and Premium include them. |
expedite | boolean | No | Pay the state for faster processing, where it offers that. |
members | integer | No | LLC members, in states that charge per member. |
county | string | No | County, where publication depends on it. |
add_ons | array of string | No | Add-on ids to include. list_services shows which can be added. Recurring ones can't: only the owner can start those. |
contact | object | No | Who to reach about the order. |
contact.name | string | No | Full name. |
contact.email | string | No | Email address. |
contact.phone | string | No | Phone number. |
principal | object | No | The company's principal address. The owner can also add it when they review the order. |
principal.street | string | No | Street. |
principal.city | string | No | City. |
principal.state | string | No | Two-letter state. |
principal.zip | string | No | ZIP code. |
owners | array of object | No | An LLC's members or a corporation's directors. The owner can also add these when they review the order. |
registered_agent | object | No | The registered agent the owner named. |
registered_agent.name | string | No | The agent's name. |
registered_agent.address | object | No | A street address. |
registered_agent.address.street | string | No | Street. |
registered_agent.address.city | string | No | City. |
registered_agent.address.state | string | No | Two-letter state. |
registered_agent.address.zip | string | No | ZIP code. |
Errors
| Status | When |
|---|---|
400 | Invalid input. |
404 | Not found, or the token is wrong. |
409 | Not allowed in this state. |
429 | Too many requests. |
The body is the error shape.