openapi: 3.1.0 info: title: Oracle Fusion Cloud Applications Oracle Fusion Project Management REST API description: >- REST APIs for Oracle Fusion Cloud Project Management, enabling integration with project planning, project costing, project billing, grants management, and project execution capabilities. The API supports managing project resources, tasks, budgets, deliverables, change orders, awards, and financial project plans. version: 11.13.18.05 contact: name: Oracle Support url: https://support.oracle.com email: support@oracle.com license: name: Oracle Cloud Services Agreement url: https://www.oracle.com/corporate/contracts/cloud-services/ termsOfService: https://www.oracle.com/corporate/contracts/cloud-services/ externalDocs: description: Oracle Fusion Cloud Project Management REST API Documentation url: https://docs.oracle.com/en/cloud/saas/project-management/26a/fapap/index.html servers: - url: https://{instance}.oraclecloud.com description: Oracle Fusion Cloud Instance variables: instance: default: servername description: Your Oracle Cloud instance identifier tags: - name: Award Budgets description: Manage award budget versions and lines - name: Awards description: Manage grants and awards - name: Change Orders description: Manage project change orders - name: Deliverables description: Manage project deliverables - name: Expenditure Types description: Manage expenditure type definitions - name: Financial Project Plans description: Manage financial plans, budgets, and forecasts - name: Project Tasks description: Manage project task hierarchies and assignments - name: Projects description: Manage project definitions and attributes security: - bearerAuth: [] paths: /fscmRestApi/resources/11.13.18.05/projects: get: operationId: listProjects summary: Oracle Fusion Cloud Applications List projects description: >- Retrieve project definitions including project attributes, organizational assignments, and status information. tags: - Projects parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/q' - $ref: '#/components/parameters/orderBy' - $ref: '#/components/parameters/finder' - $ref: '#/components/parameters/expand' responses: '200': description: Projects retrieved content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/Project' count: type: integer hasMore: type: boolean totalResults: type: integer '401': $ref: '#/components/responses/Unauthorized' post: operationId: createProject summary: Oracle Fusion Cloud Applications Create a project description: Create a new project definition with attributes and assignments. tags: - Projects requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProjectCreate' responses: '201': description: Project created content: application/json: schema: $ref: '#/components/schemas/Project' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' /fscmRestApi/resources/11.13.18.05/projects/{ProjectId}: get: operationId: getProject summary: Oracle Fusion Cloud Applications Get a project description: Retrieve a specific project definition by identifier. tags: - Projects parameters: - name: ProjectId in: path required: true description: Unique project identifier schema: type: integer - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/expand' responses: '200': description: Project details content: application/json: schema: $ref: '#/components/schemas/Project' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' patch: operationId: updateProject summary: Oracle Fusion Cloud Applications Update a project description: Update an existing project definition. tags: - Projects parameters: - name: ProjectId in: path required: true schema: type: integer requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProjectUpdate' responses: '200': description: Project updated content: application/json: schema: $ref: '#/components/schemas/Project' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' /fscmRestApi/resources/11.13.18.05/projectTasks: get: operationId: listProjectTasks summary: Oracle Fusion Cloud Applications List project tasks description: >- Retrieve project task records including task hierarchy, dates, assignments, and progress information. tags: - Project Tasks parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/q' - $ref: '#/components/parameters/finder' responses: '200': description: Project tasks retrieved content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/ProjectTask' count: type: integer hasMore: type: boolean '401': $ref: '#/components/responses/Unauthorized' post: operationId: createProjectTask summary: Oracle Fusion Cloud Applications Create a project task description: Create a new task within a project. tags: - Project Tasks requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProjectTaskCreate' responses: '201': description: Project task created content: application/json: schema: $ref: '#/components/schemas/ProjectTask' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' /fscmRestApi/resources/11.13.18.05/awards: get: operationId: listAwards summary: Oracle Fusion Cloud Applications List awards description: >- Retrieve grant and award records including funding sources, budget periods, and personnel assignments. tags: - Awards parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/q' - $ref: '#/components/parameters/finder' responses: '200': description: Awards retrieved content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/Award' count: type: integer hasMore: type: boolean '401': $ref: '#/components/responses/Unauthorized' post: operationId: createAward summary: Oracle Fusion Cloud Applications Create an award description: Create a new grant or award record. tags: - Awards requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AwardCreate' responses: '201': description: Award created content: application/json: schema: $ref: '#/components/schemas/Award' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' /fscmRestApi/resources/11.13.18.05/awards/{AwardId}: get: operationId: getAward summary: Oracle Fusion Cloud Applications Get an award description: Retrieve a specific award record. tags: - Awards parameters: - name: AwardId in: path required: true description: Award unique identifier schema: type: integer - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/expand' responses: '200': description: Award details content: application/json: schema: $ref: '#/components/schemas/Award' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' patch: operationId: updateAward summary: Oracle Fusion Cloud Applications Update an award description: Update an existing award record. tags: - Awards parameters: - name: AwardId in: path required: true schema: type: integer requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AwardCreate' responses: '200': description: Award updated '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' /fscmRestApi/resources/11.13.18.05/awardBudgets: get: operationId: listAwardBudgets summary: Oracle Fusion Cloud Applications List award budgets description: >- Retrieve award budget versions including planning options, resources, and budget lines. tags: - Award Budgets parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/q' - $ref: '#/components/parameters/finder' responses: '200': description: Award budgets retrieved content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/AwardBudget' count: type: integer hasMore: type: boolean '401': $ref: '#/components/responses/Unauthorized' post: operationId: createAwardBudget summary: Oracle Fusion Cloud Applications Create an award budget description: Create a new award budget version. tags: - Award Budgets requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AwardBudgetCreate' responses: '201': description: Award budget created content: application/json: schema: $ref: '#/components/schemas/AwardBudget' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' /fscmRestApi/resources/11.13.18.05/awardBudgets/{PlanVersionId}: get: operationId: getAwardBudget summary: Oracle Fusion Cloud Applications Get an award budget description: Retrieve a specific award budget version. tags: - Award Budgets parameters: - name: PlanVersionId in: path required: true description: Plan version identifier schema: type: integer responses: '200': description: Award budget details content: application/json: schema: $ref: '#/components/schemas/AwardBudget' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' patch: operationId: updateAwardBudget summary: Oracle Fusion Cloud Applications Update an award budget description: Update an existing award budget version. tags: - Award Budgets parameters: - name: PlanVersionId in: path required: true schema: type: integer requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AwardBudgetCreate' responses: '200': description: Award budget updated '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' delete: operationId: deleteAwardBudget summary: Oracle Fusion Cloud Applications Delete an award budget description: Delete an award budget version. tags: - Award Budgets parameters: - name: PlanVersionId in: path required: true schema: type: integer responses: '204': description: Award budget deleted '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' /fscmRestApi/resources/11.13.18.05/changeOrders: get: operationId: listChangeOrders summary: Oracle Fusion Cloud Applications List change orders description: >- Retrieve project change order records including change impacts, participants, and approval status. tags: - Change Orders parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/q' - $ref: '#/components/parameters/finder' responses: '200': description: Change orders retrieved content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/ChangeOrder' count: type: integer hasMore: type: boolean '401': $ref: '#/components/responses/Unauthorized' post: operationId: createChangeOrder summary: Oracle Fusion Cloud Applications Create a change order description: Create a new project change order. tags: - Change Orders requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ChangeOrderCreate' responses: '201': description: Change order created content: application/json: schema: $ref: '#/components/schemas/ChangeOrder' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' /fscmRestApi/resources/11.13.18.05/changeOrders/{ChangeDocumentId}: get: operationId: getChangeOrder summary: Oracle Fusion Cloud Applications Get a change order description: Retrieve a specific change order record. tags: - Change Orders parameters: - name: ChangeDocumentId in: path required: true schema: type: integer responses: '200': description: Change order details content: application/json: schema: $ref: '#/components/schemas/ChangeOrder' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' patch: operationId: updateChangeOrder summary: Oracle Fusion Cloud Applications Update a change order description: Update an existing change order. tags: - Change Orders parameters: - name: ChangeDocumentId in: path required: true schema: type: integer requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ChangeOrderCreate' responses: '200': description: Change order updated '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' delete: operationId: deleteChangeOrder summary: Oracle Fusion Cloud Applications Delete a change order description: Delete an existing change order. tags: - Change Orders parameters: - name: ChangeDocumentId in: path required: true schema: type: integer responses: '204': description: Change order deleted '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' /fscmRestApi/resources/11.13.18.05/deliverables: get: operationId: listDeliverables summary: Oracle Fusion Cloud Applications List deliverables description: >- Retrieve project deliverable records including task associations and requirement linkages. tags: - Deliverables parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/q' - $ref: '#/components/parameters/finder' responses: '200': description: Deliverables retrieved content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/Deliverable' count: type: integer hasMore: type: boolean '401': $ref: '#/components/responses/Unauthorized' post: operationId: createDeliverable summary: Oracle Fusion Cloud Applications Create a deliverable description: Create a new project deliverable. tags: - Deliverables requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DeliverableCreate' responses: '201': description: Deliverable created content: application/json: schema: $ref: '#/components/schemas/Deliverable' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' /fscmRestApi/resources/11.13.18.05/financialProjectPlans: get: operationId: listFinancialProjectPlans summary: Oracle Fusion Cloud Applications List financial project plans description: >- Retrieve financial project plan versions including budgets, forecasts, resource assignments, and planning options. tags: - Financial Project Plans parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/q' - $ref: '#/components/parameters/finder' responses: '200': description: Financial project plans retrieved content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/FinancialProjectPlan' count: type: integer hasMore: type: boolean '401': $ref: '#/components/responses/Unauthorized' post: operationId: createFinancialProjectPlan summary: Oracle Fusion Cloud Applications Create a financial project plan description: Create a new financial project plan version. tags: - Financial Project Plans requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/FinancialProjectPlanCreate' responses: '201': description: Financial project plan created content: application/json: schema: $ref: '#/components/schemas/FinancialProjectPlan' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' /fscmRestApi/resources/11.13.18.05/expenditureTypes: get: operationId: listExpenditureTypes summary: Oracle Fusion Cloud Applications List expenditure types description: >- Retrieve expenditure type definitions used in project costing and billing. tags: - Expenditure Types parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/fields' - $ref: '#/components/parameters/q' responses: '200': description: Expenditure types retrieved content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/ExpenditureType' count: type: integer hasMore: type: boolean '401': $ref: '#/components/responses/Unauthorized' /fscmRestApi/resources/11.13.18.05/expenditureTypes/{ExpenditureTypeId}: get: operationId: getExpenditureType summary: Oracle Fusion Cloud Applications Get an expenditure type description: Retrieve a specific expenditure type definition. tags: - Expenditure Types parameters: - name: ExpenditureTypeId in: path required: true schema: type: integer responses: '200': description: Expenditure type details content: application/json: schema: $ref: '#/components/schemas/ExpenditureType' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT basicAuth: type: http scheme: basic parameters: limit: name: limit in: query required: false schema: type: integer default: 25 maximum: 500 offset: name: offset in: query required: false schema: type: integer default: 0 fields: name: fields in: query required: false schema: type: string q: name: q in: query required: false schema: type: string orderBy: name: orderBy in: query required: false schema: type: string finder: name: finder in: query required: false schema: type: string expand: name: expand in: query required: false schema: type: string responses: BadRequest: description: Invalid request parameters or payload Unauthorized: description: Authentication credentials are missing or invalid NotFound: description: The requested resource was not found schemas: Project: type: object properties: ProjectId: type: integer description: Project identifier ProjectNumber: type: string description: Project number ProjectName: type: string description: Project name ProjectDescription: type: string description: Project description ProjectType: type: string description: Project type classification ProjectStatus: type: string description: Current project status enum: - Submitted - Active - On Hold - Closed - Pending Close ProjectOrganization: type: string description: Owning organization ProjectManager: type: string description: Project manager name StartDate: type: string format: date description: Project start date EndDate: type: string format: date description: Project end date LegalEntity: type: string description: Legal entity name BusinessUnit: type: string description: Business unit name CurrencyCode: type: string description: Project currency CreationDate: type: string format: date-time ProjectCreate: type: object required: - ProjectName - ProjectOrganization - StartDate properties: ProjectName: type: string ProjectDescription: type: string ProjectType: type: string ProjectOrganization: type: string ProjectManager: type: string StartDate: type: string format: date EndDate: type: string format: date LegalEntity: type: string BusinessUnit: type: string CurrencyCode: type: string ProjectUpdate: type: object properties: ProjectName: type: string ProjectDescription: type: string ProjectStatus: type: string ProjectManager: type: string EndDate: type: string format: date ProjectTask: type: object properties: TaskId: type: integer description: Task identifier TaskNumber: type: string description: Task number TaskName: type: string description: Task name ProjectId: type: integer description: Parent project identifier ProjectNumber: type: string description: Parent project number ParentTaskId: type: integer description: Parent task identifier for hierarchy StartDate: type: string format: date description: Task start date EndDate: type: string format: date description: Task end date TaskLevel: type: integer description: Task level in hierarchy PlannedEfffort: type: number format: double description: Planned effort ActualEffort: type: number format: double description: Actual effort PercentComplete: type: number format: double description: Completion percentage TaskStatus: type: string description: Task status ProjectTaskCreate: type: object required: - TaskName - ProjectId - StartDate properties: TaskName: type: string ProjectId: type: integer ParentTaskId: type: integer StartDate: type: string format: date EndDate: type: string format: date PlannedEffort: type: number format: double Award: type: object properties: AwardId: type: integer description: Award identifier AwardNumber: type: string description: Award number AwardName: type: string description: Award name AwardType: type: string description: Type of award SponsorName: type: string description: Sponsor or funding agency name AwardStatus: type: string description: Award status enum: - Active - On Hold - Closed - At Risk StartDate: type: string format: date description: Award start date EndDate: type: string format: date description: Award end date TotalFunding: type: number format: double description: Total funding amount CurrencyCode: type: string description: Funding currency PrincipalInvestigator: type: string description: Principal investigator name CreationDate: type: string format: date-time AwardCreate: type: object required: - AwardName - SponsorName - StartDate properties: AwardName: type: string AwardType: type: string SponsorName: type: string StartDate: type: string format: date EndDate: type: string format: date TotalFunding: type: number format: double CurrencyCode: type: string PrincipalInvestigator: type: string AwardBudget: type: object properties: PlanVersionId: type: integer description: Plan version identifier AwardId: type: integer description: Associated award identifier BudgetName: type: string description: Budget version name BudgetStatus: type: string description: Budget status enum: - Working - Submitted - Baselined - Rejected TotalBudgetAmount: type: number format: double description: Total budget amount CurrencyCode: type: string description: Budget currency VersionNumber: type: integer description: Budget version number CreationDate: type: string format: date-time AwardBudgetCreate: type: object required: - AwardId - BudgetName properties: AwardId: type: integer BudgetName: type: string TotalBudgetAmount: type: number format: double CurrencyCode: type: string ChangeOrder: type: object properties: ChangeDocumentId: type: integer description: Change document identifier ChangeDocumentNumber: type: string description: Change document number ChangeDocumentName: type: string description: Change document name ProjectId: type: integer description: Associated project identifier ProjectNumber: type: string description: Associated project number Description: type: string description: Change order description Status: type: string description: Change order status enum: - Draft - Submitted - Approved - Rejected - Applied ImpactType: type: string description: Type of impact (Cost, Schedule, Scope) RequestedBy: type: string description: Requester name CreationDate: type: string format: date-time ChangeOrderCreate: type: object required: - ChangeDocumentName - ProjectId properties: ChangeDocumentName: type: string ProjectId: type: integer Description: type: string ImpactType: type: string Deliverable: type: object properties: DeliverableId: type: integer description: Deliverable identifier DeliverableName: type: string description: Deliverable name Description: type: string description: Deliverable description DueDate: type: string format: date description: Due date Status: type: string description: Deliverable status enum: - Not Started - In Progress - Completed - Overdue CompletionDate: type: string format: date description: Actual completion date CreationDate: type: string format: date-time DeliverableCreate: type: object required: - DeliverableName - DueDate properties: DeliverableName: type: string Description: type: string DueDate: type: string format: date FinancialProjectPlan: type: object properties: PlanVersionId: type: integer description: Plan version identifier ProjectId: type: integer description: Associated project identifier PlanName: type: string description: Financial plan name PlanType: type: string description: Plan type enum: - Budget - Forecast VersionNumber: type: integer description: Version number Status: type: string description: Plan status enum: - Working - Submitted - Baselined - Rejected TotalPlannedCost: type: number format: double description: Total planned cost TotalPlannedRevenue: type: number format: double description: Total planned revenue CurrencyCode: type: string description: Plan currency CreationDate: type: string format: date-time FinancialProjectPlanCreate: type: object required: - ProjectId - PlanName - PlanType properties: ProjectId: type: integer PlanName: type: string PlanType: type: string enum: - Budget - Forecast CurrencyCode: type: string ExpenditureType: type: object properties: ExpenditureTypeId: type: integer description: Expenditure type identifier ExpenditureTypeName: type: string description: Expenditure type name Description: type: string description: Description ExpenditureCategory: type: string description: Expenditure category RevenueCategory: type: string description: Revenue category StartDate: type: string format: date description: Start date EndDate: type: string format: date description: End date