Jump to

• Request
• Response

Get Export List

get

/api/v1/bots/{botId}/insightExports

Returns a list of the skill bot's export tasks.

Request

Path Parameters

• botId(required): string
  The ID of the skill bot.

Query Parameters

• limit: integer(int64)
  The number of items to return.

  Default Value: 100
• offset: integer(int64)
  The number of items to skip before starting to collect the result set, where 0 is the first item.

  Default Value: 0
• totalResults: boolean
  Whether to return the total number of items that match the request (excluding the paging parameters).

  Default Value: false

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success.

Body ()

Root Schema : InsightsExportPagingData

Type: object

List of a skill's insights-export tasks.

Show Source

• count: integer (int32)
  The number of items returned.
• hasMore: boolean
  Indicates if there are more items to be returned.
• items: array items
  The items being returned.
• limit: integer (int32)
  The maximum number of items to return.
• links: array links
• offset: integer (int32)
  The actual index from which the items are returned.
• totalResults: integer (int32)
  The total number of items.

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "description":"The items being returned.",
            "items":{
                "$ref":"#/components/schemas/InsightsExport"
            }
        },
        "count":{
            "type":"integer",
            "description":"The number of items returned.",
            "format":"int32",
            "nullable":true
        },
        "totalResults":{
            "type":"integer",
            "description":"The total number of items.",
            "format":"int32",
            "nullable":true
        },
        "offset":{
            "type":"integer",
            "description":"The actual index from which the items are returned.",
            "format":"int32",
            "nullable":true
        },
        "limit":{
            "type":"integer",
            "description":"The maximum number of items to return.",
            "format":"int32",
            "nullable":true
        },
        "hasMore":{
            "type":"boolean",
            "description":"Indicates if there are more items to be returned."
        },
        "links":{
            "type":"array",
            "properties":{
                "selfLinks":{
                    "type":"object",
                    "properties":{
                        "absolutePathBuilder":{
                            "type":"object"
                        },
                        "baseUri":{
                            "type":"string",
                            "format":"uri"
                        },
                        "requestUri":{
                            "type":"string",
                            "format":"uri"
                        },
                        "requestUriBuilder":{
                            "type":"object"
                        },
                        "baseUriBuilder":{
                            "type":"object"
                        },
                        "pathParameters":{
                            "type":"object",
                            "additionalProperties":{
                                "type":"array",
                                "items":{
                                    "type":"string"
                                }
                            }
                        },
                        "queryParameters":{
                            "type":"object",
                            "additionalProperties":{
                                "type":"array",
                                "items":{
                                    "type":"string"
                                }
                            }
                        },
                        "matchedURIs":{
                            "type":"array",
                            "items":{
                                "type":"string"
                            }
                        },
                        "matchedResources":{
                            "type":"array",
                            "items":{
                                "type":"object"
                            }
                        },
                        "pathSegments":{
                            "type":"array",
                            "items":{
                                "type":"object",
                                "properties":{
                                    "matrixParameters":{
                                        "type":"object",
                                        "additionalProperties":{
                                            "type":"array",
                                            "items":{
                                                "type":"string"
                                            }
                                        }
                                    },
                                    "path":{
                                        "type":"string"
                                    }
                                }
                            }
                        },
                        "absolutePath":{
                            "type":"string",
                            "format":"uri"
                        },
                        "path":{
                            "type":"string"
                        }
                    },
                    "writeOnly":true
                },
                "empty":{
                    "type":"boolean"
                }
            },
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "description":"List of a skill's insights-export tasks."
}

Nested Schema : items

Type: array

The items being returned.

Show Source

• Array of: object InsightsExport
  The items being returned.

{
    "type":"array",
    "description":"The items being returned.",
    "items":{
        "$ref":"#/components/schemas/InsightsExport"
    }
}

Nested Schema : links

Type: array

Show Source

• empty: boolean
• selfLinks: object selfLinks

