Skip to main content

Retrieve a task status list.

GET 

/task-status

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.

Use this endpoint to get a list of completed tasks. To get a list of tasks in-progress, please use the get pending tasks endpoint.

Request

Query Parameters

    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
    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
    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
    filters string

    Filter results using the standard syntax described in V3 API Standard Collection Parameters

    Filtering is supported for the following fields and operators:

    id: eq, in

    sourceId: eq, in

    completionStatus: eq, in

    type: eq, in

    Example: completionStatus eq "Success"
    sorters comma-separated

    Sort results using the standard syntax described in V3 API Standard Collection Parameters

    Sorting is supported for the following fields: created

    Example: -created

Header Parameters

    X-SailPoint-Experimental stringrequired

    Default value: true

    Use this header to enable this experimental API.

    Example: true

Responses

Responds with a TaskStatus for the task with the given task ID.

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...