Skip to main content

Retrieve a pending task list.

GET 

/task-status/pending-tasks

experimental

This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.

Retrieve a list of TaskStatus for pending tasks.

Request

Query Parameters

    offset int32

    Default value: 0

    Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.

    Example: 0
    limit int32

    Possible values: <= 250

    Default value: 250

    Max number of results to return. See V3 API Standard Collection Parameters for more information.

    Example: 250
    count boolean

    If true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored.

    Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used.

    See V3 API Standard Collection Parameters for more information.

    Example: true

Header Parameters

    X-SailPoint-Experimental stringrequired

    Default value: true

    Use this header to enable this experimental API.

    Example: true

Responses

Responds with a list of TaskStatus for pending tasks.

Schema

  • Array [

  • id stringrequired

    System-generated unique ID of the task this TaskStatus represents

    type stringrequired

    Possible values: [QUARTZ, QPOC, QUEUED_TASK]

    Type of task this TaskStatus represents

    uniqueName stringrequired

    Name of the task this TaskStatus represents

    description stringrequired

    Description of the task this TaskStatus represents

    parentName stringnullablerequired

    Name of the parent of the task this TaskStatus represents

    launcher stringrequired

    Service to execute the task this TaskStatus represents

    target

    object

    nullable

    id string

    Target ID

    type stringnullable

    Possible values: [APPLICATION, IDENTITY, null]

    Target type

    name string

    Target name

    created date-timerequired

    Creation date of the task this TaskStatus represents

    modified date-timerequired

    Last modification date of the task this TaskStatus represents

    launched date-timenullablerequired

    Launch date of the task this TaskStatus represents

    completed date-timenullablerequired

    Completion date of the task this TaskStatus represents

    completionStatus stringnullablerequired

    Possible values: [SUCCESS, WARNING, ERROR, TERMINATED, TEMPERROR, null]

    Completion status of the task this TaskStatus represents

    messages

    object[]

    required

    Messages associated with the task this TaskStatus represents

  • Array [

  • type stringrequired

    Possible values: [INFO, WARN, ERROR]

    Type of the message

    localizedText

    object

    nullable

    required

    Localized form of the message

    locale stringrequired

    Message locale

    message stringrequired

    Message text

    key stringrequired

    Key of the message

    parameters object[]nullablerequired

    Message parameters for internationalization

  • ]

  • returns

    object[]

    required

    Return values from the task this TaskStatus represents

  • Array [

  • name stringrequired

    Display name of the TaskReturnDetails

    attributeName stringrequired

    Attribute the TaskReturnDetails is for

  • ]

  • attributes

    object

    required

    Attributes of the task this TaskStatus represents

    property name* any

    Attributes of the task this TaskStatus represents

    progress stringnullablerequired

    Current progress of the task this TaskStatus represents

    percentComplete integerrequired

    Current percentage completion of the task this TaskStatus represents

    taskDefinitionSummary

    object

    Definition of a type of task, used to invoke tasks

    id stringrequired

    System-generated unique ID of the TaskDefinition

    uniqueName stringrequired

    Name of the TaskDefinition

    description stringrequired

    Description of the TaskDefinition

    parentName stringrequired

    Name of the parent of the TaskDefinition

    executor stringnullablerequired

    Executor of the TaskDefinition

    arguments

    object

    required

    Formal parameters of the TaskDefinition, without values

    property name* any

    Formal parameters of the TaskDefinition, without values

  • ]

Loading...