Bellator Schedule Intelligence Resource Management API

openapi: 3.2.0
info:
  title: Bellatorsi Com Resource Management API
  version: '1.0'
  description: 'Operations tagged Resource Management across 2 of this provider''s published API definitions: api-bellatorsi-com-openapi.json, bellatorsi-com-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Resource Management
paths:
  /api/v1/resources/allocate:
    post:
      tags:
      - Resource Management
      summary: Allocate Resources (Placeholder)
      description: Resource allocation optimization - not yet implemented
      operationId: allocate_resources_api_v1_resources_allocate_post
      parameters:
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-bellator-internal-dispatch
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Bellator-Internal-Dispatch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceAllocationRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceAllocationResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/resources/level:
    post:
      tags:
      - Resource Management
      summary: Resource Leveling (Placeholder)
      description: Resource leveling optimization - not yet implemented
      operationId: level_resources_api_v1_resources_level_post
      parameters:
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-bellator-internal-dispatch
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Bellator-Internal-Dispatch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceAllocationRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ResourceAllocationResponse:
      properties:
        allocation:
          additionalProperties: true
          type: object
          title: Allocation
          description: Resource allocation results
        message:
          type: string
          title: Message
          default: Resource allocation is not yet implemented
      type: object
      title: ResourceAllocationResponse
      description: Response model for resource allocation (placeholder).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    RelationshipType:
      type: string
      enum:
      - FS
      - SS
      - FF
      - SF
      title: RelationshipType
      description: "Task relationship types per PMBOK 6.3.2.2.\n\nAttributes:\n    FINISH_START: Predecessor finish → successor start (most common, ~90%)\n    START_START: Predecessor start → successor start (~5%)\n    FINISH_FINISH: Predecessor finish → successor finish (~4%)\n    START_FINISH: Predecessor start → successor finish (rare, ~1%)"
    DependencyLink:
      properties:
        task_id:
          type: string
          title: Task Id
          description: Predecessor task ID
        relationship_type:
          $ref: '#/components/schemas/RelationshipType'
          description: Relationship type (FS/SS/FF/SF)
          default: FS
        lag_days:
          type: number
          title: Lag Days
          description: Lag (positive) or lead (negative) in days
          default: 0.0
        is_external:
          type: boolean
          title: Is External
          description: True if link to external project file
          default: false
        external_path:
          anyOf:
          - type: string
          - type: 'null'
          title: External Path
          description: Path to external file if is_external=True
      type: object
      required:
      - task_id
      title: DependencyLink
      description: "Rich dependency link with relationship type and lag/lead.\n\nSupports parsing from various scheduling tool formats including:\n- MS Project: \"10FS+5 d\", \"/path/file.mpp/10FS+5 d\"\n- Primavera P6: Similar format with XER encoding\n- Server-based: \"<ServerFile>10FS+5 d\"\n- Simple: \"10\" (defaults to FS with zero lag)\n\nExamples:\n    >>> DependencyLink(task_id=\"10\", relationship_type=\"FS\", lag_days=5.0)\n    >>> DependencyLink.from_string(\"10FS+5 d\")\n    >>> DependencyLink.from_string(\"15SS-2 d\")"
      examples:
      - is_external: false
        lag_days: 5.0
        relationship_type: FS
        task_id: '10'
      - is_external: false
        lag_days: -2.0
        relationship_type: SS
        task_id: '15'
      - external_path: /path/to/external.mpp
        is_external: true
        lag_days: 5.0
        relationship_type: FS
        task_id: '20'
    ResourceAllocationRequest:
      properties:
        tasks:
          items:
            $ref: '#/components/schemas/Task'
          type: array
          title: Tasks
        resources:
          items:
            type: string
          type: array
          title: Resources
          description: Available resources
      type: object
      required:
      - tasks
      title: ResourceAllocationRequest
      description: Request model for resource allocation (placeholder).
    Task:
      properties:
        id:
          type: string
          title: Id
          description: Unique task identifier
        duration_days:
          type: number
          minimum: 0.0
          title: Duration Days
          description: Task duration in days
          default: 0
        predecessors:
          items:
            anyOf:
            - type: string
            - additionalProperties: true
              type: object
            - $ref: '#/components/schemas/DependencyLink'
          type: array
          title: Predecessors
          description: 'List of predecessor task IDs or dependency links. Supports: ''T1'', ''T1FS+5 d'', ''T2SS-2 d'', or DependencyLink objects'
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
          description: Task name
        resource:
          anyOf:
          - type: string
          - type: 'null'
          title: Resource
          description: Resource assigned to task
        resources:
          items:
            type: string
          type: array
          title: Resources
          description: List of resources assigned (for multi-resource tasks)
        percent_complete:
          type: number
          maximum: 100.0
          minimum: 0.0
          title: Percent Complete
          description: Percent complete (0-100)
          default: 0
        physical_percent_complete:
          anyOf:
          - type: number
            maximum: 100.0
            minimum: 0.0
          - type: 'null'
          title: Physical Percent Complete
          description: Physical percent complete (0-100). Manual EVM entry by scheduler (MSP PhysicalPercentComplete). Authoritative for BCWP calculations. Captured separately from percent_complete on MSP imports.
        planned_start:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Planned Start
          description: Planned start date (ISO 8601)
        planned_finish:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Planned Finish
          description: Planned finish date (ISO 8601)
        actual_start:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Actual Start
          description: Actual start date (ISO 8601)
        actual_finish:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Actual Finish
          description: Actual finish date (ISO 8601)
        baseline_start:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Baseline Start
          description: Baseline start date (ISO 8601)
        baseline_finish:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Baseline Finish
          description: Baseline finish date (ISO 8601)
        constraint_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Constraint Type
          description: 'Constraint type: ASAP, ALAP, SNET, SNLT, FNET, FNLT, MSO, MFO'
        constraint_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Constraint Date
          description: Constraint date if applicable (ISO 8601)
        task_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Type
          description: 'Task type classification. Valid values: task (default), milestone, loe, summary, schedule_margin, planning_package, slpp, schedule_visibility. Drives DCMA check exclusions per PAM 200.1 § 3.2.'
        wbs_code:
          anyOf:
          - type: string
            maxLength: 100
          - type: 'null'
          title: Wbs Code
          description: WBS code (e.g., '1.2.3')
        organization_code:
          anyOf:
          - type: string
          - type: 'null'
          title: Organization Code
          description: Org/dept identifier for anomaly categorization (Progress Audit)
        custom_field_map:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          title: Custom Field Map
          description: All WBS/OBS-pattern custom fields discovered in this MS Project file, keyed by alias (e.g., 'CWBS', 'OBS'). Null for XER imports or when no matching aliases exist.
        forecast_start:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Forecast Start
          description: Current forecast start date (ISO 8601)
        forecast_finish:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Forecast Finish
          description: Current forecast finish date (ISO 8601)
        total_float_days:
          anyOf:
          - type: number
          - type: 'null'
          title: Total Float Days
          description: Pre-computed total float in days. Auto-computed by CPM if absent.
        baseline_duration_days:
          anyOf:
          - type: number
            minimum: 0.0
          - type: 'null'
          title: Baseline Duration Days
          description: Baseline duration in days. Auto-computed from baseline dates if absent.
        delay_category:
          anyOf:
          - type: string
          - type: 'null'
          title: Delay Category
          description: 'Delay attribution category. Valid values: owner, contractor, design, procurement, weather, force_majeure.'
        earned_value:
          anyOf:
          - type: number
            minimum: 0.0
          - type: 'null'
          title: Earned Value
          description: Earned Value (BCWP) in cost units. Requires options.include_ev_validation.
        budgeted_cost:
          anyOf:
          - type: number
            minimum: 0.0
          - type: 'null'
          title: Budgeted Cost
          description: Budgeted Cost of Work Scheduled (BCWS) in cost units.
        approval_required:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Approval Required
          description: Whether this task requires explicit approval before it can start.
        approval_status:
          anyOf:
          - type: string
          - type: 'null'
          title: Approval Status
          description: 'Approval workflow state. Valid values: not_required, pending, approved, rejected.'
      type: object
      required:
      - id
      title: Task
      description: 'Unified task model for all schedule analysis endpoints.


        This model is used across all Tier 1 and Tier 2 APIs. Fields are optional

        unless specifically required by an endpoint.


        Field Naming Rationale:

        - duration_days: Explicit time unit (vs generic "duration")

        - predecessors: Standard scheduling terminology (vs generic "dependencies")


        Dependency Format Support:

        - Simple: ["task1", "task2"]

        - Rich: ["task1FS+5 d", "task2SS-2 d"]

        - Objects: [DependencyLink(...), ...]'
      example:
        duration_days: 10
        id: T1
        name: Design Phase
        percent_complete: 0
        planned_finish: '2026-01-15'
        planned_start: '2026-01-01'
        predecessors: []
        resource: Team A
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Required when API_KEY is configured.
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://login.microsoftonline.com/{tenant}/oauth2/v2.0/authorize
          tokenUrl: https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token
          scopes:
            api.read: Read access to API
            api.write: Write access to API
      description: OAuth 2.0 / Azure AD authentication (recommended)
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT Bearer token from OAuth 2.0 / Azure AD
x-refined-from:
- api-bellatorsi-com-openapi.json
- bellatorsi-com-openapi.json