Business info

Abandon the business info draft

Closes the open draft without submitting it, marking it superseded. Cannot be used on a MagicDoor information request. Requires the business_info:write permission.

POST

https://services.magicdoor.com/companies/company-portal/business-info/{businessInfoId}/abandon

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

businessInfoIdstringrequired

The business legal entity, as a Snowflake id in decimal string form.

example: 1842095537184571392

Body

application/json

Optional. The whole body may be omitted.

reasonstring

Why the draft is being abandoned. Up to 2000 characters. Kept on the draft's history.

Response

200 · The draft was abandoned. The response has no body.

400 · `reason` is longer than 2000 characters.

401 · The request carried no valid access token.

403 · The caller is not a property manager, or is missing the `business_info:write` permission.

422 · This legal entity has no open draft, the draft is a MagicDoor information request, or its status is neither `draft` nor `rejected`.

Request

curl --request POST \
  --url 'https://services.magicdoor.com/companies/company-portal/business-info/1842095537184571392/abandon' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "reason": "Entity was registered under the wrong name."
}'

Body

{
  "reason": "Entity was registered under the wrong name."
}