> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uselemma.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Inspect project setup status

> Returns setup state, scope, permissions, and stable blocker codes without exposing credentials or provider-private data.



## OpenAPI

````yaml https://api.uselemma.ai/openapi.json get /projects/{project_id}/setup-status
openapi: 3.1.0
info:
  title: Lemma Platform API
  description: Lemma Platform HTTP API for AI observability and workspace operations.
  version: 0.1.0
servers:
  - url: https://api.uselemma.ai
    description: Lemma production API
security:
  - bearerAuth: []
paths:
  /projects/{project_id}/setup-status:
    get:
      tags:
        - Projects
      summary: Inspect project setup status
      description: >-
        Returns setup state, scope, permissions, and stable blocker codes
        without exposing credentials or provider-private data.
      operationId: get_project_setup_status
      parameters:
        - name: project_id
          in: path
          required: true
          description: Project ID.
          schema:
            type: string
      responses:
        '200':
          description: Project setup status
          content:
            application/json:
              schema:
                type: object
                properties:
                  project_id:
                    type: string
                  principal_type:
                    type: string
                    enum:
                      - session
                      - api_key
                      - coding_harness
                      - worker
                      - unknown
                  agent_observability:
                    type: object
                    properties:
                      state:
                        type: string
                        enum:
                          - complete
                          - incomplete
                          - degraded
                          - unavailable
                          - not_applicable
                          - feature_disabled
                      scope:
                        type: string
                        enum:
                          - organization
                          - project
                          - agent
                          - current_person
                          - authenticated_client
                      can_manage:
                        type: boolean
                      reason_code:
                        type:
                          - string
                          - 'null'
                        enum:
                          - observability_status_unavailable
                          - no_ready_traces
                          - no_provided_context
                          - no_generated_understanding
                          - slack_workspace_not_connected
                          - slack_workspace_degraded
                          - slack_alert_channel_not_bound
                          - issue_briefs_disabled
                          - support_channel_not_requested
                          - support_channel_creating
                          - support_channel_invited
                          - support_channel_failed
                          - support_channel_unavailable
                          - support_channel_plan_required
                          - linear_feature_disabled
                          - linear_workspace_not_connected
                          - linear_authentication_required
                          - linear_temporarily_failing
                          - linear_defaults_missing
                          - linear_identity_missing
                          - no_human_principal
                          - external_mcp_not_connected
                          - external_mcp_degraded
                          - no_enabled_webhooks
                          - no_active_api_key
                          - lemma_mcp_not_activated
                          - null
                      has_ready_trace:
                        type:
                          - boolean
                          - 'null'
                    required:
                      - state
                      - scope
                      - can_manage
                      - reason_code
                      - has_ready_trace
                    additionalProperties: false
                  artifacts:
                    type: object
                    properties:
                      provided_context:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                          count:
                            type: integer
                            minimum: 0
                          agent_count:
                            type: integer
                            minimum: 0
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                          - count
                          - agent_count
                        additionalProperties: false
                      generated_understanding:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                          count:
                            type: integer
                            minimum: 0
                          agent_count:
                            type: integer
                            minimum: 0
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                          - count
                          - agent_count
                        additionalProperties: false
                    required:
                      - provided_context
                      - generated_understanding
                    additionalProperties: false
                  slack:
                    type: object
                    properties:
                      workspace:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                        additionalProperties: false
                      alert_channel:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                        additionalProperties: false
                      issue_briefs:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                          enabled:
                            type: boolean
                          cadence:
                            type: string
                            enum:
                              - daily
                              - weekly
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                          - enabled
                          - cadence
                        additionalProperties: false
                      support_channel:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                          lifecycle_status:
                            type: string
                            enum:
                              - not_requested
                              - creating
                              - invited
                              - connected
                              - failed
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                          - lifecycle_status
                        additionalProperties: false
                    required:
                      - workspace
                      - alert_channel
                      - issue_briefs
                      - support_channel
                    additionalProperties: false
                  linear:
                    type: object
                    properties:
                      feature_enabled:
                        type: boolean
                      workspace:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                        additionalProperties: false
                      defaults:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                          team_configured:
                            type: boolean
                          linear_project_configured:
                            type: boolean
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                          - team_configured
                          - linear_project_configured
                        additionalProperties: false
                      current_person_identity:
                        type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - complete
                              - incomplete
                              - degraded
                              - unavailable
                              - not_applicable
                              - feature_disabled
                          scope:
                            type: string
                            enum:
                              - organization
                              - project
                              - agent
                              - current_person
                              - authenticated_client
                          can_manage:
                            type: boolean
                          reason_code:
                            type:
                              - string
                              - 'null'
                            enum:
                              - observability_status_unavailable
                              - no_ready_traces
                              - no_provided_context
                              - no_generated_understanding
                              - slack_workspace_not_connected
                              - slack_workspace_degraded
                              - slack_alert_channel_not_bound
                              - issue_briefs_disabled
                              - support_channel_not_requested
                              - support_channel_creating
                              - support_channel_invited
                              - support_channel_failed
                              - support_channel_unavailable
                              - support_channel_plan_required
                              - linear_feature_disabled
                              - linear_workspace_not_connected
                              - linear_authentication_required
                              - linear_temporarily_failing
                              - linear_defaults_missing
                              - linear_identity_missing
                              - no_human_principal
                              - external_mcp_not_connected
                              - external_mcp_degraded
                              - no_enabled_webhooks
                              - no_active_api_key
                              - lemma_mcp_not_activated
                              - null
                        required:
                          - state
                          - scope
                          - can_manage
                          - reason_code
                        additionalProperties: false
                    required:
                      - feature_enabled
                      - workspace
                      - defaults
                      - current_person_identity
                    additionalProperties: false
                  external_mcp:
                    type: object
                    properties:
                      state:
                        type: string
                        enum:
                          - complete
                          - incomplete
                          - degraded
                          - unavailable
                          - not_applicable
                          - feature_disabled
                      scope:
                        type: string
                        enum:
                          - organization
                          - project
                          - agent
                          - current_person
                          - authenticated_client
                      can_manage:
                        type: boolean
                      reason_code:
                        type:
                          - string
                          - 'null'
                        enum:
                          - observability_status_unavailable
                          - no_ready_traces
                          - no_provided_context
                          - no_generated_understanding
                          - slack_workspace_not_connected
                          - slack_workspace_degraded
                          - slack_alert_channel_not_bound
                          - issue_briefs_disabled
                          - support_channel_not_requested
                          - support_channel_creating
                          - support_channel_invited
                          - support_channel_failed
                          - support_channel_unavailable
                          - support_channel_plan_required
                          - linear_feature_disabled
                          - linear_workspace_not_connected
                          - linear_authentication_required
                          - linear_temporarily_failing
                          - linear_defaults_missing
                          - linear_identity_missing
                          - no_human_principal
                          - external_mcp_not_connected
                          - external_mcp_degraded
                          - no_enabled_webhooks
                          - no_active_api_key
                          - lemma_mcp_not_activated
                          - null
                      total_count:
                        type: integer
                        minimum: 0
                      active_count:
                        type: integer
                        minimum: 0
                      degraded_count:
                        type: integer
                        minimum: 0
                    required:
                      - state
                      - scope
                      - can_manage
                      - reason_code
                      - total_count
                      - active_count
                      - degraded_count
                    additionalProperties: false
                  webhooks:
                    type: object
                    properties:
                      state:
                        type: string
                        enum:
                          - complete
                          - incomplete
                          - degraded
                          - unavailable
                          - not_applicable
                          - feature_disabled
                      scope:
                        type: string
                        enum:
                          - organization
                          - project
                          - agent
                          - current_person
                          - authenticated_client
                      can_manage:
                        type: boolean
                      reason_code:
                        type:
                          - string
                          - 'null'
                        enum:
                          - observability_status_unavailable
                          - no_ready_traces
                          - no_provided_context
                          - no_generated_understanding
                          - slack_workspace_not_connected
                          - slack_workspace_degraded
                          - slack_alert_channel_not_bound
                          - issue_briefs_disabled
                          - support_channel_not_requested
                          - support_channel_creating
                          - support_channel_invited
                          - support_channel_failed
                          - support_channel_unavailable
                          - support_channel_plan_required
                          - linear_feature_disabled
                          - linear_workspace_not_connected
                          - linear_authentication_required
                          - linear_temporarily_failing
                          - linear_defaults_missing
                          - linear_identity_missing
                          - no_human_principal
                          - external_mcp_not_connected
                          - external_mcp_degraded
                          - no_enabled_webhooks
                          - no_active_api_key
                          - lemma_mcp_not_activated
                          - null
                      total_count:
                        type: integer
                        minimum: 0
                      enabled_count:
                        type: integer
                        minimum: 0
                    required:
                      - state
                      - scope
                      - can_manage
                      - reason_code
                      - total_count
                      - enabled_count
                    additionalProperties: false
                  api_keys:
                    type: object
                    properties:
                      state:
                        type: string
                        enum:
                          - complete
                          - incomplete
                          - degraded
                          - unavailable
                          - not_applicable
                          - feature_disabled
                      scope:
                        type: string
                        enum:
                          - organization
                          - project
                          - agent
                          - current_person
                          - authenticated_client
                      can_manage:
                        type: boolean
                      reason_code:
                        type:
                          - string
                          - 'null'
                        enum:
                          - observability_status_unavailable
                          - no_ready_traces
                          - no_provided_context
                          - no_generated_understanding
                          - slack_workspace_not_connected
                          - slack_workspace_degraded
                          - slack_alert_channel_not_bound
                          - issue_briefs_disabled
                          - support_channel_not_requested
                          - support_channel_creating
                          - support_channel_invited
                          - support_channel_failed
                          - support_channel_unavailable
                          - support_channel_plan_required
                          - linear_feature_disabled
                          - linear_workspace_not_connected
                          - linear_authentication_required
                          - linear_temporarily_failing
                          - linear_defaults_missing
                          - linear_identity_missing
                          - no_human_principal
                          - external_mcp_not_connected
                          - external_mcp_degraded
                          - no_enabled_webhooks
                          - no_active_api_key
                          - lemma_mcp_not_activated
                          - null
                      count:
                        type: integer
                        minimum: 0
                    required:
                      - state
                      - scope
                      - can_manage
                      - reason_code
                      - count
                    additionalProperties: false
                  lemma_mcp:
                    type: object
                    properties:
                      state:
                        type: string
                        enum:
                          - complete
                          - incomplete
                          - degraded
                          - unavailable
                          - not_applicable
                          - feature_disabled
                      scope:
                        type: string
                        enum:
                          - organization
                          - project
                          - agent
                          - current_person
                          - authenticated_client
                      can_manage:
                        type: boolean
                      reason_code:
                        type:
                          - string
                          - 'null'
                        enum:
                          - observability_status_unavailable
                          - no_ready_traces
                          - no_provided_context
                          - no_generated_understanding
                          - slack_workspace_not_connected
                          - slack_workspace_degraded
                          - slack_alert_channel_not_bound
                          - issue_briefs_disabled
                          - support_channel_not_requested
                          - support_channel_creating
                          - support_channel_invited
                          - support_channel_failed
                          - support_channel_unavailable
                          - support_channel_plan_required
                          - linear_feature_disabled
                          - linear_workspace_not_connected
                          - linear_authentication_required
                          - linear_temporarily_failing
                          - linear_defaults_missing
                          - linear_identity_missing
                          - no_human_principal
                          - external_mcp_not_connected
                          - external_mcp_degraded
                          - no_enabled_webhooks
                          - no_active_api_key
                          - lemma_mcp_not_activated
                          - null
                      activated_at:
                        type:
                          - string
                          - 'null'
                        format: date-time
                    required:
                      - state
                      - scope
                      - can_manage
                      - reason_code
                      - activated_at
                    additionalProperties: false
                required:
                  - project_id
                  - principal_type
                  - agent_observability
                  - artifacts
                  - slack
                  - linear
                  - external_mcp
                  - webhooks
                  - api_keys
                  - lemma_mcp
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                required:
                  - detail
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````