Jump to

• Request
• Response

Retrieve Conversations

get

/ic/api/process/v1/process-definitions/{processDefId}/conversations

Retrieves the conversations metadata associated with this process, if any.

Request

Path Parameters

• processDefId(required): string
  Value of process definition ID.

Query Parameters

• name: string
  Retrieves only the conversation for the specified conversation name

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success. Returns the conversations metadata or empty list when there aren't any.

Body ()

Root Schema : Conversation

Type: object

Show Source

• conversationId: string
• description: string
• levels: integer(int32)
• links: array links
• name: string
• postHumanTaskMessagesFlag: boolean
• postMessageOnActivityEntryFlag: boolean
• postMessageOnActivityExitFlag: boolean
• title: string

{
    "type":"object",
    "properties":{
        "levels":{
            "type":"integer",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        },
        "links":{
            "type":"array",
            "items":{
                "xml":{
                    "name":"links"
                },
                "$ref":"#/definitions/Link"
            }
        },
        "title":{
            "type":"string"
        },
        "postMessageOnActivityEntryFlag":{
            "type":"boolean"
        },
        "postMessageOnActivityExitFlag":{
            "type":"boolean"
        },
        "postHumanTaskMessagesFlag":{
            "type":"boolean"
        },
        "name":{
            "type":"string"
        },
        "conversationId":{
            "type":"string"
        },
        "description":{
            "type":"string"
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "items":{
        "xml":{
            "name":"links"
        },
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : Link

Type: object

Show Source

• href: string
• mediaType: string
• rel: string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        },
        "mediaType":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

500 Response

Error in retrieving the folder information

Back to Top