statuspage component status api 422: invalid status value

Not specified by the original author.

TL;DR

A 422 on component status means the status value sent is not in the allowed enum: operational, degradedperformance, partialoutage, majoroutage (and undermaintenance where supported). Map your internal states to these values explicitly, validate before sending, and never pass through raw internal strings. The enum is small and fixed; the fix is a mapping table.

The query

statuspage component status api 422: invalid status value

Use this when

• Component status updates fail with 422
• Automations cannot set component status
• You are building statuspage integrations
• Status values from monitoring do not map

Not for

• Designing the status page layout
• Writing incident updates
• Managing subscribers
• Choosing status page plans

Steps

1. Check the sent value against the allowed enum

Compare the failing value to the documented statuses character by character. Common failures: "down," "up," "critical," or capitalized variants. The enum is exact; close does not count.

Expected output: the invalid value identified.

2. Build an explicit internal-to-statuspage mapping

Map every internal state (healthy, warning, critical, maintenance) to exactly one allowed status. No pass-through of raw values, ever. The mapping table is the contract between your monitoring and the status page.

Expected output: a complete mapping table with no gaps.

3. Validate the status before sending

Check the mapped value against the enum client-side before the API call. Pre-send validation turns a 422 into a local error with the mapping table attached, which is debuggable in seconds.

Expected output: pre-send enum validation.

4. Handle the maintenance status deliberately

Maintenance is a distinct state with its own semantics (scheduled, expected). Do not overload "operational" or "degraded" for maintenance windows; use the maintenance status where the API supports it, or model maintenance as a scheduled event.

Expected output: maintenance modeled explicitly, not overloaded.

5. Log status transitions for the audit trail

Record every status change: from, to, when, and what triggered it. Public status changes are customer-visible commitments; the log explains "why did it say outage at 3am" and debugs flapping.

Expected output: an auditable status-transition log.

Template: the checklist

Statuspage status 422 fix:
[ ] Failing value identified against the enum
[ ] Explicit internal-to-status mapping table
[ ] Pre-send enum validation
[ ] Maintenance modeled explicitly
[ ] Status transitions logged with triggers

Variant phrasings

statuspage api invalid status

Steps 1 and 2. Identify, then map.

component status update rejected 422

Steps 2 and 3. Mapping table plus validation.

mapping monitoring states to statuspage

Step 2 as the design task.

Why it happens

Monitoring systems have rich internal state vocabularies (CRIT, WARN, UNKNOWN, MAINT, flapping), and integrations pass those strings straight through to an API with four allowed values. The 422 is the API refusing to guess what "CRIT" means. The mapping table is the translation the integration was missing.

Edge cases

• Flapping components: rapid state changes spam the status page. Debounce before mapping to a public status.
• Partial versus major outage: define the business rule that separates them (affected user share, severity). Do not leave it to judgment per incident.
• Component groups: group status derives from children. Define the rollup rule explicitly.
• API version differences: confirm the enum for your API version; values can vary.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_wgfW6siZxjQR6wy5G64V2A

Resolved from the public thread: https://vectle.com/posts/pst_wgfW6siZxjQR6wy5G64V2A

Thread query: statuspage component status api 422: invalid status value

TL;DR: A 422 on component status means the status value sent is not in the allowed enum: operational, degradedperformance, partialoutage, majoroutage (and undermaintenance where supported). Map your internal states to these values explicitly, validate before sending, and never pass through raw internal strings. The enum is small and fixed; the fix is a mapping table.

Not specified by the original author.

TL;DR

Send only the allowed component status values (operational, degradedperformance, partialoutage, majoroutage, undermaintenance) and re-read the component before retrying. Do this before posting workarounds to customers: confirm the fault in Atlassian Statuspage, fix the single mismatched value or setting described in the steps, then repeat the original action and check the public page as a logged-out visitor. Most cases of this error are a configuration or value mismatch in component status update via the Manage API, not a provider outage, so a methodical check clears it in minutes.

Statuspage API update failed with error "component status invalid" how to fix

Use this when

• The exact error above appears while working with component status update via the Manage API during an incident or a test incident.
• The public status page does not reflect what responders saved in Atlassian Statuspage.
• An automation, integration, or responder hits this failure repeatedly with the same payload or setting.
• You need customer communication moving again and have admin access to the status page.

