StatusDashboard
Account

Update account

Update the organization's business name or accept the Terms of Service.

View Markdown

PATCH /app/account

Updates the organization's business name.


Request

See API Basics for required headers.

Request body

FieldTypeRequiredDescription
businessNamestringNoDisplay name for the organization. 2–30 characters.
tosAcceptedbooleanNoSet true to accept the Terms of Service. Required during initial onboarding when status is pending_onboarding.

Sample request

curl -X PATCH https://api.statusdashboard.com/app/account \
  -H "Authorization: Bearer bcf847abf5c6:def456" \
  -H "Content-Type: application/json" \
  -d '{"businessName": "Acme Plumbing Co."}'

Sample response

Status: 200 OK

{
  "org": {
    "orgId": "a1b2c3d4-0000-4000-8000-e5f6a7b8c9d0",
    "name": "Acme Plumbing Co.",
    "status": "active",
    "tier": "pro",
    "createdAt": "2026-01-15T09:00:00.000Z",
    "tosAcceptedAt": "2026-01-16T10:30:00.000Z",
    "tosVersion": "2026-01-01"
  }
}

tosAcceptedAt and tosVersion are omitted when the ToS has not been accepted.


Error responses

StatusWhen
400Validation failure — e.g. businessName is required when completing onboarding.
403Insufficient permissions.
404Organization not found.
409An organization with that name already exists. Choose a different name.

On this page

We use cookies

We use essential cookies to keep the site working, and optional analytics cookies to understand how it's used. Read our Privacy Policy.