Jump to

• Request
• Response
• Examples

Get an import package status

get

/AgentWeb/api/elementmanager/import/EMPackages/{id}

Gets import package status given an id

Request

Path Parameters

• id: integer
  Specify the id of the package

Header Parameters

• API_VERSION(optional): string
  API VERSION for the header

  Default Value: 1

  Allowed Values: [ "1" ]
• USERSESSION: string
  Authentication token for the header

Back to Top

Response

Supported Media Types

• application/json

200 Response

Status of import

Body ()

Root Schema : EMStatus

Type: object

Show Source

• desc: string
• exception(optional): object PublicApiExceptionResponse
• href: string
• id: integer(int64)
• items: array items
• name: string
• status: object EMPackageStatus
• statusId(optional): integer
• type: string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "desc":{
            "type":"string"
        },
        "id":{
            "type":"integer",
            "format":"int64"
        },
        "href":{
            "type":"string"
        },
        "statusId":{
            "type":"integer"
        },
        "status":{
            "$ref":"#/definitions/EMPackageStatus"
        },
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/EMProcessedItem"
            }
        },
        "exception":{
            "$ref":"#/definitions/PublicApiExceptionResponse"
        }
    },
    "required":[
        "name",
        "type",
        "desc",
        "id",
        "href",
        "status",
        "items"
    ]
}

Nested Schema : PublicApiExceptionResponse

Type: object

Show Source

• className(optional): string
• detail(optional): string
• errorCode: integer
• href: string
• instance(optional): string
• methodName(optional): string
• status: integer
• title: integer(int64)
• type: string

{
    "type":"object",
    "properties":{
        "title":{
            "type":"integer",
            "format":"int64"
        },
        "type":{
            "type":"string"
        },
        "status":{
            "type":"integer"
        },
        "detail":{
            "type":"string"
        },
        "instance":{
            "type":"string"
        },
        "errorCode":{
            "type":"integer"
        },
        "href":{
            "type":"string"
        },
        "methodName":{
            "type":"string"
        },
        "className":{
            "type":"string"
        }
    },
    "required":[
        "title",
        "type",
        "status",
        "href",
        "errorCode"
    ]
}

Nested Schema : items

Type: array

Show Source

• Array of: object EMProcessedItem

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/EMProcessedItem"
    }
}

Nested Schema : EMPackageStatus

Type: object

Show Source

• code: integer
• description: string
• errorCode: string

{
    "type":"object",
    "properties":{
        "description":{
            "type":"string"
        },
        "errorCode":{
            "type":"string"
        },
        "code":{
            "type":"integer"
        }
    },
    "required":[
        "description",
        "code",
        "errorCode"
    ]
}

Nested Schema : EMProcessedItem

Type: object

Show Source

• elementId: integer
• folderPath(optional): string
• id: integer(int64)
• name: string
• stage: object EMCodeDescPair
• type: string
• validationError(optional): object EMCodeDescPair

{
    "type":"object",
    "properties":{
        "id":{
            "type":"integer",
            "format":"int64"
        },
        "type":{
            "type":"string"
        },
        "stage":{
            "$ref":"#/definitions/EMCodeDescPair"
        },
        "name":{
            "type":"string"
        },
        "elementId":{
            "type":"integer"
        },
        "folderPath":{
            "type":"string"
        },
        "validationError":{
            "$ref":"#/definitions/EMCodeDescPair"
        }
    },
    "required":[
        "id",
        "type",
        "stage",
        "name",
        "elementId"
    ]
}

Nested Schema : EMCodeDescPair

Type: object

Show Source

• code: string
• description: string

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string"
        },
        "description":{
            "type":"string"
        }
    },
    "required":[
        "code",
        "description"
    ]
}

Back to Top

Examples

The following example shows how to get the status of an import.

cURL Command Example

curl -X GET https://mysite.example.com/AgentWeb/api/elementmanager/import/EMPackages/100010 -H "USERSESSION: feihg98GnT7i" -H "API_VERSION: 1" -H "Content-Type: application/json"

Response Body Example

The following shows an example of the response body in JSON format.

{
    "description": "State of the import package",
    "id": 100010,
    "name": "Test import report",
    "status": {
        "code": "10",
        "description": "Import Complete"
    },
    "items": [
        {
            "id": 101257,
            "elementId": 38,
            "name": "ContactReportOpen",
            "type": "Report",
            "stage": {
                "code": "5",
                "description": "Artifact Live"
            },
            "folderPath": "AgentBrowser/ContactFilter"
        }
    ]
}

Back to Top