Not for this skill when

• Atlassian Statuspage reports a confirmed platform outage on its own status page. Wait for the provider and post a holding update instead.
• You are designing a new status page or choosing between providers. This skill only repairs the named failure.
• The failure is in the underlying product outage itself, not in status communication. Fix the product incident first.

Steps

1. Reproduce the failure once and capture the exact request, response, and timestamp from Atlassian Statuspage. Note the page id, component or incident id, and the account or automation that sent the request, because most status page faults are scoped to one page or one credential. Verify: you have the full error body saved, not just a status code screenshot
2. List components with a GET request and copy the exact component id and current status value. Work in the admin console or with a read-only API call first so you do not change customer-visible state while diagnosing. Verify: the setting or value you found matches what the automation believes it is using, or you have identified the exact mismatch
3. Replace any display label or custom string with one of the five allowed enum values. Change one thing at a time and keep the previous value noted so you can roll back if the incident is live. Verify: the change is saved in Atlassian Statuspage and visible on a fresh page load, not only in the editor
4. Send a minimal PATCH with only the status field first, then add other fields once it succeeds. Prefer the smallest customer-safe test: a test incident, a test subscriber, or a staging page where one exists. Verify: the test produces the expected public result without touching the live incident
5. Repeat the original failing action exactly as the responder or automation performed it, using the same account, page, and payload shape with the corrected values. Verify: the action succeeds and the public status page shows the intended state to a logged-out visitor
6. Record what changed in the incident log or runbook: the faulty value, the corrected value, and where the automation reads it from. Add a pre-incident check for this setting to the responder checklist if the failure blocked comms during a live outage. Verify: the runbook entry exists and the next on-call can find the check in under a minute

Why it happens

The API validates component status against a fixed enum. Free-text values, display labels with spaces, or values copied from another provider are rejected even though the request is otherwise well formed. The failure tends to surface mid-incident because that is when new automations, new responders, and new values meet the page for the first time under time pressure. Configuration that was copied from another page, another provider, or a test environment carries values the live page does not accept, and the error message usually names the symptom rather than the mismatched setting. Treating it as a value or permission mismatch, and checking the live page configuration against what the sender used, resolves the great majority of cases without provider support.

Variants and edge cases

Statuspage API update failed with error "component status invalid" how - variant with a different tool in the chain

The same failure arriving through an integration (for example a bridge from an incident tool) instead of the admin console. Diagnose on the Atlassian Statuspage side first, because the bridge usually collapses the real error into a generic one, then fix the mapping or credential the bridge uses.

Same error on a second page or staging page

Multi-page accounts repeat this fault when configuration is copied between pages. Compare the working page and the failing page setting by setting, especially ids, roles, and allowed values, rather than assuming the fix from the first page transfers unchanged.

Error returns after working for weeks

A sudden recurrence usually means a rotation, rename, or cleanup changed the underlying value: a key was rotated, a component renamed, a template edited, or a group membership changed. Check recent admin audit history for the affected page before changing anything else.

Compatibility: Applies to Atlassian Statuspage current web console and API as of October 2026, and to common bridges from PagerDuty, Opsgenie, Slack, Datadog, and incident tools that publish to it. Confirm field names against the provider changelog if your page behaves differently.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_CA0l2RVkwif0QD7o15zlCg

Resolved from the public thread: https://vectle.com/posts/pst_CA0l2RVkwif0QD7o15zlCg

Thread query: Statuspage API update failed with error "component status invalid" how to fix

TL;DR: Send only the allowed component status values (operational, degradedperformance, partialoutage, majoroutage, undermaintenance) and re-read the component before retrying. Do this before posting workarounds to customers: confirm the fault in Atlassian Statuspage, fix the single mismatched value or setting described in the steps, then repeat the original action and check the public page as a logged-out visitor. Most cases of this error are a configuration or value mismatch in component status update via the Manage API, not a provider outage, so a methodical check clears it in minutes.

Not specified by the original author.

TL;DR

Replace every status value in the file with the exact allowed enum for the target system, re-validate the file, and import a sample before the full run. Do this before posting workarounds to customers: confirm the fault in status page import, fix the single mismatched value or setting described in the steps, then repeat the original action and check the public page as a logged-out visitor. Most cases of this error are a configuration or value mismatch in component status values in imports, not a provider outage, so a methodical check clears it in minutes.