{
    "type":"array",
    "properties":{
        "selfLinks":{
            "type":"object",
            "properties":{
                "absolutePathBuilder":{
                    "type":"object"
                },
                "baseUri":{
                    "type":"string",
                    "format":"uri"
                },
                "requestUri":{
                    "type":"string",
                    "format":"uri"
                },
                "requestUriBuilder":{
                    "type":"object"
                },
                "baseUriBuilder":{
                    "type":"object"
                },
                "pathParameters":{
                    "type":"object",
                    "additionalProperties":{
                        "type":"array",
                        "items":{
                            "type":"string"
                        }
                    }
                },
                "queryParameters":{
                    "type":"object",
                    "additionalProperties":{
                        "type":"array",
                        "items":{
                            "type":"string"
                        }
                    }
                },
                "matchedURIs":{
                    "type":"array",
                    "items":{
                        "type":"string"
                    }
                },
                "matchedResources":{
                    "type":"array",
                    "items":{
                        "type":"object"
                    }
                },
                "pathSegments":{
                    "type":"array",
                    "items":{
                        "type":"object",
                        "properties":{
                            "matrixParameters":{
                                "type":"object",
                                "additionalProperties":{
                                    "type":"array",
                                    "items":{
                                        "type":"string"
                                    }
                                }
                            },
                            "path":{
                                "type":"string"
                            }
                        }
                    }
                },
                "absolutePath":{
                    "type":"string",
                    "format":"uri"
                },
                "path":{
                    "type":"string"
                }
            },
            "writeOnly":true
        },
        "empty":{
            "type":"boolean"
        }
    },
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Show Source

• Array of: object Link

{
    "type":"array",
    "properties":{
        "selfLinks":{
            "type":"object",
            "properties":{
                "absolutePathBuilder":{
                    "type":"object"
                },
                "baseUri":{
                    "type":"string",
                    "format":"uri"
                },
                "requestUri":{
                    "type":"string",
                    "format":"uri"
                },
                "requestUriBuilder":{
                    "type":"object"
                },
                "baseUriBuilder":{
                    "type":"object"
                },
                "pathParameters":{
                    "type":"object",
                    "additionalProperties":{
                        "type":"array",
                        "items":{
                            "type":"string"
                        }
                    }
                },
                "queryParameters":{
                    "type":"object",
                    "additionalProperties":{
                        "type":"array",
                        "items":{
                            "type":"string"
                        }
                    }
                },
                "matchedURIs":{
                    "type":"array",
                    "items":{
                        "type":"string"
                    }
                },
                "matchedResources":{
                    "type":"array",
                    "items":{
                        "type":"object"
                    }
                },
                "pathSegments":{
                    "type":"array",
                    "items":{
                        "type":"object",
                        "properties":{
                            "matrixParameters":{
                                "type":"object",
                                "additionalProperties":{
                                    "type":"array",
                                    "items":{
                                        "type":"string"
                                    }
                                }
                            },
                            "path":{
                                "type":"string"
                            }
                        }
                    }
                },
                "absolutePath":{
                    "type":"string",
                    "format":"uri"
                },
                "path":{
                    "type":"string"
                }
            },
            "writeOnly":true
        },
        "empty":{
            "type":"boolean"
        }
    },
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : InsightsExport

Type: object

The items being returned.

Show Source

• beginDate(required): string (date)
  Pattern: YYYY-MM-DD

  Range start date.
• createdByName: string
  A name that identifies who created the export task.
• endDate(required): string (date)
  Pattern: YYYY-MM-DD

  Range end date.
• filters: object filters
  Include only the data for the specified intent, channel, or locale or any combination of the three filters.

{
    "required":[
        "beginDate",
        "endDate"
    ],
    "type":"object",
    "properties":{
        "beginDate":{
            "pattern":"YYYY-MM-DD",
            "type":"string",
            "description":"Range start date.",
            "format":"date"
        },
        "endDate":{
            "pattern":"YYYY-MM-DD",
            "type":"string",
            "description":"Range end date.",
            "format":"date"
        },
        "filters":{
            "type":"object",
            "description":"Include only the data for the specified intent, channel, or locale or any combination of the three filters.",
            "example":{
                "filter":{
                    "meta":"",
                    "enclose1":{
                        "meta":"",
                        "enclose2":{
                            "meta":"",
                            "profileString":{
                                "column":"INTENT",
                                "test":{
                                    "op":"matches one of",
                                    "arg":"Balances;Accounts"
                                }
                            }
                        }
                    },
                    "bool3":{
                        "content":"and"
                    },
                    "enclose4":{
                        "meta":"",
                        "enclose5":{
                            "meta":"",
                            "profileString":{
                                "column":"CHANNEL",
                                "test":{
                                    "op":"matches one of",
                                    "arg":"test; facebook"
                                }
                            }
                        }
                    },
                    "bool6":{
                        "content":"and"
                    },
                    "enclose7":{
                        "meta":"",
                        "enclose8":{
                            "meta":"",
                            "profileString":{
                                "column":"BR_LANG",
                                "test":{
                                    "op":"matches one of",
                                    "arg":"en-US; en-UK"
                                }
                            }
                        }
                    }
                }
            }
        },
        "createdByName":{
            "type":"string",
            "description":"A name that identifies who created the export task."
        }
    },
    "description":"The items being returned."
}

Nested Schema : filters

Type: object

Include only the data for the specified intent, channel, or locale or any combination of the three filters.

Example:

{
    "filter":{
        "meta":"",
        "enclose1":{
            "meta":"",
            "enclose2":{
                "meta":"",
                "profileString":{
                    "column":"INTENT",
                    "test":{
                        "op":"matches one of",
                        "arg":"Balances;Accounts"
                    }
                }
            }
        },
        "bool3":{
            "content":"and"
        },
        "enclose4":{
            "meta":"",
            "enclose5":{
                "meta":"",
                "profileString":{
                    "column":"CHANNEL",
                    "test":{
                        "op":"matches one of",
                        "arg":"test; facebook"
                    }
                }
            }
        },
        "bool6":{
            "content":"and"
        },
        "enclose7":{
            "meta":"",
            "enclose8":{
                "meta":"",
                "profileString":{
                    "column":"BR_LANG",
                    "test":{
                        "op":"matches one of",
                        "arg":"en-US; en-UK"
                    }
                }
            }
        }
    }
}

Nested Schema : selfLinks

Type: object

Show Source

• absolutePath: string (uri)
• absolutePathBuilder: object absolutePathBuilder
• baseUri: string (uri)
• baseUriBuilder: object baseUriBuilder
• matchedResources: array matchedResources
• matchedURIs: array matchedURIs
• path: string
• pathParameters: object pathParameters
  Additional Properties Allowed: additionalProperties
• pathSegments: array pathSegments
• queryParameters: object queryParameters
  Additional Properties Allowed: additionalProperties
• requestUri: string (uri)
• requestUriBuilder: object requestUriBuilder

{
    "type":"object",
    "properties":{
        "absolutePathBuilder":{
            "type":"object"
        },
        "baseUri":{
            "type":"string",
            "format":"uri"
        },
        "requestUri":{
            "type":"string",
            "format":"uri"
        },
        "requestUriBuilder":{
            "type":"object"
        },
        "baseUriBuilder":{
            "type":"object"
        },
        "pathParameters":{
            "type":"object",
            "additionalProperties":{
                "type":"array",
                "items":{
                    "type":"string"
                }
            }
        },
        "queryParameters":{
            "type":"object",
            "additionalProperties":{
                "type":"array",
                "items":{
                    "type":"string"
                }
            }
        },
        "matchedURIs":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "matchedResources":{
            "type":"array",
            "items":{
                "type":"object"
            }
        },
        "pathSegments":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "matrixParameters":{
                        "type":"object",
                        "additionalProperties":{
                            "type":"array",
                            "items":{
                                "type":"string"
                            }
                        }
                    },
                    "path":{
                        "type":"string"
                    }
                }
            }
        },
        "absolutePath":{
            "type":"string",
            "format":"uri"
        },
        "path":{
            "type":"string"
        }
    },
    "writeOnly":true
}

