# Onboarding

## Get onboarding status for a project

> Returns computed onboarding status including step completion, feature group readiness, and overall stage (onboarding vs dashboard).

```json
{"openapi":"3.0.0","info":{"title":"sfp server","version":"51.3.0"},"security":[{"access-token":[]}],"components":{"securitySchemes":{"access-token":{"scheme":"bearer","bearerFormat":"JWT","type":"http","in":"header"}},"schemas":{"OnboardingStatusDto":{"type":"object","properties":{"stage":{"type":"string","enum":["onboarding","dashboard"],"description":"dashboard if any feature is fully onboarded, onboarding otherwise"},"steps":{"description":"Completion state of each onboarding step","allOf":[{"$ref":"#/components/schemas/OnboardingStepsDto"}]},"features":{"type":"object","description":"Per-feature-group onboarding status"},"anyFeatureActive":{"type":"boolean","description":"True if at least one feature group is fully completed"},"allFeaturesActive":{"type":"boolean","description":"True if all feature groups are fully completed"},"isPreflightCompleted":{"type":"boolean","description":"True if project preflight status is already-configured"}},"required":["stage","steps","features","anyFeatureActive","allFeaturesActive","isPreflightCompleted"]},"OnboardingStepsDto":{"type":"object","properties":{"appIntegration":{"type":"boolean","description":"Platform integration (GitHub/ADO) is healthy"},"devHub":{"type":"boolean","description":"At least one Dev Hub org is connected"},"preflight":{"type":"boolean","description":"Project preflight status is already-configured"},"configureWebhooks":{"type":"boolean","description":"At least one webhook is configured for the project"},"hasEnvironment":{"type":"boolean","description":"At least one environment is registered"}},"required":["appIntegration","devHub","preflight","configureWebhooks","hasEnvironment"]}}},"paths":{"/sfp/api/onboarding/status/{identifier}":{"get":{"operationId":"OnboardingStatusController_getOnboardingStatus","summary":"Get onboarding status for a project","description":"Returns computed onboarding status including step completion, feature group readiness, and overall stage (onboarding vs dashboard).","parameters":[{"name":"identifier","required":true,"in":"path","description":"Project identifier (e.g. flxbl-io/sf-core or org/project/repo for Azure DevOps)","schema":{"type":"string"}}],"responses":{"200":{"description":"Onboarding status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnboardingStatusDto"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Requires role: member, application"}},"tags":["Onboarding"]}}}}
```
