Jump to

• Request
• Response

View a Gateway App Instance (Deprecated since 24.2)

get

/api/restapi/pims/appInstances/{id}

This endpoint returns Gateway app instances that meet the following requirements:

• The object has an ID that matches the value of the {id} path parameter.

Request

Path Parameters

• id(required): integer(int64)
  ID of application instance.

  Default Value: 0

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : AppInstance

Type: object

Title: AppInstance

The list of application instances associated with a flow.

Show Source

• app(required): object App
  Title: App

  A reference to the App business object.
• description(required): string
  A description of the application instance.
• id(required): integer (int64)
  The unique ID of the application instance generated by the system.
• name(required): string
  The name of the application instance associated with the application instance ID.

{
    "title":"AppInstance",
    "required":[
        "app",
        "description",
        "id",
        "name"
    ],
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"The name of the application instance associated with the application instance ID.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "id":{
            "type":"integer",
            "description":"The unique ID of the application instance generated by the system.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "description":{
            "type":"string",
            "description":"A description of the application instance.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "app":{
            "$ref":"#/components/schemas/App",
            "exampleSetFlag":false
        }
    },
    "description":"The list of application instances associated with a flow.",
    "xml":{
        "name":"AppInstance"
    },
    "exampleSetFlag":false
}

Nested Schema : App

Type: object

Title: App

A reference to the App business object.

Show Source

• appInstances(required): array appInstances
  Unique Items Required: true

  The list of application instances associated with a flow.
• description(required): string
  A description of the application.
• external: boolean
  The indicator which determines whether the provider is external.
• id(required): integer (int64)
  The unique ID of the application generated by the system.
• name(required): string
  The name of the application associated with the flow.
• providerName(required): string
  The Oracle Primavera Gateway provider associated with an application.
• providerPath(required): string
  The path and the folder location of the provider associated with an application. For example, location of the primeprovider folder associated with the Oracle Primavera Cloud application.
• supportFeedback: boolean
  The indicator which determines whether the feedback step in a business flow is enabled.
• version(required): string
  The application version number.

{
    "title":"App",
    "required":[
        "appInstances",
        "description",
        "id",
        "name",
        "providerName",
        "providerPath",
        "version"
    ],
    "type":"object",
    "properties":{
        "providerName":{
            "type":"string",
            "description":"The Oracle Primavera Gateway provider associated with an application.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "name":{
            "type":"string",
            "description":"The name of the application associated with the flow.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "id":{
            "type":"integer",
            "description":"The unique ID of the application generated by the system.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "version":{
            "type":"string",
            "description":"The application version number.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "description":{
            "type":"string",
            "description":"A description of the application.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "providerPath":{
            "type":"string",
            "description":"The path and the folder location of the provider associated with an application. For example, location of the primeprovider folder associated with the Oracle Primavera Cloud application.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "supportFeedback":{
            "type":"boolean",
            "description":"The indicator which determines whether the feedback step in a business flow is enabled.",
            "exampleSetFlag":false,
            "types":[
                "boolean"
            ]
        },
        "external":{
            "type":"boolean",
            "description":"The indicator which determines whether the provider is external.",
            "exampleSetFlag":false,
            "types":[
                "boolean"
            ]
        },
        "appInstances":{
            "uniqueItems":true,
            "type":"array",
            "description":"The list of application instances associated with a flow.",
            "exampleSetFlag":false,
            "items":{
                "$ref":"#/components/schemas/AppInstance",
                "exampleSetFlag":false
            },
            "types":[
                "array"
            ]
        }
    },
    "description":"A reference to the App business object.",
    "xml":{
        "name":"App"
    },
    "exampleSetFlag":false
}

Nested Schema : appInstances

Type: array

Unique Items Required: true

The list of application instances associated with a flow.

Show Source

• Array of: object AppInstance
  Title: AppInstance

  The list of application instances associated with a flow.

{
    "uniqueItems":true,
    "type":"array",
    "description":"The list of application instances associated with a flow.",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/AppInstance",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

404 Response

The requested Gateway app instance does not exist, or you do not have access to it.

Back to Top