Nested Schema : Link

Type: object

Show Source

• href: string
  URL to the resource
• rel: string
  The relationship with the resource

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "description":"The relationship with the resource"
        },
        "href":{
            "type":"string",
            "description":"URL to the resource"
        }
    }
}

Nested Schema : absolutePathBuilder

Type: object

Nested Schema : baseUriBuilder

Type: object

Nested Schema : matchedResources

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    }
}

Nested Schema : matchedURIs

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : pathParameters

Type: object

Additional Properties Allowed

Show Source

• array additionalProperties

{
    "type":"object",
    "additionalProperties":{
        "type":"array",
        "items":{
            "type":"string"
        }
    }
}

Nested Schema : pathSegments

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "matrixParameters":{
                "type":"object",
                "additionalProperties":{
                    "type":"array",
                    "items":{
                        "type":"string"
                    }
                }
            },
            "path":{
                "type":"string"
            }
        }
    }
}

Nested Schema : queryParameters

Type: object

Additional Properties Allowed

Show Source

• array additionalProperties

{
    "type":"object",
    "additionalProperties":{
        "type":"array",
        "items":{
            "type":"string"
        }
    }
}

Nested Schema : requestUriBuilder

Type: object

Nested Schema : items

Type: object

Nested Schema : additionalProperties

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : items

Type: object

Show Source

• matrixParameters: object matrixParameters
  Additional Properties Allowed: additionalProperties
• path: string

{
    "type":"object",
    "properties":{
        "matrixParameters":{
            "type":"object",
            "additionalProperties":{
                "type":"array",
                "items":{
                    "type":"string"
                }
            }
        },
        "path":{
            "type":"string"
        }
    }
}

Nested Schema : matrixParameters

Type: object

Additional Properties Allowed

Show Source

• array additionalProperties

{
    "type":"object",
    "additionalProperties":{
        "type":"array",
        "items":{
            "type":"string"
        }
    }
}

Nested Schema : additionalProperties

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : additionalProperties

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

404 Response

The skill doesn't exist or insights aren't enabled for the skill.

Back to Top