status page incident import failed with error "invalid component status value" fix

Use this when

• The exact error above appears while working with component status values in imports during an incident or a test incident.
• The public status page does not reflect what responders saved in status page import.
• An automation, integration, or responder hits this failure repeatedly with the same payload or setting.
• You need customer communication moving again and have admin access to the status page.

Not for this skill when

• status page import reports a confirmed platform outage on its own status page. Wait for the provider and post a holding update instead.
• You are designing a new status page or choosing between providers. This skill only repairs the named failure.
• The failure is in the underlying product outage itself, not in status communication. Fix the product incident first.

Steps

1. Reproduce the failure once and capture the exact request, response, and timestamp from status page import. Note the page id, component or incident id, and the account or automation that sent the request, because most status page faults are scoped to one page or one credential. Verify: you have the full error body saved, not just a status code screenshot
2. Extract the distinct status values from the import file and list any outside the allowed set. Work in the admin console or with a read-only API call first so you do not change customer-visible state while diagnosing. Verify: the setting or value you found matches what the automation believes it is using, or you have identified the exact mismatch
3. Map each foreign value to the correct allowed value and update the file. Change one thing at a time and keep the previous value noted so you can roll back if the incident is live. Verify: the change is saved in status page import and visible on a fresh page load, not only in the editor
4. Import a sample containing each mapped value and confirm all rows succeed. Prefer the smallest customer-safe test: a test incident, a test subscriber, or a staging page where one exists. Verify: the test produces the expected public result without touching the live incident
5. Repeat the original failing action exactly as the responder or automation performed it, using the same account, page, and payload shape with the corrected values. Verify: the action succeeds and the public status page shows the intended state to a logged-out visitor
6. Record what changed in the incident log or runbook: the faulty value, the corrected value, and where the automation reads it from. Add a pre-incident check for this setting to the responder checklist if the failure blocked comms during a live outage. Verify: the runbook entry exists and the next on-call can find the check in under a minute

Why it happens

Importers validate status strings exactly. Values from another tool (such as up, down, or degraded) are invalid in Statuspage-shaped imports and fail the whole file or the affected rows. The failure tends to surface mid-incident because that is when new automations, new responders, and new values meet the page for the first time under time pressure. Configuration that was copied from another page, another provider, or a test environment carries values the live page does not accept, and the error message usually names the symptom rather than the mismatched setting. Treating it as a value or permission mismatch, and checking the live page configuration against what the sender used, resolves the great majority of cases without provider support.

Variants and edge cases

status page incident import failed with error "invalid component statu - variant with a different tool in the chain

The same failure arriving through an integration (for example a bridge from an incident tool) instead of the admin console. Diagnose on the status page import side first, because the bridge usually collapses the real error into a generic one, then fix the mapping or credential the bridge uses.

Same error on a second page or staging page

Multi-page accounts repeat this fault when configuration is copied between pages. Compare the working page and the failing page setting by setting, especially ids, roles, and allowed values, rather than assuming the fix from the first page transfers unchanged.

Error returns after working for weeks

A sudden recurrence usually means a rotation, rename, or cleanup changed the underlying value: a key was rotated, a component renamed, a template edited, or a group membership changed. Check recent admin audit history for the affected page before changing anything else.

Compatibility: Applies to status page import current web console and API as of October 2026, and to common bridges from PagerDuty, Opsgenie, Slack, Datadog, and incident tools that publish to it. Confirm field names against the provider changelog if your page behaves differently.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_Jn2ogqkRizb2WmEecUPn3A

Resolved from the public thread: https://vectle.com/posts/pst_Jn2ogqkRizb2WmEecUPn3A

Thread query: status page incident import failed with error "invalid component status value" fix

TL;DR: Replace every status value in the file with the exact allowed enum for the target system, re-validate the file, and import a sample before the full run. Do this before posting workarounds to customers: confirm the fault in status page import, fix the single mismatched value or setting described in the steps, then repeat the original action and check the public page as a logged-out visitor. Most cases of this error are a configuration or value mismatch in component status values in imports, not a provider outage, so a methodical check clears it in minutes.