---
category: [Platform and Product Extensions/Workday Extend, Platform and Product Extensions, Administration & Integrations, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Integration]
keyword: [Extend, monitor, troubleshoot, Orchestration Builder, Orchestrate, Orchestration]
nav: wcp_docs
parent_url: /wcp_docs/
title: Modify Verbose Logging for Orchestrations
layout: subsection
---

### Prerequisites

<a id="prereq_N1002B_N10028_N10001"></a>
-   Have a Developer, Collaborator, or Developer Support role.
-   Create an app containing an orchestration.
-   Enable verbose logging.


### Context

<a id="context_yqg_btm_cxb"></a>
Verbose logging can help you perform troubleshooting during development by providing additional information about code execution. Workday provides verbose logging for orchestrations through a user-friendly REST API. Once enabled, you can modify verbose logging at any time.

### Steps

1.  <a id="step_N1003A_N10037_N10028_N10001"></a>To enable verbose logging, send a `PUT` request to the appropriate endpoint for your location:

    -   US: `https://api.us.wcp.workday.com/orchestrate/v1/apps/{appId}/orchestrations/{orchName}/debug/logging HTTP/1.1`
    -   EMEA: `https://api.eu.wcp.workday.com/orchestrate/v1/apps/{appId}/orchestrations/{orchName}/debug/logging HTTP/1.1`

    Replace the placeholders in the URL with these values:

    -   `{appID}`: the ID of the app containing the orchestration.
    -   `{orchName}`: the orchestration's name.

2.  <a id="step_N10075_N1004A_N10028_N10001"></a>Include this header in the `PUT` request: `Authorization: Bearer {token}`.

    Replace `{token}` with your JSON Web Token (JWT).

    <b>Note:</b> To find the JWT, log in to the Workday Developer site and open your browser's Developer Console. Example: in Google Chrome, right-click in the browser window and click <b>Inspect</b>. Find a cookie named `wday-access-token` and copy the associated value. Example: in Google Chrome, cookies are in the <b>Storage</b> section under the <b>Application</b> heading. A JWT is valid for 1 hour. If your token expires, refresh the Developer site window to generate a new one.

3.  <a id="step_N10092_N1004A_N10028_N10001"></a>In the `PUT` request's body, include a JSON object with these fields:

    -   `tenantAlias`: the orchestration's tenant alias.
    -   `oneTimeOnly`: A boolean value specifying whether the logging should run just once.
    -   `duration`: The duration of the logging session. The default value is `30m`. The minimum allowed value is `0s` and the maximum is `14d`.
    -   `stepFilter`: The steps you want to include in verbose logging. If you don't apply a filter, all steps are included.

4.  <a id="step_N100D8_N1004A_N10028_N10001"></a>If the request is succesful, the API returns a JSON object containing these fields:

    -   `tenantAlias`: the orchestration's tenant alias.
    -   `appID`: The ID of the app containing the orchestration.
    -   `orchName`: The orchestration's name.
    -   `stepFilter`: The steps included in verbose logging.
    -   `oneTimeOnly`: A boolean value specifying whether the logging should run just once.
    -   `disposed`: A boolean value that's set to `true` if `oneTimeOnly` logging was enabled and has now been used.
    -   `expiry`: The date and time when verbose logging will expire.



### Example

Sample request to modify verbose logging:

```
PUT
https://api.us.wcp.workday.com/orchestrate/v1/apps/sampleapplication_ycjtxv/orchestrations/sample123/debug/logging HTTP/1.1
Authorization: Bearer MiIsImtpZCI6IjIwkceirijlcdrnlfgdgkCI6IjCI6Ij Content-Type: application/json

{
"tenantAlias": "superi-0d99072fedc1f3704",
"oneTimeOnly": false,
"duration": "24h",
"stepFilter": "myNewFilter"
}
```