const __redoc_state = JSON.parse("{\"menu\":{\"activeItemIdx\":-1},\"definition\":{\"data\":{\"openapi\":\"3.0.0\",\"info\":{\"version\":\"1.0.0\",\"title\":\"Kantata OX API Documentation\",\"description\":\"Kantata OX's API provides access to the majority of Kantata OX's data model. The API authenticates requests using OAuth2 tokens and exists primarily to allow scripts and 3rd-party applications to access and manage Kantata OX data on behalf of Kantata OX users.\\n\\n## Schema\\n\\nRequests must be sent via HTTPS and can be in either JSON or [Rails structured x-www-form-urlencoded](http://stackoverflow.com/a/950198) format. Responses will always be returned in JSON format.  Dates and times are returned as [ISO 8601](http://www.w3.org/TR/NOTE-datetime) formatted strings. All requests to the API must have URLs relative to the base API URL:\\n\\n    https://api.mavenlink.com/api/v1/\\n\\n## Authentication\\n\\nAll requests to the Kantata OX API must be authenticated with an OAuth bearer token. See the application workflow for details on how to register an application with Kantata OX and obtain OAuth bearer tokens.\\n\\nTo authenticate using the `Authorization` header, set the header's value to `Bearer <token>`. So, if your token was `abc123`, your HTTP request would include the header `Authorization: Bearer abc123`.\\n\\nFor example, authenticating a request using `curl` would mean running a command similar to this one:\\n\\n    curl -H \\\"Authorization: Bearer abc123\\\" \\\"https://api.mavenlink.com/api/v1/workspaces.json\\\"\\n\\nAll requests to the Kantata OX API require an Authorization header. For brevity, future API request examples in this documentation will not include the example Authorization header parameter.\\n\\n### OAuth 2.0\\n\\n[OAuth 2.0](http://oauth.net/2/) provides an evolving, standardized inter-application authentication workflow for the Web.  To build an application that interacts with Kantata OX on behalf of your users, you will need to register your application, and then obtain an OAuth token for each of your users.\\n\\n#### Registering your application\\n\\nRegister and manage OAuth2 applications that can connect to Kantata OX at the [application management](https://app.mavenlink.com/oauth/applications) page as a Kantata OX account administrator. You'll need a paid Kantata OX account in order to register applications with us. Applications have a name and a callback URL for OAuth2.\\n\\nIf you only want to use the Kantata OX API for yourself, or as a backend connector, you must still register an Application, but then you can get an OAuth token for yourself on the Application's page. If you want your application to be able to use the Kantata OX API on behalf of other users, read the next section.\\n\\n#### Obtaining tokens for users\\n\\nEvery request to the Kantata OX API must be accompanied by a valid OAuth token, indicating that your application has been authorized by the Kantata OX user in question. When you register an application with us, we'll provide you with a secret key. That key is unique to your application, and shouldn't be shared with anyone else. Treat it like a password.  You'll need it to request user tokens.\\n\\nTo authorize your application for Kantata OX API access and obtain a user token, follow the below steps for each Kantata OX user:\\n\\nNote: If you are using an OAuth2 library, many of these steps will be handled for you.\\n\\n  1. Request a short-term code, granted when the Kantata OX user agrees to allow your application access.\\n\\n      Send your user to `/oauth/authorize` with the REQUIRED parameters `client_id`, `response_type`, and `redirect_uri`.\\n\\n        * `client_id` is the ID assigned to your application by Kantata OX\\n        * `response_type` must be set to \\\"code\\\"\\n        * `redirect_uri` must be set to a URL where your application can accept codes and then exchange them for access tokens.  It should match the `redirect_uri` specified when you registered your application.\\n\\n      Here is an example URL that an application located at \\\"myapp.com\\\" might use. (Linebreaks are not included in the URL.)\\n\\n         https://app.mavenlink.com/oauth/authorize?response_type=code&client_id=abc123&redirect_uri=http%3A%2F%2Fmyapp.com%2Foauth%2Fcallback\\n\\n  2. The user will be asked by Kantata OX if they want to authorize your application to interact with Kantata OX on their behalf.\\n\\n      If something goes wrong (like the user refused to authorize your application), Kantata OX will redirect to the `redirect_uri` with query parameters providing information about the error. For example, if authorization is denied, the user will be redirected to:\\n\\n         $REDIRECT_URI?error=access_denied&error_description=The+resource+owner+or+authorization+server+denied+the+request.\\n\\n      If the user allows your application, then Kantata OX will redirect to the `redirect_uri` with query parameters providing your application with a time-limited code that your application can exchange for an access token within the next 5 minutes. Here is an example redirection with granted access:\\n\\n         $REDIRECT_URI?code=abc123\\n\\n  3. Your application exchanges the code for an access token\\n\\n      Now that your application has a code, it should make a POST request directly to Kantata OX at `https://app.mavenlink.com/oauth/token` to exchange the code for an access token that will allow continued interaction with the Kantata OX API. The request must include the `client_id`, `client_secret`, `grant_type`, `code`, and `redirect_uri` parameters.\\n\\n      * `client_id` is the ID assigned to your application by Kantata OX\\n      * `client_secret` is the secret token assigned to your application by Kantata OX\\n      * `grant_type` must be set to \\\"authorization_code\\\" in order to exchange a code for an access token\\n      * `code` is the value that was returned in the `code` query parameter when Kantata OX redirected back to your `redirect_uri`\\n      * `redirect_uri` is the exact same value that you used in the original request to /oauth/authorize\\n\\n      If the request is invalid for some reason, an error response like the one described above will be returned. However, the parameters will be returned in the response body, encoded as JSON, instead of in the URL encoded as query parameters.\\n\\n      If the request is valid, Kantata OX will provide a response body, encoded in JSON, containing `access_token` and `token_type`.\\n\\n        * `access_token` is the token that your application will use to authenticate requests to the Kantata OX API as this user\\n        * `token_type` will be \\\"bearer\\\"\\n\\n  4. Your application uses the access token to make authenticated requests to the Kantata OX API\\n\\n      At this point, your application can use the access token to authenticate requests made to the Kantata OX API as described above in the [Authentication](#authentication) section.\\n\\n<!-- ReDoc-Inject: <security-definitions> -->\\n\\n### Security\\n\\nKantata OX OAuth access tokens do not expire and must be treated with the same security that you would treat client credentials such as passwords.  All requests must be made over SSL and all user security credentials must be stored using industry best practices.  If a user revokes your application's access, usage of the token will result in an error.\\n\\n## Response Format\\n\\nKantata OX API responses come back as JSON.  All GET responses will be of a format similar to the following:\\n\\n    {\\n      \\\"count\\\": 2,\\n      \\\"results\\\": [{ key: \\\"workspaces\\\", id: \\\"10\\\" }, { key: \\\"workspaces\\\", id: \\\"11\\\" }],\\n      \\\"workspaces\\\": {\\n        \\\"10\\\": {\\n        id: \\\"10\\\",\\n        title: \\\"some project\\\",\\n        participant_ids: [\\\"2\\\", \\\"6\\\"],\\n        primary_counterpart_id: \\\"6\\\"\\n      },\\n        \\\"11\\\": {\\n        id: \\\"11\\\",\\n        title: \\\"another project\\\",\\n        participant_ids: [\\\"2\\\", \\\"8\\\"],\\n        primary_counterpart_id: \\\"8\\\"\\n      }\\n      },\\n      \\\"users\\\": {\\n        \\\"2\\\": { id: \\\"2\\\", full_name: \\\"bob\\\" },\\n        \\\"6\\\": { id: \\\"6\\\", full_name: \\\"chaz\\\" },\\n        \\\"8\\\": { id: \\\"8\\\", full_name: \\\"jane\\\" }\\n      }\\n    }\\n\\nAs you can see, Kantata OX API responses can return multiple data types simultaneously, transferring objects and their associations in a single response.  In this example, the developer has likely requested the `/workspaces.json` endpoint, asking for inclusion of those workspaces' participants and primary counterparts.  These associations have come back in the top-level object called `users`.  The developer should always use the returned `results` array to retrieve the canonical results from an API request.  This is because some objects may have associations of the same type and can thus be mixed together with their associations in the JSON.  For example, stories (tasks) have sub_stories which are the same type of object, so looking directly at the returned `stories` key when stories have been requested to include their sub_stories will be confusing and will include both.  Instead, iterate the `results` key to determine exactly which top-level objects matched your query and in what order.\\n\\nThe follow sections explain how to customize further the Kantata OX API responses to your needs.\\n\\n## Pagination\\n\\nLarge lists of items may be returned in pages. The JSON response will contain a key named `count` with a value of the number of objects returned by the entire query. If that number is greater than the number of objects returned by the request, additional objects may be requested by setting the parameter `page`, the parameter `per_page`, or both.\\n\\nIf you would like to start at a specific offset you may alternatively use `limit` and `offset` parameters.  If both `limit` and `offset` are passed then `page` and `per_page` are ignored, otherwise behavior falls back to `page` and `per_page`.\\n\\n* `page`\\n  * type: Integer\\n  * default: 1\\n* `per_page`\\n  * type: Integer\\n  * default: 20\\n  * maximum: 200\\n* `usage`\\n  * workspaces.json?page=2&per_page=15\\n\\n-or-\\n\\n* `limit`\\n  * type: Integer\\n  * minimum: 1\\n* `offset`\\n  * type: Integer\\n  * minimum: 0\\n* `usage`\\n  * workspaces.json?limit=15&offset=10\\n\\n## Request by ID\\n\\nWhile each API endpoint returns a paginated listing of the data available, it is sometimes more useful to request only one (or only a few) items. The Kantata OX API provides two ways to do this.  The first, via the `only` parameter, allows you to request one or more resources directly by ID. To request the data for a single Workspace with an ID of 5, make an API request to the URL `GET /api/v1/workspaces.json?only=5`. Multiple IDs can be supplied in a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`. The returned JSON will contain only the objects with those IDs.\\n\\n* `only`\\n  * type: Comma separated Integers\\n  * default: not applicable\\n* `usage`\\n  * workspaces.json?only=5,6\\n\\nAdditionally, we support traditional RESTful routes, such as `GET /api/v1/workspaces/5.json`.  These routes also support our standard filters and includes, both detailed below.  Unlike `only` requests to our \\\"index\\\" routes, these \\\"show\\\" routes will generate a 404 response if the requested resource cannot be found.  Sometimes this is due to default filters being applied, so be sure to check the filter defaults applied in the specific documentation for the requested resource.  More on filters below.\\n\\n## Filters\\n\\nMany API endpoints also provide an optional set of filters that can be applied to the data that will be returned. Each filter, and the logic behind it, is documented on the individual endpoint pages, but the general form is a URL query parameter or request parameter like `filter1=arg1&filter2=arg2`, where `filter1` and `filter2` are the names of two different filters, and `arg1` and `arg2` are the arguments to each filter, respectively.  Additionally, some filters have default values, which indicates that they are automatically applied to your request with their default value.  Default values are applied both on \\\"index\\\" (`GET /workspaces.json`) requests and \\\"show\\\" (`GET /workspaces/1.json`) requests.\\n\\n## Includes\\n\\nSome objects returned by the API may have associations that are not included in the JSON response by default. Those associated objects can be requested by adding an `include` parameter to the request. For example, to request both a list of posts, and the users that created those posts, you could request `/posts.json?include=user`. The response will consist of a JSON object with an array of result mappings under the `\\\"results\\\"` key, a `\\\"posts\\\"` key with a hash of post objects, keyed by id, and a `\\\"users\\\"` key with a hash of user objects, again keyed by id. To find the user that created a particular post, just use the post object's `\\\"user_id\\\"` key to find the user object keyed with the same id.\\n\\nMultiple associations may be fetched simultaneously by adding comma-separated values to the `include` parameter. For example, to fetch the user and replies associated with post 6, you might request `/posts.json?only=6&include=user,attachments`, which would supply both the users and the attachments that belong to the posts returned in the response.\\n\\n_Example_\\n\\n    curl -H \\\"Authorization: Bearer abc123\\\" \\\"https://api.mavenlink.com/api/v1/posts.json?include=user,attachments\\\"\\n\\n    {\\n      \\\"count\\\": 1,\\n\\n      \\\"results\\\": [\\n        { \\\"key\\\": \\\"posts\\\", \\\"id\\\": \\\"16270634\\\" }\\n      ],\\n\\n      \\\"posts\\\": {\\n        \\\"16270634\\\": {\\n          \\\"id\\\": \\\"16270634\\\",\\n          \\\"message\\\": \\\"Hello World\\\",\\n          \\\"has_attachments\\\": true,\\n          \\\"user_id\\\": \\\"2\\\",\\n          \\\"workspace_id\\\": \\\"2249167\\\",\\n          \\\"attachment_ids\\\": [\\\"6700107\\\"]\\n        }\\n      },\\n\\n      \\\"users\\\": {\\n        \\\"2\\\": {\\n          \\\"id\\\": \\\"2\\\",\\n          \\\"full_name\\\": \\\"John Doe\\\",\\n          \\\"email_address\\\": \\\"johnny_doe@example.com\\\"\\n        }\\n      },\\n\\n      \\\"attachments\\\": {\\n        \\\"6700107\\\": {\\n          \\\"id\\\": \\\"6700107\\\",\\n          \\\"created_at\\\": \\\"2013-04-15T16:48:48-07:00\\\",\\n          \\\"filename\\\": \\\"turtle.jpg\\\",\\n          \\\"filesize\\\": 16225\\n        }\\n      }\\n    }\\n\\n## Optional Fields\\n\\nSome objects returned by the API may have fields that are not included in the JSON response by default. Those optional fields can be requested by adding an `optional_field` parameter to the request. For example, to request a list of stories and include the optional field `can_edit`, you could request `/stories.json?optional_fields=can_edit`. Each story in the response will include the requested optional field in their JSON.\\n\\nMultiple optional fields may be requested simultaneously by adding comma-separated values to the `optional_fields` parameter. For example, to fetch stories and include both `can_edit` and `can_post` fields in the response, you can request `/stories.json?optional_fields=can_edit,can_post`.\\n\\n_Example_\\n\\n    curl -H \\\"Authorization: Bearer abc123\\\" \\\"https://api.mavenlink.com/api/v1/stories.json?optional_fields=can_edit,can_post\\\"\\n\\n    {\\n      \\\"count\\\": 1,\\n      \\\"results\\\": [\\n        {\\n          \\\"key\\\": \\\"stories\\\",\\n          \\\"id\\\": \\\"1941361\\\"\\n        }\\n      ],\\n      \\\"stories\\\": {\\n        \\\"1937928\\\": {\\n          \\\"title\\\": \\\"Example Story\\\",\\n          \\\"description\\\": \\\"example description\\\",\\n          ...\\n          \\\"subtree_depth\\\": 0,\\n          \\\"ancestry_depth\\\": 0,\\n          \\\"can_edit\\\": true,\\n          \\\"can_post\\\": true,\\n          \\\"time_trackable\\\": true,\\n          \\\"time_estimate_in_minutes\\\": null,\\n          ...\\n          \\\"parent_id\\\": null,\\n          \\\"root_id\\\": null,\\n          \\\"id\\\": \\\"1937928\\\"\\n        }\\n      },\\n      \\\"meta\\\": {\\n        \\\"count\\\": 1,\\n        \\\"page_count\\\": 1,\\n        \\\"page_number\\\": 1,\\n        \\\"page_size\\\": 20\\n      }\\n    }\\n\\n## Ordering\\n\\nEach endpoint in the Kantata OX API allows ordering by various fields.  If we're missing a sort field that you need, please ask!  See the specific endpoint documentation for endpoint-specific details.\\n\\nWhen ordering, supply `order` with the name of a valid sort field for the endpoint and a direction.  For example, `order=created_at:desc`.\\n\\n## Searching\\n\\nSome API endpoints support text search, however only some filters can be combined with search, and results will be returned ordered by relevancy to the search query.  Search does not apply to `only` requests.  If search is unavailable the response will contain a system error describing the problem.\\n\\nTo make a search request, simply add a `search` parameter to the request.  For example, to search for stories with \\\"estimates\\\" in the title, assignee names, or other fields, request `/stories.json?search=estimates`\\n\\n## Errors\\n\\nIf there is an error while processing your request, the response will include an HTTP status code indicating the error.  Errors are currently returned as a top-level `errors` key with an array of error objects.  For example, on OAuth failure you will receive a HTTP 401 with the following JSON body:\\n\\n    {\\n      errors: [\\n        {\\n          type: \\\"oauth\\\"\\n          message: \\\"Invalid OAuth 2 Request\\\"\\n        }\\n      ]\\n    }\\n\\nSystem errors will look like:\\n\\n    {\\n      errors: [\\n        {\\n          type: \\\"system\\\"\\n          message: \\\"Your account has been canceled\\\"\\n        }\\n      ]\\n    }\\n\\nAnd model validation errors look like:\\n\\n    {\\n      errors: [\\n        {\\n          type: \\\"validation\\\",\\n          message: \\\"Please give your project a title\\\",\\n          field: \\\"title\\\"\\n        },\\n        {\\n          type: \\\"validation\\\",\\n          message: \\\"Please select a role for this project\\\",\\n          field: \\\"creator_role\\\"\\n        }\\n      ]\\n    }\\n\\n\\n## Rate Limits\\n\\nWhen too many requests are made in a short amount of time, the API may reply with the HTTP code 429 Too Many Requests. In that case, simply retry your request after a small delay.\\n\\nThere are general rate limits applied to all requests. The following endpoints also have their own rate limits:\\n\\n* [Create a workspace](/tag/Workspaces#operation/create-workspace) - `POST /api/v1/workspaces`\\n* [Get workspaces](/tag/Workspaces#operation/get-workspaces) - `GET /api/v1/workspaces`\\n* [Create a workspace invitation](/tag/Workspaces#operation/create-workspace-invitation) - `POST /api/v1/workspaces/{id}/invite`\\n* [Create an account invitation](/tag/Account-Invitations#operation/create-account-invitation) (i.e. Create a new user) - `POST /api/v1/account_invitations`\\n* [Resend an account invitation](/tag/Account-Invitations#operation/resend-account-invitation) - `PUT /api/v1/account_invitations/{id}/resend`\\n* [Create custom field value](/tag/Custom-Field-Values#operation/create-custom-field-value) - `POST /api/v1/custom_field_values`\\n* [Get custom field values](/tag/Custom-Field-Values#operation/get-custom-field-values) - `GET /api/v1/custom_field_values`\\n* [Create a project snapshot](/tag/Project-Snapshots#operation/create-project-snapshot) - `POST /api/v1/project_snapshots`\\n\\nPlease see the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for the exact rate limits.\\n\\nPlease note that we reserve the right to change the limits at any time. In addition, if we determine that someone is using the API improperly, we may adjust the limits further.\\n\",\"termsOfService\":\"https://www.kantata.com/terms-of-use\",\"contact\":{\"name\":\"Kantata OX Support\",\"url\":\"https://mavenlink.zendesk.com/hc/en-us\"},\"license\":{\"name\":\"COPYRIGHT © 2024 Kantata, Inc.\",\"url\":\"https://www.kantata.com/terms-of-use\"},\"x-logo\":{\"url\":\"https://theme.zdassets.com/theme_assets/56104/04e93064d309f75d054b8cee885d1ea51e9be8f7.png\",\"backgroundColor\":\"#FFFFFF\",\"altText\":\"Kantata OX API Documentation\",\"href\":\"https://developer.kantata.com\"}},\"tags\":[{\"name\":\"Access Group Memberships\",\"description\":\"Access Groups allow you to manage product access for users. An Access Group Membership represents the connection of a user to an Access Group.\"},{\"name\":\"Account Colors\",\"description\":\"Account Colors are the colors available on a user's account that can be used to style workspaces.\"},{\"name\":\"Account Invitations\",\"description\":\"Account Invitations represent invitations for non-users to join a Kantata OX account.\"},{\"name\":\"Account Locations\",\"description\":\"Represents a location associated with an account.\"},{\"name\":\"Account Memberships\",\"description\":\"Each user on an account will have an account membership that describes their relationship to the account. When you add a user\\nto an account, create a new `account_membership`. When you remove a user from an account, delete their account_membership record.\"},{\"name\":\"Activations\",\"description\":\"The Rate Card activation endpoints allow you to check whether the Rate Cards feature has been activated on\\nthe user's account. It also allows you to activate the feature on the user's account.\"},{\"name\":\"Assignments\",\"description\":\"The Assignments object allows you to view and manage task assignments for\\nnamed or [unnamed resources](https://mavenlink.zendesk.com/hc/en-us/articles/115004696493#Unnamed).\\n\\n**Note:** Because\\n[Daily Scheduled Hours](/tag/Daily-Scheduled-Hours-(Story-Allocation-Days))\\nare a part of Assignments, they can be affected when an assignment changes.\"},{\"name\":\"Attachments\",\"description\":\"An Attachment is a file asset that is attached to another Kantata OX object.  Depending on the type of object,\\nthe file is used or displayed in different ways.  The objects that Attachments can be attached to are:\\nPost, Expense, and Proof.\\n\\nTo create an Expense or Post with an Attachment, use the resulting attachment_id from the Attachment creation\\nrequest in the parameters of the Expense or Post creation request.\"},{\"name\":\"Backup Approver Associations\",\"description\":\"A Backup Approver Association represents the relationship of a delegated approver to a range of specific dates.\\nApproval responsibilities are delegated to a backup approver.\"},{\"name\":\"Billable Utilizations\",\"description\":\"Represents the billable utilization target for an account member. Each record has an effective date; the active billable utilization is the one with the most recent effective date. These endpoints are only accessible to users who are Administrators on the account.\"},{\"name\":\"Client Invoice Defaults\",\"description\":\"Represents the default configuration for presenting invoices to clients.\"},{\"name\":\"Cost Rates\",\"description\":\"Cost Rate represents the hourly cost for an account member, specified in a specific currency. A cost rate\\nwith the same currency as the account default currency is called the `default cost rate`.\"},{\"name\":\"Currencies\",\"description\":\"This object allows you to view the\\n[names, ISO codes, and symbols of currencies supported by Kantata OX](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473).\"},{\"name\":\"Custom Branding\"},{\"name\":\"Custom Field Choices\",\"description\":\"Custom Field Choices are possible values for `'single'` and `'multi'` type custom fields.\"},{\"name\":\"Custom Field Sets\",\"description\":\"Custom Field Sets contain custom fields and definitions of each fields' subject type. The supported\\nsubjects are currently *Workspace*, *Story*, *User*, and *WorkspaceGroup*.\"},{\"name\":\"Custom Field Values\",\"description\":\"If [Custom Fields](/tag/Custom-Fields) represent the fields themselves,\\nCustom Field Values represent the values in/of those fields. The Custom Field Values object allows\\nyou to view, create, update, and delete these values.\"},{\"name\":\"Custom Fields\",\"description\":\"The [Custom Fields](https://mavenlink.zendesk.com/hc/en-us/articles/202924760-Custom-Fields-Overview-#arrange) object allows you to\\nview, create, update, and delete extra fields for additional Estimate, Project, Group, Resource, Task, and User information.\\nIf Custom Fields represent the fields themselves, [Custom Field Values](/tag/Custom-Field-Values)\\nrepresent the values in/of those fields.\"},{\"name\":\"Daily Scheduled Hours (Story Allocation Days)\",\"description\":\"Daily Scheduled Hours (also called Story Allocation Days) is the allocation of time for a resource to\\nspend on a specific task, on a specific day.\\nDaily Scheduled Hours are part of [Assignments](/tag/Assignments),\\nso if an Assignment is deleted, so are its Daily Scheduled Hours.\"},{\"name\":\"Data Export Schema\",\"description\":\"This object allows you to export specific data sets from Kantata OX.  You can view the full schema of available data sets using this endpoint.\\n\\nTo use this endpoint, you need to be an [account administrator](https://mavenlink.zendesk.com/hc/en-us/articles/203041364).\"},{\"name\":\"Data Exports\",\"description\":\"This object allows you to export specific data sets from Kantata OX. You can create or cancel exports. You can also view the full schema of available data sets, view details for all exports, and download exports.\\n\\nTo use these endpoints, you need to be an [account administrator](https://mavenlink.zendesk.com/hc/en-us/articles/203041364).\"},{\"name\":\"Estimate Scenario Resource Allocations\",\"description\":\"Estimate Scenario Resource Allocations contain time-related data for scenario resources,\\nused for calculating estimated cost and scheduled hours.\"},{\"name\":\"Estimate Scenario Resources\",\"description\":\"Estimate Scenario Resources represent placeholders for unnamed resources in a specific estimate scenario.\"},{\"name\":\"Estimate Scenarios\",\"description\":\"An Estimate Scenario is a possible project configuration, consisting of an estimated budget,\\nrate card, resources, and other related fields for a specified estimate.\"},{\"name\":\"Estimates\",\"description\":\"An Estimate represents a potential project. Estimates allow you to plan out a project's budget, resources,\\nand allocations through associated estimate scenarios.\"},{\"name\":\"Event Types\",\"description\":\"A change is called a [Subscribed Event](https://mavenlink.zendesk.com/hc/en-us/articles/4407962435227),\\nand the type of change is called a *Subscribed Event Type*.\\n\\n*Note:* Only Account Administrators can access Subscribed Events.\"},{\"name\":\"Events\",\"description\":\"Up to 9 days of trackable changes (\\\"events\\\") for an account can be accessed via the Subscribed Events API.\\nFor a list of all the event types tracked by Subscribed Events, please see the [Knowledge Base](https://mavenlink.zendesk.com/hc/en-us/articles/4407962435227).\\nNote that only Account Administrators can access Subscribed Events.\\n\\nSome actions performed in Kantata OX can generate multiple events. For instance, approving an Expense Report will generate `expense_report:updated` and `expense:updated` events. Note that events for the same action are not guaranteed to appear in the exact order the changes were completed.\\n\\nAlso note that although we try to create events within a few minutes of an action being performed, events may take some time to appear.\\n\\nAdditionally, events may sometimes be duplicated. Your application should handle duplicate events appropriately.\"},{\"name\":\"Exchange Tables\",\"description\":\"This object allows you to view or edit foreign currency exchange rates, depending on your [Foreign Exchange Access Group Set](https://mavenlink.zendesk.com/hc/en-us/articles/360047485453)\\n          permissions. If you are not a member of an Access Group with Foreign Exchange (FX) permissions, an account administrator will need to add you to one.\\n          If you are an account admin that needs FX permissions, you can add yourself to an Access Group with the FX permissions you require.\"},{\"name\":\"Expense Budgets\",\"description\":\"Expense budgets allow you to plan for non-labor expenses.\"},{\"name\":\"Expense Categories\",\"description\":\"An Expense Category represents the type of expense that is being reported.\\nExpense categories have no attributes and consist of just their name\\nas a string. They can be changed by Account Administrators.\"},{\"name\":\"Expense Report Submissions\",\"description\":\"Expense report submissions contain a set of expense line items. These expenses must be approved through\\nan expense report submission before they can be added to an invoice. All submission expenses must be in the\\nsame workspace (project).\"},{\"name\":\"Expenses\",\"description\":\"Expenses are defined as costs incurred as part of a project, but not related to time. Once created, expenses can\\nbe included in generated invoices.\"},{\"name\":\"External Payments\",\"description\":\"An external payment is a manual record of a payment made outside of Kantata OX.  An external payment can\\nbe applied to an invoice, or just recorded directly to a project.\"},{\"name\":\"External References\",\"description\":\"External References allows users see which objects (one of `Assignment`, `CustomField`, `CustomFieldChoice`, `CustomFieldSet`, `CustomFieldValue`, `Estimate`, `EstimateScenario`, `EstimateScenarioResource`, `Expense`, `Invoice`, `Participation`, `Post`, `RateCard`, `Role`, `Skill`, `StatusReport`, `Story`, `StoryAllocationDay`, `Submission`, `SurveyAnswer`, `SurveyQuestion`, `SurveyResponse`, `SurveyTemplate`, `TimeEntry`, `TimeOffEntry`, `User`, `Vendor`, `Workspace`, `WorkspaceAllocation`, `WorkspaceGroup`, or `WorkspaceResource`\\nare synced with third party systems. This allows you to view the sync status of items in\\naddition to the integration specifics for a synced object.\\n\\nObjects that are synced with a third party system have external integration\\nattributes that include the corresponding ID of the third-party object with\\nwhich it is synced, a link that allows you to view the object in the third\\nparty system, the status of the external object in the external system,\\nthe status of the sync, and a link to exceptions.\"},{\"name\":\"Followers\",\"description\":\"Story Follows allow users to follow a task to which they are not assigned.\"},{\"name\":\"Holiday Calendar Associations\",\"description\":\"A Holiday Calendar Association represents the relationship between holiday objects and calendar objects.\\nA Holiday can be associated with several different calendars. To associate a holiday with a calendar,\\ncreate a Holiday Calendar Assocation.\"},{\"name\":\"Holiday Calendar Memberships\",\"description\":\"A list of all calendars associated to an individual user.\"},{\"name\":\"Holiday Calendars\",\"description\":\"Holiday Calendars define the days in which account members are unavailable to work due to company-wide days off.\"},{\"name\":\"Holidays\",\"description\":\"Holidays are the company-wide days off that have been added to a user's Kantata OX account.\"},{\"name\":\"Insights Access Group Memberships\",\"description\":\"[Insights Access Groups](https://mavenlink.zendesk.com/hc/en-us/articles/115002115073) allow you to manage classic Insights access for users. An Insights Access\\n  Group Membership represents the connection of a user to an Insights Access Group.\\n\\n  > **Note**: To manage access to dynamic Insights, use [Access Group Memberships](/tag/Access-Group-Memberships) instead.\"},{\"name\":\"Insights Dynamic Dashboards\",\"description\":\"Built with an easy-to-use, modern, and intuitive dashboard editor, Insights dynamic dashboards are based on\\nthe same powerful data engine as classic dashboards and help you make data-driven decisions for projects,\\nstaffing, and more. Use this API to get information about dynamic dashboards on your account.\"},{\"name\":\"Insights Report Exports\",\"description\":\"This object allows you to manage scheduled exports of classic Insights reports from Kantata OX. An export of a classic Insights report that is scheduled to recur is called a scheduled job. You can create, update, and delete scheduled jobs. You can also view details of all the exports for a scheduled job, view the details of each export individually, and download the most recently exported report.\\n\\nTo use these endpoints, you need to be an [account administrator](https://mavenlink.zendesk.com/hc/en-us/articles/203041364).\"},{\"name\":\"Insights Reports\",\"description\":\"View a list of classic Insights reports.\"},{\"name\":\"Invoices\",\"description\":\"Users can create Invoices in a Kantata OX project.  An Invoice must have at least one line item (a time entry,\\nexpense, fixed fee item, or additional item).  By default, the recipient of an invoice is the primary client\\nin the project.  Manual formatting options are available to define the format and information that should be displayed on an\\ninvoice.\\n\\nInvoices can only be created and viewed by participants with financial permission in a project.\"},{\"name\":\"Line Item Locks\",\"description\":\"Line Item Locks provide a way for you to lock time in the past so that previous time entries\\ncannot be edited or updated and new time entries cannot be created before the selected lock date.\\n\\nLine Items can be locked to any Saturday in the past on a per-account basis.\\n\\nKeep in mind that this feature does not lock the ability to invoice approved time entries,\\nnor does it lock the submission or approval of expenses.\\n\\nAlso note: Line Item Locks cannot be modified or deleted. If you would like to move the lock date forward,\\nsimply create a new lock at a later date, and your account will be locked at the new date.\\nOnce your account has been locked, the lock cannot be moved earlier, or removed.\"},{\"name\":\"Organization Memberships\",\"description\":\"An Organization Membership represents the connection of a user and project to an organization.\"},{\"name\":\"Organizations\",\"description\":\"The Organizations feature in Kantata OX is composed of two independent trees:\\nDepartment and Geography. Each has its own hierarchy structure.\\nUsers and Workspaces are associated to exact positions in these two trees \\nvia [Organization Memberships](/tag/Organization-Memberships). \\nThe corresponding API fields are `geography_id` and `department_id`.\\n\\nA user's position in these two trees determines what objects they can see\\nin Kantata OX—they can see objects associated with every department and\\ngeography going up the hierarchy from their selected department and geography.\"},{\"name\":\"Participations\",\"description\":\"A participation represents the relationship between a participant and a project, including a participant's permission level,\\nwhether they're a provider or client, and many other properties. See the 200 status code\\nresponse sample for an example of participation properties you can access.\"},{\"name\":\"Posts\",\"description\":\"A Post represents a message written by participants in a project that appears in the project. Replies are only\\nincluded if they are directly related to a post. Replies to events, such as Change Orders or Story Created\\nEvents, are not included.\"},{\"name\":\"Project Accounting Records\",\"description\":\"The [Project Accounting](https://mavenlink.zendesk.com/hc/en-us/articles/4403832107419-Project-Accounting)\\nRecords object allows you to view, create, and delete financial records\\nrelated to revenue recognition, forecasting, and earned value.\"},{\"name\":\"Project Snapshots\",\"description\":\"Project snapshots capture the state of a project at a specific point in time. Snapshots are useful for gaining a historical perspective on a project, and for comparing the current state of a project to a previous state.\\n\\nProject financials, tasks, and resources are all captured in a snapshot, as well as project and task custom field values.\\n\\nTo use these endpoints, you must have the Edit Financials permission or higher in a project.\"},{\"name\":\"Project Template Additional Tabs\",\"description\":\"Project Template Additional Tabs are additional tabs configured in a project template that are\\nadded to a project when the template is applied.\"},{\"name\":\"Project Template Assignments\",\"description\":\"Project Template Assignments(Project Template Resources) represent placeholders for task assignees\\nin project templates. These assignments are mapped to project template stories and are assigned to\\nreal users when the template is applied.\"},{\"name\":\"Project Templates\",\"description\":\"Project Templates are sets of tasks and attributes that can be applied to new or existing projects.\\nA single template can be used on any number of projects.\\nA project template's tasks are all stored in an attribute located on the project template object called raw_json.\\nIt is a JSON hash of all the stories that has been turned into a string and is stored on the object.\\n\\n\\n##### Project Template Stories (Tasks) - raw_json\\n\\nA project template's tasks are all stored in an attribute located on the project template object called raw_json.\\nIt is a JSON hash of all the stories that has been turned into a string and is stored on the object.\\n\\nStories within the JSON have the following attributes:\\n\\n  * `title` - The title of the task.\\n  * `billable` - The title of the project template.\\n  * `relative_start_date` - An integer that represents the start day of the task relative to the start of the project.\\n  * `relative_due_date` - An integer that represents the end day of the task relative to the start of the project.\\n  * `duration` - The number of days the task will take to complete.\\n  * `temp_id` - The unique reference ID for the task (used for dependencies).\\n  * `description` - The task description.\\n  * `budget_estimate_in_cents` - An integer (whole number) that represents the budget estimate, in cents, for the task.\\n  * `time_estimate_in_minutes` - An integer (whole number) that represents the time estimate, in minutes, for the task.\\n  * `sub_stories` - An nested array of sub-tasks that have the same structure as tasks.\\n\\n  * `checklist` - An array of strings, each being a checklist item on the task.\\n        For example, \\\"checklist\\\":[\\\"item one\\\", \\\"item two\\\"].\\n\\n  * `tag_list` - A string with tags that are comma separated.\\n        For example, \\\"design, engineering, this has spaces.\\\"\\n  This creates three tags: \\\"design\\\", \\\"engineering\\\", and \\\"this has spaces.\\\"\\n\\n  * `assignments` - An array of objects with key value pairs \\\"assignee_id\\\":id.\\n        For example, [{\\\"assignee_id\\\":100},{\\\"assignee_id\\\":101}]\\n  This task would have two resources assigned to it. These are the IDs of two associated project template assignments.\\n  Project template assignments are associated objects.\\n\\n  * `dependencies` - An array of objects that represent a task's dependencies.\\n  A dependency is an object that connects two tasks, and is used in Gantt charts. A dependency object lives\\n  in the dependencies array on it's source task, not it's target.\\n\\nDependencies have the following attributes:\\n\\n  * `source_id` - The temporary ID of the first task (source task) in the dependency.\\n  * `target_id` - The temporary ID of the second task (target task) in the dependency.\\n  * `type` - There are four types of dependencies, numbered zero through three.\\n      * 0 - From the beginning of the source task to the beginning of the target task.\\n      * 1 - From the beginning of the source task to the end of the target task.\\n      * 2 - From the end of the source task to beginning of the target task.\\n      * 3 - From the end of the source task to end of the target task.\\n  * `lag` - An integer that represents the number of days delay that occurs between the two tasks in the dependency.\\n\\n\\nraw_json example:\\n```\\n[\\n  {\\n    \\\"story_type\\\":\\\"task\\\",\\n    \\\"billable\\\":true,\\n    \\\"relative_start_date\\\":1,\\n    \\\"relative_due_date\\\":2,\\n    \\\"title\\\":\\\"Task One\\\",\\n    \\\"temp_id\\\":1,\\n    \\\"dependencies\\\":[{\\\"source_id\\\":1, \\\"target_id\\\":2, \\\"type\\\":2, \\\"lag\\\":0}],\\n    \\\"description\\\":\\\"this is a task\\\",\\n    \\\"assignments\\\":[{\\\"assignee_id\\\":\\\"26\\\"}],\\n    \\\"tag_list\\\":\\\"difficult,easy\\\",\\n    \\\"budget_estimate_in_cents\\\":40000,\\n    \\\"time_estimate_in_minutes\\\":1200,\\n    \\\"sub_stories\\\": [\\n      {\\n        \\\"story_type\\\":\\\"task\\\",\\n        \\\"billable\\\":true,\\n        \\\"due_date\\\":nil,\\n        \\\"start_date\\\":nil,\\n        \\\"relative_start_date\\\":1,\\n        \\\"relative_due_date\\\":3,\\n        \\\"title\\\":\\\"Sub Task One\\\",\\n        \\\"description\\\":\\\"this is a sub task\\\",\\n        \\\"assignments\\\":[{\\\"assignee_id\\\":\\\"27\\\"}],\\n        \\\"budget_estimate_in_cents\\\":20000,\\n        \\\"time_estimate_in_minutes\\\":300,\\n        \\\"temp_id\\\":3\\n      }\\n    ]\\n  },\\n  {\\n    \\\"story_type\\\":\\\"deliverable\\\",\\n    \\\"billable\\\":true,\\n    \\\"endDay\\\":4,\\n    \\\"relative_start_date\\\":1,\\n    \\\"relative_due_date\\\":4,\\n    \\\"title\\\":\\\"Deliverable One\\\",\\n    \\\"temp_id\\\":2,\\n    \\\"description\\\":\\\"this is a deliverable\\\",\\n    \\\"sub_stories\\\":[]\\n  },\\n  {\\n    \\\"story_type\\\":\\\"milestone\\\",\\n    \\\"billable\\\":true,\\n    \\\"title\\\":\\\"Milestone One\\\",\\n    \\\"description\\\":\\\"this is a milestone\\\",\\n    \\\"weight\\\":100,\\n    \\\"duration\\\":0,\\n    \\\"relative_start_date\\\":5,\\n    \\\"sub_stories\\\":[],\\n    \\\"checklist\\\":[\\\"item one\\\", \\\"item two\\\"],\\n    \\\"temp_id\\\":4\\n  }\\n]\\n```.\"},{\"name\":\"Proof Review Participations\",\"description\":\"**Important: After December 31, 2024, Proofing will no longer be available in Kantata OX and the Proofing APIs will be unavailable.**\\n\\nProof Review Participations represents a user's involvement (participation) in the review of a proof. Their status can be\\neither *Waiting*, *Approved*, or *Rejected*.\"},{\"name\":\"Proof Reviews\",\"description\":\"**Important: After December 31, 2024, Proofing will no longer be available in Kantata OX and the Proofing APIs will be unavailable.**\\n\\nProof Reviews represent the process by which a proof is reviewed and feedback is specified. A proof review can be done by several\\nusers (represented as Proof Review Participations).  A\\nreview begins with an *in_progress* status, and is moved to *approved* after it has been reviewed and accepted by all participants.\\nIf any participant rejects the review, it moves to a *rejected* status.\"},{\"name\":\"Proof Revisions\",\"description\":\"**Important: After December 31, 2024, Proofing will no longer be available in Kantata OX and the Proofing APIs will be unavailable.**\\n\\nProof Revisions represents a specific version of a proof. The latest version that most operations are taken on is the *current* version.\\nAssociating a new ProofRevision with a proof will make it the new current revision.\"},{\"name\":\"Proofs\",\"description\":\"**Important: After December 31, 2024, Proofing will no longer be available in Kantata OX and the Proofing APIs will be unavailable.**\\n\\nProofs represent an asset that has been uploaded for review. Proofs belong to a Story (Task) and can have\\nmany Proof Revisions and one current revision which represents the most recent Revision made to the Proof.\"},{\"name\":\"Rate Card Role (Rate for a Role)\",\"description\":\"Rate Card Roles belong to a Rate Card Version and represent the bill rate, in cents per hour, for a specific Role.\\nFor example, the rate for the role of Developer may be 2000 cents per hour. It is not necessary, however, to create a Rate Card Role for\\nevery role on your account if the rate is the same as the default rate on the Rate Card Version. When an\\nexplicit Rate Card Role does not exist for a role on the account, the default rate on the Rate Card Version\\nis used to calculate the total bill rate.\\n\\nRate Card Roles can only be accessed, edited, or deleted by an Administrator on the account.\"},{\"name\":\"Rate Card Set Version (Effective version by Date)\",\"description\":\"In the Rate Card system, Rate Card Set Versions represent snapshots of a Rate Card Set,\\nthat take effect on the set published date. A Rate Card Set Version owns a copy of each Rate Card Version\\nof a Rate Card in the associated Rate Card Set.\\n\\nRate Card Roles can only be accessed, edited, or published by an Administrator on the account.\\n\\nSince Rate Cards and Rate Card Versions are immutable after they are published and in use, generating a\\nRate Card Set Version is the correct process for making any changes. When a new Rate Card Set Version\\nis created or cloned, all of the Rate Card Versions from the old Rate Card Set Version are copied\\nto a new one.\"},{\"name\":\"Rate Card Sets (Group of Rate Cards)\",\"description\":\"A Rate Card Set represents a group of Rate Cards with multiple currencies that\\ncan be bundled together. A Rate Card Set belongs to an account and can have several Rate Card Set Versions, each representing the\\neffective version for a specified date.\\n\\nIf the Rate Card feature is enabled, an account will always have an account default Rate Card Set. Rate\\nCards belonging to the account default Rate Card Set are applied to projects by default when a Rate Card\\nis not explicitly set.\\n\\nAdditional custom Rate Card Sets can be created after the Rate Cards feature has been enabled on the\\naccount. This can be done by making a request to the activations\\nendpoint.\"},{\"name\":\"Rate Card Table Rows\",\"description\":\"Each Rate Card Table Row represents a role and its rates and currencies\\nfor a specific [Rate Card Set Version](/tag/Rate-Card-Set-Version-(Effective-version-by-Date)).\"},{\"name\":\"Rate Card Versions\",\"description\":\"Rate Card Versions represent a snapshot of a Rate Card at a specified point in time. They are used to set the\\ndefault rate. Rate Card Versions belong to a Rate Card Set Version and own many Rate Card Roles.\\n\\nRate Card Versions cannot be explicitly created. This is done through the creation of Rate Cards or\\nRate Card Set Versions.\"},{\"name\":\"Rate Cards (Multiple Currencies)\",\"description\":\"Rate Cards belong to a Rate Card Set and represent the currencies in that set. Rate Cards have\\nmany Rate Card Versions which represent the effective version of a Rate Card at a specified point of time.\\nRate Cards are accessible to users with Financial access (Project Lead or higher) on the account. However, they\\ncan only created, modified or deleted by Administrators on the account.\"},{\"name\":\"Recommendations\",\"description\":\"A Recommendation suggests a User for an Unnamed Resource (or some other un-staffed position).\\nThe system recommends Users based on how well they match the attributes of a\\ntarget resource. Attributes include, but are not limited to:\\n  - Role\\n  - Skill(s)\\n  - Single Choice Custom Field(s)\\n  - Allocation(s).\"},{\"name\":\"Resource Requests\",\"description\":\"Resource Requests are used as a method for a requestor to ask an approver to staff a resource.\\nResource Requests are associated to a workspace resource and must have an approver associated.\"},{\"name\":\"Roles\",\"description\":\"A Role represents the main position or title assigned to members on an account. Roles may be associated\\nwith account memberships, account invitations, participation, project template assignments, rate card roles,\\nrate card versions, resources, or time adjustments.\"},{\"name\":\"Skill Categories\",\"description\":\"A Skill Category represents the classification for a group of skills. Options are 'Skill', 'Language', 'Certification', and 'Other'.\\n\\nSkill categories are defined by Kantata OX and cannot be modified or deleted.\"},{\"name\":\"Skill Memberships\",\"description\":\"Skill Memberships represent skills that has been assigned to a specified user.\"},{\"name\":\"Skills\",\"description\":\"Skills are used in Kantata OX to describe capabilities of users for the purposes of resource planning.\\nThey can be associated with a user through a Skill Membership.\\nA user can be associated with up to 200 skills.\\nThis model includes categories such as 'Skill', 'Language', 'Certification' and 'Other'.\"},{\"name\":\"Status Reports\",\"description\":\"A Status Report represents a snapshot of a Workspace's status across several categories at a moment\\nin time. Status Reports are usually referred to Health Reports to in the UI.\"},{\"name\":\"Stories\",\"description\":\"Stories are tasks, milestones, deliverables, or issues in\\nKantata OX. They belong to Workspaces, show up in the local and\\nglobal task trackers, can be linked to Posts, can have sub-Stories\\nand TaskLists, and have many attributes for planning, tasking, and\\nfinancials.\"},{\"name\":\"Story Dependencies\",\"description\":\"Story dependencies define relationships between tasks and the sequence in which they must be completed in order to close a project. A dependency is between two tasks (stories) in a project (workspace), with one being the predecessor (source) task, and the other the successor (target) task. Each relationship is characterized by the type of dependency and lag between tasks. There are four (4) types of dependencies:\\n- Finish to Start (FS)—The predecessor ends before the successor can begin.\\n- Start to Start (SS)—The predecessor begins before the successor can begin.\\n- Finish to Finish (FF)—The predecessor ends before the successor can end.\\n- Start to Finish (SF)—The predecessor begins before the successor can end.\\nLag is the number of days between the predecessor task ending and the successor task beginning.\\nTo learn more about dependencies, see our [Gantt Chart Dependencies article](https://mavenlink.zendesk.com/hc/en-us/articles/360000456874-Gantt-Chart-Dependencies).\"},{\"name\":\"Story State Changes\",\"description\":\"Story State Changes in Kantata OX act as an audit trail for changes to the state of a Story.\\nStory State Changes cannot be created directly. They will be created for you automatically when you\\nset the state of a Story. Story State Changes cannot be modified or deleted.\"},{\"name\":\"Story Tasks\",\"description\":\"Story Tasks are used in Kantata OX to track a list of checklist items within a Story.\\nThis model includes a completion boolean and a position integer.\"},{\"name\":\"Survey Answers (Legacy)\",\"description\":\"Survey Answers (Legacy) appear on and can be responded to through surveys. Survey Answers (Legacy) are required to have a value\\nfor the answer (i.e. answers must have at least one choice selected or a non-null value). Additionally, only\\none value type can be specified for the answer (e.g. specifying a date value as well as choice values is\\ninvalid). \\n\\n**Note**: This feature requires the Surveys (Legacy) account add-on. This feature is unrelated to Pulse surveys.\"},{\"name\":\"Survey Questions (Legacy)\",\"description\":\"Survey Questions (Legacy) appear on and can be responded to through surveys.\\n\\n**Note**: This feature requires the Surveys (Legacy) account add-on. This feature is unrelated to Pulse surveys.\"},{\"name\":\"Survey Templates (Legacy)\",\"description\":\"Survey Templates (Legacy) define a set of questions and defaults from which Survey Responses can be created.\\n\\n**Note**: This feature requires the Surveys (Legacy) account add-on. This feature is unrelated to Pulse surveys.\"},{\"name\":\"Surveys Responses (Legacy)\",\"description\":\"Survey Response (Legacy) represents an instance of a particular survey that has been assigned for response.\\n\\n**Note**: This feature requires the Surveys (Legacy) account add-on. This feature is unrelated to Pulse surveys.\"},{\"name\":\"Time Entries\",\"description\":\"This object allows you to manage Kantata OX time entries, depending on your permissions.\\nCreating and updating time entries allows you to include time when invoicing clients.\"},{\"name\":\"Time Off Entries\",\"description\":\"Time Off Entries represent the time and dates that a user has requested off from work, such as PTO or vacation days.\"},{\"name\":\"Timesheet Approvals\",\"description\":\"Approves all the requested pending Timesheet Submissions.\"},{\"name\":\"Timesheet Cancellations\",\"description\":\"Cancels all the requested pending Timesheet Submissions.\"},{\"name\":\"Timesheet Rejections\",\"description\":\"Rejects all the requested pending Timesheet Submissions.\"},{\"name\":\"Timesheet Submissions\",\"description\":\"TimesheetSubmissions hold a set of time entries for a specified week, and can be approved, rejected,\\nor canceled. You can enable Timesheet submissions and approval in your\\n[project settings](https://mavenlink.zendesk.com/hc/en-us/articles/204346530#Financials).\\nOnce enabled, time entries must be approved through a TimesheetSubmission before it is invoiceable.\\n\\n**Note**: Each TimesheetSubmission can only be associated with a single project. So when a timesheet\\nis submitted through the UI with time entries for multiple projects, a separate TimesheetSubmission\\nobject is created for each project in the backend.\"},{\"name\":\"User File Associations\",\"description\":\"User File Associations in Kantata OX act as a join object between Users, Workspaces, and\\nAttachments / Google Documents.\"},{\"name\":\"User Group Memberships\",\"description\":\"A User Group Membership represents the connection of a user to a [Workspace Group](/tag/Workspace-Groups). You must be an [Account Administrator](https://knowledge.kantata.com/hc/en-us/articles/203041364) to use these endpoints.\"},{\"name\":\"Users\",\"description\":\"Users represent the individuals that are participating in Kantata OX projects . User objects are often returned as\\nnested JSON objects within other returned items such as posts or tasks.\"},{\"name\":\"Vendors\",\"description\":\"A Vendor is an entity to which an expense can be paid.\"},{\"name\":\"Workspace Allocations\",\"description\":\"A workspace allocation represents a resource’s allocation over a specific period of time.\\nA workspace allocation is always associate with a workspace resource.\"},{\"name\":\"Workspace Baselines\",\"description\":\"A Gantt workspace baseline is a snapshot of a workspace at a particular point in time.\\nThe snapshot contains aggregate statistics and certain data about each story (task).\"},{\"name\":\"Workspace Groups\",\"description\":\"Workspace Groups (also known as groups) allow for the categorization of Kantata OX Workspaces. Workspace Groups are unique to each Kantata OX Account.\"},{\"name\":\"Workspace Invoice Preferences\",\"description\":\"Workspace Invoice Preferences specify the default values that are applied to new invoices created for the specified\\nproject. It is only used for projects that have financials enabled.\\n\\nThese preferences can only be created and updated by users who can manage invoice preferences\\non the project. This can be found by querying `can_manage_invoice_preferences` on Workspace.\"},{\"name\":\"Workspace Resource Skills\",\"description\":\"Workspace Resource Skills represent skills that have been assigned to a workspace resource.\"},{\"name\":\"Workspace Resources\",\"description\":\"A workspace resource is the object that is tied to assignments and allocations within a Workspace.\\n\\nWorkspace Resources can be:\\n  - Named Resources: Resources with a user_id.\\n  - Unnamed Resources: Resources with no user_id.\\n\\nWith workspace resources it is possible for a user to have many resources with different roles\\nwithin a single workspace.\\nWorkspace resources can be assigned to tasks via Assignments.\\n\\ne.g. In an example workspace, 'the Accounting Project', we could have 3 workspace resources:\\n  1. Alice as an Engineer in the Accounting Project\\n  2. Alice as an Designer in the Accounting Project\\n  3. Bob as a Designer in the Accounting Project\\n\\nWith workspace resources, Alice could be assigned to one task as an Engineer and use the\\nEngineer rate for that task, and another task be assigned as a Designer and thus the designer\\nrate would be used there.\\n\\nWhen a named workspace resource is created, if role_id is not specified, it will default to\\nthe user's primary role within the project (see primary role definition below). When the\\nworkspace resource is created, label with be generated based on the user's primary role.\\n\\n##### Primary Project Role\\n\\nA user's primary project role is defined by role_id on the user's Participation for the\\nworkspace if that is set. If role_id is not set on the user's participation, primary project\\nrole is defined by default_role_id on the user's account_membership only if the user's\\naccount_membership.account_id matches the workspace.account_id\\n(the user belongs to the project's account).\"},{\"name\":\"Workspace Status Changes\",\"description\":\"Workspace Status Changes represent changes made to the status of a project.\"},{\"name\":\"Workspaces\",\"description\":\"Workspaces (also called projects) represent the space in which Kantata OX users plan, communicate, and collaborate.\"},{\"name\":\"Workweek Memberships\",\"description\":\"A Workweek Membership represents the relationship of a user to a workweek.\"},{\"name\":\"Workweeks\",\"description\":\"Workweeks in Kantata OX are owned by an Account. They can be used as the default for an Account or\\ncan be associated to a User through a Workweek Membership.\"}],\"paths\":{\"/access_group_memberships\":{\"get\":{\"summary\":\"Fetching a list of Access Group Memberships\",\"description\":\"Returns all access group memberships. The non-editable \\\"Account Administrators\\\" group is excluded from the response.\\n\\n\\nThis endpoint returns structured Access Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `access_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-access-group-memberships\",\"tags\":[\"Access Group Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"access_group_id\",\"description\":\"Returns only access group memberships for a specified access group.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `access_group` (AccessGroup) - References the associated access group.\\n- `user` (User) - References the associated user.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"user_id\",\"description\":\"Returns only access group memberships for a specified user.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Access Group Memberships have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"access_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccessGroupMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Access Group Membership\",\"description\":\"Adds a user to an access group. Note: To add a user to the Account Administrators access group, you must update\\nthe user's account membership permission instead.\\n\\n\\nThis endpoint returns structured Access Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `access_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-access-group-membership\",\"tags\":[\"Access Group Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `access_group` (AccessGroup) - References the associated access group.\\n- `user` (User) - References the associated user.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"access_group_membership\":{\"type\":\"object\",\"properties\":{\"access_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the access group to add the user to.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user to add to the access group.\"}},\"required\":[\"access_group_id\",\"user_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Access Group Membership has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"access_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccessGroupMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/access_group_memberships/{id}\":{\"get\":{\"summary\":\"Fetching a single Access Group Membership\",\"description\":\"This endpoint returns structured Access Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `access_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-access-group-membership\",\"tags\":[\"Access Group Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `access_group` (AccessGroup) - References the associated access group.\\n- `user` (User) - References the associated user.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Access Group Membership has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"access_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccessGroupMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Access Group Membership\",\"description\":\"Deletes the specified access group membership (i.e. removes the user from the access group). Note: To remove a user\\nfrom the Account Administrators access group, you must update the user's account membership permission instead.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-access-group-membership\",\"tags\":[\"Access Group Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Access Group Membership has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_colors\":{\"get\":{\"summary\":\"Fetching a list of Account Colors\",\"description\":\"Each project in Kantata OX can be tagged with a Project Color for categorization purposes. The colors that\\nare available for projects are defined at the account level. Use the id of Account Color to read and update\\nProject Colors using the workspaces endpoint.\\n\\n\\nThis endpoint returns structured Account Color objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_colors` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-account-colors\",\"tags\":[\"Account Colors\"],\"parameters\":[{\"in\":\"query\",\"name\":\"enabled_only\",\"description\":\"Include only the colors that are enabled on the account.\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Limits account colors to names matching the specified query.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Account Colors have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_insights_mappings/dynamic\":{\"get\":{\"summary\":\"Get Insights Dynamic Dashboards\",\"description\":\"Returns a list of Dynamic Account Insights Mappings (i.e. Insights dynamic dashboards) that are visible to the authenticated user.\\n\\nThis endpoint returns structured Account Insights Mapping objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_insights_mappings` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"list-insights-mapping-dashboards\",\"tags\":[\"Insights Dynamic Dashboards\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `access_groups` (AccessGroup) - Retrieves the Access Groups the dashboard has been shared with. The response will include `access_group_ids`, which references the data in the `access_groups` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Filter for dashboards with a name that match the specified string. This filter is not case sensitive.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc`, `alphabetical:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"alphabetical:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Account Insights Mappings have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_invitations\":{\"get\":{\"summary\":\"Fetching a list of Account Invitations\",\"description\":\"This endpoint returns structured Account Invitation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_invitations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-account-invitations\",\"tags\":[\"Account Invitations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_full_name\",\"description\":\"Show entries where the full name is like the specified parameter.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `default_role` (Role) - The default role of the account.\\n- `invitee` (User) - The new user who will receive the invitation.\\n- `inviter` (User) - The user who has sent the invitation.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_pending\",\"description\":\"Show only pending invitations.\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `bill_rate:asc`, `bill_rate:desc`, `cost_rate:asc`, `cost_rate:desc`, `created_at:asc`, `created_at:desc`, `expiration_date:asc`, `expiration_date:desc`, `full_name:asc`, `full_name:desc`, `permission:asc`, and `permission:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"search\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Account Invitations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_invitations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInvitation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Account Invitation\",\"description\":\"Any members added in excess of your contracted license count are billed at a prorated subscription fee for\\nthe remainder of the billing term. To review your contracted license count,\\nhover over Settings on the left-hand nav bar and select Plan on Kantata OX.\\n\\nThis endpoint has its own rate limit. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for more information.\\n\\n\\nThis endpoint returns structured Account Invitation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_invitations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-account-invitation\",\"tags\":[\"Account Invitations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `default_role` (Role) - The default role of the account.\\n- `invitee` (User) - The new user who will receive the invitation.\\n- `inviter` (User) - The user who has sent the invitation.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"account_invitation\":{\"type\":\"object\",\"properties\":{\"billability_target\":{\"type\":\"integer\",\"format\":\"int32\"},\"bill_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default billing rate, in cents, for the user in a workspace on this account (when the workspace\\ndoes not use a rate card). This attribute can only be set if the current user is either an Administrator\\nor a Project Lead on the account.\"},\"cost_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default cost rate, in cents, for the user in a workspace on this account. This attribute can\\nonly be set if the current user is an Administrator on the account.\"},\"default_read_only\":{\"type\":\"boolean\",\"description\":\"The invited user should have read-only permissions.\"},\"default_role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The internal ID for the default role specified to the invited user.\"},\"email_address\":{\"type\":\"string\",\"description\":\"The email address of the invited user. A link to accept the invitation is sent to this address.\"},\"full_name\":{\"type\":\"string\",\"description\":\"The full name of the invited user.\"},\"headline\":{\"type\":\"string\"},\"permission\":{\"type\":\"string\",\"description\":\"The permission level of the invited user. See account_memberships for more details. Valid values\\ninclude administrator, reports_viewer_with_cost, reports_viewer, project_lead, project_creator, collaborator, and punch_clock.\\\".\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"email_address\",\"full_name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Account Invitation has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_invitations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInvitation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_invitations/{id}\":{\"get\":{\"summary\":\"Fetching a single Account Invitation\",\"description\":\"This endpoint returns structured Account Invitation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_invitations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-account-invitation\",\"tags\":[\"Account Invitations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `default_role` (Role) - The default role of the account.\\n- `invitee` (User) - The new user who will receive the invitation.\\n- `inviter` (User) - The user who has sent the invitation.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Account Invitation has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_invitations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInvitation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Account Invitation\",\"description\":\"This endpoint returns structured Account Invitation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_invitations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-account-invitation\",\"tags\":[\"Account Invitations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `default_role` (Role) - The default role of the account.\\n- `invitee` (User) - The new user who will receive the invitation.\\n- `inviter` (User) - The user who has sent the invitation.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"account_invitation\":{\"type\":\"object\",\"properties\":{\"billability_target\":{\"type\":\"boolean\"},\"bill_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default billing rate, in cents, for the user in a workspace on this account (when the workspace\\ndoes not use a rate card). This attribute can only be set if the current user is either an Administrator\\nor a Project Lead on the account.\"},\"cost_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default cost rate used, in cents, for the user in a workspace on this account. This attribute can\\nonly be set if the current user is an Administrator on the account.\"},\"default_role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The internal ID for the default role specified to the invited user.\"},\"permission\":{\"type\":\"string\",\"description\":\"The permission level of the invited user. See account_memberships for more details. Valid values\\ninclude administrator, reports_viewer_with_cost, reports_viewer, project_lead, project_creator, collaborator, and punch_clock.\\\".\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Account Invitation has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_invitations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInvitation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Account Invitation\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-account-invitation\",\"tags\":[\"Account Invitations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Account Invitation has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_invitations/{id}/resend\":{\"put\":{\"summary\":\"Resend an account invitation\",\"description\":\"Resends an account invitation email to an invited user.\\n\\nThis endpoint has its own rate limit. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for more information.\\n\\n\\nThis endpoint returns structured Account Invitation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_invitations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"resend-account-invitation\",\"tags\":[\"Account Invitations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `default_role` (Role) - The default role of the account.\\n- `invitee` (User) - The new user who will receive the invitation.\\n- `inviter` (User) - The user who has sent the invitation.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Account Invitation has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_invitations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInvitation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_locations\":{\"get\":{\"summary\":\"Fetching a list of Account Locations\",\"description\":\"This endpoint returns structured Account Location objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_locations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-account-locations\",\"tags\":[\"Account Locations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"archived\",\"description\":\"Only includes archived account locations, based on the specified option. Options are 'only', 'exclude', or 'include'.\",\"schema\":{\"type\":\"string\",\"default\":\"exclude\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `name:asc` and `name:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"name\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Returns account locations for the account on the specified workspace.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":\"\"}}],\"responses\":{\"200\":{\"description\":\"A list of Account Locations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_locations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountLocation\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Account Location\",\"description\":\"This endpoint returns structured Account Location objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_locations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-account-location\",\"tags\":[\"Account Locations\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"account_location\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The location the Account Location represents.\"},\"archived\":{\"type\":\"boolean\",\"description\":\"Whether the account location is archived or active. Defaults to false.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Account Location has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_locations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountLocation\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_locations/{id}\":{\"put\":{\"summary\":\"Updating an existing Account Location\",\"description\":\"This endpoint returns structured Account Location objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_locations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-account-location\",\"tags\":[\"Account Locations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"account_location\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The location the Account Location represents.\"},\"archived\":{\"type\":\"boolean\",\"description\":\"Whether the account location is archived or active.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Account Location has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_locations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountLocation\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Account Location\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-account-location\",\"tags\":[\"Account Locations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Account Location has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_memberships\":{\"get\":{\"summary\":\"Fetching a list of Account Memberships\",\"description\":\"You can request either GET /api/v1/account_memberships.json?only=5 or\\nGET /api/v1/account_memberships/5.json. In both cases, default filters will be applied.\\nUnless you provide the is_active:false filter, you won't receive account membership for inactive users, and will get a 404 status\\non the \\\"show\\\" route.\\n\\n\\nThis endpoint returns structured Account Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-account-memberships\",\"tags\":[\"Account Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_full_name\",\"description\":\"Search account memberships by full name of the user.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_user_id\",\"description\":\"Only includes account membership for the specified user ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"can_log_in\",\"description\":\"Return account memberships based on whether or not the member is allowed to login.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `backup_approver_associations` (BackupApproverAssociation) - Retrieves the [backup approver associations](/tag/Backup-Approver-Associations) for the user this account membership is for, which represent a backup time approver for a specific date range. The response will include `backup_approver_association_ids`, which references the data in the `backup_approver_associations` top-level key.\\n- `cost_rates` (CostRate) - Retrieves all the cost rates in different currencies for the user this account membership is for. The response will include `cost_rate_ids`, which references the data in the `cost_rates` top-level key.\\n- `default_role` (Role) - Retrieves the default role, if any, for this account membership. The response will include `default_role_id`, which references the data in the `roles` top-level key.\\n- `effective_workweek` (Workweek) - Retrieves the workweek that is in effect today for the user this account membership is for. The response will include `effective_workweek_id`, which references the data in the `workweeks` top-level key.\\n- `future_billable_utilizations` (BillableUtilization) - Retrieves the future billable utilizations for the user this account membership is for. The response will include `future_billable_utilization_ids`, which references the data in the `billable_utilizations` top-level key.\\n- `managees` (User) - Retrieves the direct reports of the user this account membership is for. The response will include `managee_ids`, which references the data in the `users` top-level key.\\n- `manager` (User) - Retrieves the manager of the user this account membership is for. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `possible_managees` (User) - Retrieves a list of users who can become the direct reports of the user this account membership is for. The response will include `possible_managee_ids`, which references the data in the `users` top-level key.\\n- `possible_managers` (User) - Retrieves a list of users who can be set as the manager of the user this account membership is for. The response will include `possible_manager_ids`, which references the data in the `users` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships for the user this account membership is for, which represent skills assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key.\\n- `user` (User) - Retrieves the user for this account membership. The response will include `user_id`, which references the data in the `users` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_active\",\"description\":\"Only includes users with an active membership (disabled_at is null).\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only_inactive\",\"description\":\"Only includes users with an inactive membership (disabled_at is not null).\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"non_participant\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `bill_rate:asc`, `bill_rate:desc`, `cost_rate:asc`, `cost_rate:desc`, `created_at:asc`, `created_at:desc`, `full_name:asc`, `full_name:desc`, `permission:asc`, `permission:desc`, `role:asc`, `role:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"search\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_user_ids\",\"description\":\"Only includes account memberships for the specified user IDs. For example, '1,2,3'.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"with_skills\":{\"type\":\"object\",\"description\":\"Return account memberships with the requested skills and levels.\\n{ '91': [2, 3], '92':[1], 'ids':[91, 92, 93], 'operation': 'and' }.\",\"properties\":{\"ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"IDs of skills to be included.\"},\"operation\":{\"type\":\"string\",\"description\":\"Use `and` or `or` to include account memberships with all or any of the skills.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"A list of Account Memberships have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"cost_rates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CostRate\"}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_memberships/{id}\":{\"get\":{\"summary\":\"Fetching a single Account Membership\",\"description\":\"This endpoint returns structured Account Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-account-membership\",\"tags\":[\"Account Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `backup_approver_associations` (BackupApproverAssociation) - Retrieves the [backup approver associations](/tag/Backup-Approver-Associations) for the user this account membership is for, which represent a backup time approver for a specific date range. The response will include `backup_approver_association_ids`, which references the data in the `backup_approver_associations` top-level key.\\n- `cost_rates` (CostRate) - Retrieves all the cost rates in different currencies for the user this account membership is for. The response will include `cost_rate_ids`, which references the data in the `cost_rates` top-level key.\\n- `default_role` (Role) - Retrieves the default role, if any, for this account membership. The response will include `default_role_id`, which references the data in the `roles` top-level key.\\n- `effective_workweek` (Workweek) - Retrieves the workweek that is in effect today for the user this account membership is for. The response will include `effective_workweek_id`, which references the data in the `workweeks` top-level key.\\n- `future_billable_utilizations` (BillableUtilization) - Retrieves the future billable utilizations for the user this account membership is for. The response will include `future_billable_utilization_ids`, which references the data in the `billable_utilizations` top-level key.\\n- `managees` (User) - Retrieves the direct reports of the user this account membership is for. The response will include `managee_ids`, which references the data in the `users` top-level key.\\n- `manager` (User) - Retrieves the manager of the user this account membership is for. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `possible_managees` (User) - Retrieves a list of users who can become the direct reports of the user this account membership is for. The response will include `possible_managee_ids`, which references the data in the `users` top-level key.\\n- `possible_managers` (User) - Retrieves a list of users who can be set as the manager of the user this account membership is for. The response will include `possible_manager_ids`, which references the data in the `users` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships for the user this account membership is for, which represent skills assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key.\\n- `user` (User) - Retrieves the user for this account membership. The response will include `user_id`, which references the data in the `users` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"non_participant\"]}}}],\"responses\":{\"200\":{\"description\":\"The Account Membership has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"cost_rates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CostRate\"}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Account Membership\",\"description\":\"This endpoint returns structured Account Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-account-membership\",\"tags\":[\"Account Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `backup_approver_associations` (BackupApproverAssociation) - Retrieves the [backup approver associations](/tag/Backup-Approver-Associations) for the user this account membership is for, which represent a backup time approver for a specific date range. The response will include `backup_approver_association_ids`, which references the data in the `backup_approver_associations` top-level key.\\n- `cost_rates` (CostRate) - Retrieves all the cost rates in different currencies for the user this account membership is for. The response will include `cost_rate_ids`, which references the data in the `cost_rates` top-level key.\\n- `default_role` (Role) - Retrieves the default role, if any, for this account membership. The response will include `default_role_id`, which references the data in the `roles` top-level key.\\n- `effective_workweek` (Workweek) - Retrieves the workweek that is in effect today for the user this account membership is for. The response will include `effective_workweek_id`, which references the data in the `workweeks` top-level key.\\n- `future_billable_utilizations` (BillableUtilization) - Retrieves the future billable utilizations for the user this account membership is for. The response will include `future_billable_utilization_ids`, which references the data in the `billable_utilizations` top-level key.\\n- `managees` (User) - Retrieves the direct reports of the user this account membership is for. The response will include `managee_ids`, which references the data in the `users` top-level key.\\n- `manager` (User) - Retrieves the manager of the user this account membership is for. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `possible_managees` (User) - Retrieves a list of users who can become the direct reports of the user this account membership is for. The response will include `possible_managee_ids`, which references the data in the `users` top-level key.\\n- `possible_managers` (User) - Retrieves a list of users who can be set as the manager of the user this account membership is for. The response will include `possible_manager_ids`, which references the data in the `users` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships for the user this account membership is for, which represent skills assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key.\\n- `user` (User) - Retrieves the user for this account membership. The response will include `user_id`, which references the data in the `users` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"non_participant\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"account_membership\":{\"type\":\"object\",\"properties\":{\"bill_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default billing rate, in cents, for the user in a workspace on this account.\"},\"cost_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default cost rate, in cents, for the user in a workspace on this account.\"},\"default_role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The internal ID for the role of this user on this account.\"},\"permission\":{\"type\":\"string\",\"description\":\"The user's permission level on the account. Valid values are 'administrator', 'reports_viewer', 'reports_viewer_with_cost', 'project_lead', 'project_creator', 'punch_clock', 'external_collaborator' or 'collaborator'.\"},\"billability_target\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Value for setting the user's billability target.\"},\"default_read_only\":{\"type\":\"boolean\",\"description\":\"Whether the user is always read-only in workspaces.\"},\"manager_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The User ID of the user's manager.\"},\"manager_can_approve\":{\"type\":\"boolean\",\"description\":\"Whether the user's named manager can approve their time and expenses.\"},\"should_show_alert_on_timesheet_submission\":{\"type\":\"boolean\",\"description\":\"Show an alert on a user's timesheet.\"},\"change_role_option\":{\"type\":\"string\",\"description\":\"Select 'update_with_new_role', 'add_another_role', or 'keep_existing_role'. If no option is selected another role will be added.\"},\"enforce_workweek_minimum_on_timesheet_submission\":{\"type\":\"boolean\",\"description\":\"If true, the user is required to submit timesheets equal to or greater than their workweek hours.\"},\"enforce_workweek_maximum_on_timesheet_submission\":{\"type\":\"boolean\",\"description\":\"If true, the user is required to submit timesheets equal to or less than their workweek hours.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Account Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"cost_rates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CostRate\"}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Remove a user from an account\",\"description\":\"This removes the member from your account and places them on a separate Kantata OX account. It is important\\nto know that the account owner cannot be removed.\\n\\n**WARNING:** Since the removed member gets their on own separate Kantata OX account,\\nthey will remain on existing projects but will be View Only and no\\nlonger be able to create projects in your account.\\n\\nWe suggest `disabling` an account member over removing them since it revokes their ability to access\\nyour account and they will no longer have access to projects for which they were contributing.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-account-membership\",\"tags\":[\"Account Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Account Membership has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_memberships/{id}/disable\":{\"put\":{\"summary\":\"Make a user inactive\",\"description\":\"Disables a user in an account\\n\\nThis endpoint returns structured Account Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"deactivate-account-membership\",\"tags\":[\"Account Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `backup_approver_associations` (BackupApproverAssociation) - Retrieves the [backup approver associations](/tag/Backup-Approver-Associations) for the user this account membership is for, which represent a backup time approver for a specific date range. The response will include `backup_approver_association_ids`, which references the data in the `backup_approver_associations` top-level key.\\n- `cost_rates` (CostRate) - Retrieves all the cost rates in different currencies for the user this account membership is for. The response will include `cost_rate_ids`, which references the data in the `cost_rates` top-level key.\\n- `default_role` (Role) - Retrieves the default role, if any, for this account membership. The response will include `default_role_id`, which references the data in the `roles` top-level key.\\n- `effective_workweek` (Workweek) - Retrieves the workweek that is in effect today for the user this account membership is for. The response will include `effective_workweek_id`, which references the data in the `workweeks` top-level key.\\n- `future_billable_utilizations` (BillableUtilization) - Retrieves the future billable utilizations for the user this account membership is for. The response will include `future_billable_utilization_ids`, which references the data in the `billable_utilizations` top-level key.\\n- `managees` (User) - Retrieves the direct reports of the user this account membership is for. The response will include `managee_ids`, which references the data in the `users` top-level key.\\n- `manager` (User) - Retrieves the manager of the user this account membership is for. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `possible_managees` (User) - Retrieves a list of users who can become the direct reports of the user this account membership is for. The response will include `possible_managee_ids`, which references the data in the `users` top-level key.\\n- `possible_managers` (User) - Retrieves a list of users who can be set as the manager of the user this account membership is for. The response will include `possible_manager_ids`, which references the data in the `users` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships for the user this account membership is for, which represent skills assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key.\\n- `user` (User) - Retrieves the user for this account membership. The response will include `user_id`, which references the data in the `users` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"non_participant\"]}}}],\"responses\":{\"200\":{\"description\":\"Account Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"cost_rates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CostRate\"}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_memberships/{id}/enable\":{\"put\":{\"summary\":\"Make a user active\",\"description\":\"Enables a user in an account\\n\\nThis endpoint returns structured Account Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `account_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"activate-account-membership\",\"tags\":[\"Account Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `backup_approver_associations` (BackupApproverAssociation) - Retrieves the [backup approver associations](/tag/Backup-Approver-Associations) for the user this account membership is for, which represent a backup time approver for a specific date range. The response will include `backup_approver_association_ids`, which references the data in the `backup_approver_associations` top-level key.\\n- `cost_rates` (CostRate) - Retrieves all the cost rates in different currencies for the user this account membership is for. The response will include `cost_rate_ids`, which references the data in the `cost_rates` top-level key.\\n- `default_role` (Role) - Retrieves the default role, if any, for this account membership. The response will include `default_role_id`, which references the data in the `roles` top-level key.\\n- `effective_workweek` (Workweek) - Retrieves the workweek that is in effect today for the user this account membership is for. The response will include `effective_workweek_id`, which references the data in the `workweeks` top-level key.\\n- `future_billable_utilizations` (BillableUtilization) - Retrieves the future billable utilizations for the user this account membership is for. The response will include `future_billable_utilization_ids`, which references the data in the `billable_utilizations` top-level key.\\n- `managees` (User) - Retrieves the direct reports of the user this account membership is for. The response will include `managee_ids`, which references the data in the `users` top-level key.\\n- `manager` (User) - Retrieves the manager of the user this account membership is for. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `possible_managees` (User) - Retrieves a list of users who can become the direct reports of the user this account membership is for. The response will include `possible_managee_ids`, which references the data in the `users` top-level key.\\n- `possible_managers` (User) - Retrieves a list of users who can be set as the manager of the user this account membership is for. The response will include `possible_manager_ids`, which references the data in the `users` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships for the user this account membership is for, which represent skills assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key.\\n- `user` (User) - Retrieves the user for this account membership. The response will include `user_id`, which references the data in the `users` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"non_participant\"]}}}],\"responses\":{\"200\":{\"description\":\"Account Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"cost_rates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CostRate\"}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/account_rate_cards_activations\":{\"get\":{\"summary\":\"Check Rate Cards Activation Status\",\"description\":\"This endpoint allows you to check whether the Rate Cards feature has been activated on\\nthe user's account.\\n  This endpoint is only accessible to users with Financial access (Project Lead or higher) on the account.\",\"operationId\":\"get-activation-status-rate-cards\",\"tags\":[\"Activations\"],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"activated\":{\"type\":\"boolean\",\"description\":\"Indicates whether the Rate Card feature has been enabled on the user's account.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Activate Rate Cards\",\"description\":\"Activate Rate Cards on a user's account by submitting a rate card set version that belongs to\\nthe default Rate Card Set. Only an Account Administrator can activate rate cards on an account.\\n\\nThe initial request to this endpoint will generate an account default Rate Card Set and create a\\nRate Card Set Version. This account default Rate Card Set will include a separate Rate Card for every currency\\nused in projects on the user's account.\",\"operationId\":\"activate-rate-cards\",\"tags\":[\"Activations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"rate_card_set_version_id\",\"required\":true,\"description\":\"The ID of the Rate Card Set Version belonging to the account default Rate Card Set.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"object has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"activated\":{\"type\":\"boolean\",\"description\":\"Indicates whether the Rate Card feature has been enabled on the user's account.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/assignments\":{\"get\":{\"summary\":\"Fetching a list of Assignments\",\"description\":\"For Account Administrators, returns task assignments in all projects across an account.\\nFor non-Account Administrators, returns task assignments only in projects they are part of.\\n\\n\\nThis endpoint returns structured Assignment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `assignments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-assignments\",\"tags\":[\"Assignments\"],\"parameters\":[{\"in\":\"query\",\"name\":\"assignee_id\",\"description\":\"Only includes assignments that belong to the specified user ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"current\",\"description\":\"Only includes assignments that are active.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"in_unarchived_stories\",\"description\":\"Only includes assignments that belong to inactive tasks.\\n(Inactive tasks can exist in active projects, and vice versa.).\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"in_unarchived_workspaces\",\"description\":\"Only includes assignments that belong to active projects.\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `assignee` (User) - References the user who owns the assignment.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `story` (Story) - References the task to which the assignment belongs.\\n- `story_allocation_days` (StoryAllocationDay) - References all of the Story Allocation Days that belong to the assignment. Including story allocation\\ndays _requires_ the request to be filtered with the `plannable` filter.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include_unnamed\",\"required\":false,\"description\":\"Includes task assignments to unnamed resources. Think of unnamed resources as placeholders;\\n            it indicates the need for a certain role, before knowing who will fill it. Set to `False` by default.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"plannable\",\"required\":false,\"description\":\"Filters for assignments which the requester can view and create\\n            [Daily Scheduled Hours](/tag/Daily-Scheduled-Hours-(Story-Allocation-Days)) for. Must be set to `true` when using the `include` parameter with the `story_allocation_days` association.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"resource_id\",\"description\":\"Only includes assignments that belong to the specified resource ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"story_id\",\"description\":\"Only includes assignments that belong to the specified task ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"uncurrent\",\"description\":\"Only includes assignments that are inactive.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Only includes assignments that belong to the specified project ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Assignments have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Assignment\",\"description\":\"This endpoint returns structured Assignment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `assignments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-assignment\",\"tags\":[\"Assignments\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `assignee` (User) - References the user who owns the assignment.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `story` (Story) - References the task to which the assignment belongs.\\n- `story_allocation_days` (StoryAllocationDay) - References all of the Story Allocation Days that belong to the assignment. Including story allocation\\ndays _requires_ the request to be filtered with the `plannable` filter.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"assignment\":{\"type\":\"object\",\"properties\":{\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the task being assigned to a resource.\"},\"assignee_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user the assignment is for.\\nDo not specify an `assignee_id` if a `resource_id` is also specified.\\nWhen both parameters are specified, `assignee_id` is overridden by `resource_id`.\"},\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resource the assignment is for.\"},\"current\":{\"type\":\"boolean\",\"description\":\"Whether the assignment is active. `True` indicates an active\\nassignment, and `False` indicates inactive.\\n\\nAssignments cannot be deleted,\\nbut are considered inactive when a resource is unassigned from a task.\"},\"estimated_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of minutes the resource is estimated to work on the task.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\"]}},\"required\":[\"story_id\",\"resource_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Assignment has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/assignments/{id}\":{\"get\":{\"summary\":\"Fetching a single Assignment\",\"description\":\"This endpoint returns structured Assignment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `assignments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-assignment\",\"tags\":[\"Assignments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `assignee` (User) - References the user who owns the assignment.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `story` (Story) - References the task to which the assignment belongs.\\n- `story_allocation_days` (StoryAllocationDay) - References all of the Story Allocation Days that belong to the assignment. Including story allocation\\ndays _requires_ the request to be filtered with the `plannable` filter.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Assignment has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Assignment\",\"description\":\"This endpoint returns structured Assignment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `assignments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-assignment\",\"tags\":[\"Assignments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `assignee` (User) - References the user who owns the assignment.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `story` (Story) - References the task to which the assignment belongs.\\n- `story_allocation_days` (StoryAllocationDay) - References all of the Story Allocation Days that belong to the assignment. Including story allocation\\ndays _requires_ the request to be filtered with the `plannable` filter.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"assignment\":{\"type\":\"object\",\"properties\":{\"assignee_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user the assignment is for.\\nDo not specify an `assignee_id` if a `resource_id` is also specified.\\nWhen both parameters are specified, `assignee_id` is overridden by `resource_id`.\"},\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resource the assignment is for.\"},\"current\":{\"type\":\"boolean\",\"description\":\"Whether the assignment is active. Set as `true` to assign the resource to the task. Set as `false` to unassign the resource from the task.\"},\"estimated_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of minutes the resource is estimated to work on the task.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Assignment has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Assignment\",\"description\":\"Unassigns a resource from a task. The assignment is soft deleted by\\nsetting the `current` field to `false`. The assignment is then\\nconsidered inactive. Using this endpoint is the same as using\\nthe [update an existing assignment](/tag/Assignments#operation/update-assignment)\\nendpoint and setting the `current` parameter to `false`.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-assignment\",\"tags\":[\"Assignments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Assignment has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/attachments\":{\"post\":{\"summary\":\"Creating a new Attachment\",\"description\":\"There are two different ways to upload file attachments.  Direct CDN upload, or Kantata OX server upload.\\n\\n## Direct CDN Upload\\n\\nUploading directly to the CDN is a three step process but allows for faster uploading, significantly\\nlarger attachments, and more accurate upload progress information.\\n\\nRetrieving upload credentials has two required fields, `direct` and `attachment`.  The `direct` field must\\nbe set to `true`.  The `attachment` field must include two attributes:\\n\\n - `type` (required) must be `post_attachment`, `receipt`, or `proof`.\\n - `filename` (required) is the filename of the file to be uploaded.\\n\\nThe file name must not contain spaces or special characters other than an underscore (\\\"_\\\") or a hyphen (\\\"-\\\"),\\notherwise the file upload will fail.\\n\\nAfter successfully creating an attachment, an upload url and credentials will be returned in JSON format\\nwith an HTTP 200 status code.\\n\\n```\\ncurl --form \\\"direct=true\\\" --form \\\"attachment[filename]=attachment.doc\\\"\\n--form \\\"attachment[type]=post_attachment\\\" \\\"https://api.mavenlink.com/api/v1/attachments.json\\\"\\n```\\n\\nThe response JSON will then contain the information to upload the file:\\n\\n```\\n{\\n   \\\"id\\\": 2,\\n   \\\"action\\\": \\\"[upload url]\\\",\\n   \\\"fields\\\":{\\n      \\\"utf8\\\": \\\"✓\\\",\\n      \\\"key\\\": \\\" ... \\\",\\n      \\\"Content-Disposition\\\": \\\"attachment; filename=\\\"attachment.doc\\\"; filename*=UTF-8''attachment.doc\\\",\\n      \\\"success_action_status\\\": 201,\\n      \\\"AWSAccessKeyId\\\": \\\" ... \\\",\\n      \\\"acl\\\": \\\"private\\\",\\n      \\\"policy\\\": \\\" ... \\\",\\n      \\\"signature\\\": \\\" ... \\\"\\n   }\\n}\\n```\\n\\nA second POST request can then be made to the provided `action` with the field values\\nreturned in the JSON response, in addition to the file data. The AWSAccessKeyId field value\\nis only active for 5 seconds, so these consecutive calls are meant to be made in quick succession via a script.\\n\\nOther than `$file`, variables in the request that start with $ are the values represented by the \\\" ... \\\" blanks in the JSON response.\\n\\n```\\ncurl -X POST \\\"[upload url]\\\" -H 'cache-control: no-cache' --form 'AWSAccessKeyId='$awsKey --form 'Content-Disposition=\\\"attachment; filename=\\\"$file\\\"; filename*=UTF-8''''''$file\\\"' --form 'x-amz-server-side-encryption=AES256' --form 'key='$key --form 'policy='$policy --form 'signature='$sig --form 'acl=private' --form 'success_action_status=201' --form 'utf8=✓' --form 'file=@'$file\\n```\\n\\nFinally, once the upload has completed successfully, a 'sync' request (specified below) is necessary to\\nmark the upload as complete.\\n\\nBelow is a simplified example using ruby to achieve the same thing as with the `curl` commands above:\\n\\n```ruby\\n#!/usr/bin/env ruby\\n\\nrequire 'net/https'\\nrequire \\\"uri\\\"\\nrequire 'json'\\n\\nTOKEN=\\\"Bearer <your-secret-here>\\\"\\nATTACHMENTS_ENDPOINT=\\\"https://api.mavenlink.com/api/v1/attachments.json\\\"\\nBOUNDARY = \\\"AaB03x\\\" # Make sure it is not present in the file you're uploading.\\n\\nfile = ARGV[0]\\nfilename = File.basename(file)\\n\\nuri = URI.parse(ATTACHMENTS_ENDPOINT)\\nhttp = Net::HTTP.new(uri.host, uri.port)\\nhttp.use_ssl = true\\nrequest = Net::HTTP::Post.new(uri.request_uri)\\nrequest['Authorization'] = TOKEN\\nrequest.set_form_data(first_request_params)\\nresponse = http.request(request)\\nfirst_response = JSON.parse(response.body)\\n\\n# for the second request we manually build the request body\\npost_body = []\\n\\nsecond_request_params = first_response[\\\"fields\\\"].merge({ \\\"file\\\" => File.open(file) })\\nsecond_request_params.each do |k,v|\\n  post_body << \\\"--#{BOUNDARY}\\\\r\\\\n\\\"\\n  if v.is_a?(IO)\\n    post_body << \\\"Content-Disposition: form-data; name=\\\"#{k}\\\"; filename=\\\"#{filename}\\\"\\\\r\\\\n\\\"\\n    post_body << \\\"\\\\r\\\\n\\\"\\n    post_body << File.read(file)\\n    post_body << \\\"\\\\r\\\\n\\\"\\n  else\\n    post_body << \\\"Content-Disposition: form-data; name=\\\"#{k}\\\"\\\\r\\\\n\\\\r\\\\n\\\"\\n    post_body << v.to_s + \\\"\\\\r\\\\n\\\"\\n  end\\nend\\n\\npost_body << \\\"--#{BOUNDARY}--\\\\r\\\\n\\\"\\n\\nuri = URI.parse(first_response[\\\"action\\\"])\\nhttp = Net::HTTP.new(uri.host, uri.port)\\nhttp.use_ssl = true\\nrequest = Net::HTTP::Post.new(uri.request_uri)\\nrequest.body = post_body.join\\nrequest[\\\"Content-Type\\\"] = \\\"multipart/form-data, boundary=#{BOUNDARY}\\\"\\nresponse = http.request(request)\\n\\nexit(response.code == second_request_params[\\\"success_action_status\\\"].to_s)\\n```\\n\\n### Syncing a created Attachment\\nSyncing marks an upload as complete, and verifies its existence on the CDN.\\n\\nA sync request can be made as follows:\\n\\n```\\ncurl -X PUT \\\"https://api.mavenlink.com/api/v1/attachments/2/sync.json\\\"\\n```\\n\\n## Kantata OX Server Upload\\n\\nFor small attachments (< 10MB), you may upload to our servers and skip the 3-step direct CDN upload process.\\nDoing so requires one field, `attachment`, with two required attributes:\\n\\n - `type` (required) must be either `post_attachment`, `receipt`, or `proof`.\\n - `data` (required) is the multipart/form-data encoded file contents.\\n\\nAfter successfully creating an attachment its metadata will be returned in JSON format with an HTTP 200\\nstatus code. To upload a file using the `curl` utility, you would run a command like this one:\\n\\n```\\ncurl --form \\\"attachment[data]=@test.rb\\\" --form \\\"attachment[type]=post_attachment\\\" \\\"https://api.mavenlink.com/api/v1/attachments.json\\\"\\n```\\n\\n\\nThis endpoint returns structured Attachment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `attachments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-attachment\",\"tags\":[\"Attachments\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"attachment\":{\"type\":\"object\",\"properties\":{\"type\":{\"type\":\"string\",\"description\":\"Indicates the type of Attachment within Kantata OX.  Allowed values are: receipt, post_attachment, or\\nproof.  A receipt is attached to an Expense, a post_attachment is attached to a Post, and a proof is\\nattached to a Proof.\"},\"direct\":{\"type\":\"boolean\",\"description\":\"Whether or not this is a direct CDN upload.  If direct is set to true, the filename field is required.\\nIf direct is set to false or is not present, the data field is required.\"},\"data\":{\"type\":\"string\",\"description\":\"The multipart/form-data encoded file contents.  Only used if direct is not set to true.  Note that the\\nmaximum allowed size for file data uploads is 10MB.  For larger files, use a direct CDN upload.\"},\"filename\":{\"type\":\"string\",\"description\":\"The filename of the file to be uploaded.  Only used if direct is set to true.\"}},\"required\":[\"type\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Attachment has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_Base\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/attachments/{id}\":{\"put\":{\"summary\":\"Updating an existing Attachment\",\"description\":\"This endpoint returns structured Attachment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `attachments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-attachment\",\"tags\":[\"Attachments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"attachment\":{\"type\":\"object\",\"properties\":{\"filename\":{\"type\":\"string\",\"description\":\"Used to rename an already existing attachment within Kantata OX.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Attachment has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_Base\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Attachment\",\"description\":\"Destroys an attachment from its subject object.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-attachment\",\"tags\":[\"Attachments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Attachment has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/attachments/{id}/sync\":{\"put\":{\"summary\":\"Sync a created attachment\",\"description\":\"Marks an upload as complete, and verifies its existence on the CDN.\\n\\n\\nThis endpoint returns structured Attachment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `attachments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"sync-attachment\",\"tags\":[\"Attachments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"Attachment has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_Base\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/backup_approver_associations\":{\"get\":{\"summary\":\"Fetching a list of Backup Approver Associations\",\"description\":\"The index endpoint only returns backup approver associations that are visible to the user.\\nBackup approver associations are only visible to account members.\\n\\n\\nThis endpoint returns structured Backup Approver Association objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `backup_approver_associations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-backup-approver-associations\",\"tags\":[\"Backup Approver Associations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approver` (User) - The user who would normally approve time.\\n- `backup_approver` (User) - The user who will be approving time in place of the normal approver.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Backup Approver Associations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Backup Approver Association\",\"description\":\"This endpoint returns structured Backup Approver Association objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `backup_approver_associations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-backup-approver-association\",\"tags\":[\"Backup Approver Associations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approver` (User) - The user who would normally approve time.\\n- `backup_approver` (User) - The user who will be approving time in place of the normal approver.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"backup_approver_association\":{\"type\":\"object\",\"properties\":{\"backup_approver_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user designated as backup approver.\"},\"approver_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user designated as the approver.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date on which the approver and backup approver are current. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The end date on which the approver and backup approver are current. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}},\"required\":[\"backup_approver_id\",\"approver_id\",\"start_date\",\"end_date\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Backup Approver Association has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/backup_approver_associations/{id}\":{\"get\":{\"summary\":\"Fetching a single Backup Approver Association\",\"description\":\"This endpoint returns structured Backup Approver Association objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `backup_approver_associations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-backup-approver-association\",\"tags\":[\"Backup Approver Associations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approver` (User) - The user who would normally approve time.\\n- `backup_approver` (User) - The user who will be approving time in place of the normal approver.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Backup Approver Association has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Backup Approver Association\",\"description\":\"This endpoint returns structured Backup Approver Association objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `backup_approver_associations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-backup-approver-association\",\"tags\":[\"Backup Approver Associations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approver` (User) - The user who would normally approve time.\\n- `backup_approver` (User) - The user who will be approving time in place of the normal approver.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"backup_approver_association\":{\"type\":\"object\",\"properties\":{\"backup_approver_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user designated as backup approver.\"},\"approver_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user designated as the approver.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date on which the approver and backup approver are current. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The end date on which the approver and backup approver are current. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Backup Approver Association has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"backup_approver_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BackupApproverAssociation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Backup Approver Association\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-backup-approver-association\",\"tags\":[\"Backup Approver Associations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Backup Approver Association has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/billable_utilizations\":{\"get\":{\"summary\":\"Fetching a list of Billable Utilizations\",\"description\":\"This endpoint returns structured Billable Utilization objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `billable_utilizations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-billable-utilizations\",\"tags\":[\"Billable Utilizations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - The account membership for the user with whom the billable utilization is associated.\\n- `creator` (User) - The user who created the billable utilization.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Billable Utilizations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Billable Utilization\",\"description\":\"This endpoint returns structured Billable Utilization objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `billable_utilizations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-billable-utilization\",\"tags\":[\"Billable Utilizations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - The account membership for the user with whom the billable utilization is associated.\\n- `creator` (User) - The user who created the billable utilization.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"billable_utilization\":{\"type\":\"object\",\"properties\":{\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the billable utilization becomes active. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"target\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The percentage of logged time that should be billable for the account member.\"},\"account_membership_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The account membership ID of the user to set the billable utilization for.\"}},\"required\":[\"effective_date\",\"target\",\"account_membership_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Billable Utilization has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/billable_utilizations/{id}\":{\"get\":{\"summary\":\"Fetching a single Billable Utilization\",\"description\":\"This endpoint returns structured Billable Utilization objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `billable_utilizations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-billable-utilization\",\"tags\":[\"Billable Utilizations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - The account membership for the user with whom the billable utilization is associated.\\n- `creator` (User) - The user who created the billable utilization.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Billable Utilization has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Billable Utilization\",\"description\":\"This endpoint returns structured Billable Utilization objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `billable_utilizations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-billable-utilization\",\"tags\":[\"Billable Utilizations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - The account membership for the user with whom the billable utilization is associated.\\n- `creator` (User) - The user who created the billable utilization.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"billable_utilization\":{\"type\":\"object\",\"properties\":{\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the billable utilization becomes active. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"target\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The percentage of logged time that should be billable for the account member.\"}},\"required\":[\"effective_date\",\"target\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Billable Utilization has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"billable_utilizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BillableUtilization\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Billable Utilization\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-billable-utilization\",\"tags\":[\"Billable Utilizations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Billable Utilization has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/client_invoice_defaults\":{\"get\":{\"summary\":\"Fetching a list of Client Invoice Defaults\",\"description\":\"This endpoint returns structured Client Invoice Defaults objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `client_invoice_defaults` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-client-invoice-defaults\",\"tags\":[\"Client Invoice Defaults\"],\"parameters\":[{\"in\":\"query\",\"name\":\"client_user_id\",\"description\":\"The user ID of the client.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"The ID of the project for which you are creating the invoice.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Client Invoice Defaults have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"client_invoice_defaults\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ClientInvoiceDefault\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating Client Invoice Defaults\",\"description\":\"This endpoint returns structured Client Invoice Defaults objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `client_invoice_defaults` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-client-invoice-defaults\",\"tags\":[\"Client Invoice Defaults\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"client_invoice_default\":{\"type\":\"object\",\"properties\":{\"client_account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user ID of the client being invoiced.\"},\"time_rollup_type\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Options for how time is formatted on an invoice. These options include 'Detailed', 'Grouped by task',\\nand 'Grouped by person, then task'. They are represented by the numbers 0, 1, and 2, respectively.\"},\"expense_rollup_type\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Options for how expenses are formatted on an invoice. These options include 'Detailed' and 'Grouped'.\\nThey are represented by the numbers 0 and 1, respectively.\"},\"rich_text\":{\"type\":\"string\",\"description\":\"The default rich text shown as additional details on the invoice.\"},\"show_project_names\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Whether project names should be shown on the invoice.\"},\"show_task_names\":{\"type\":\"boolean\",\"description\":\"Whether task names should be shown for invoice items.\"},\"show_subtotals\":{\"type\":\"boolean\",\"description\":\"Whether subtotals should be shown for time entries on the invoice.\"},\"show_creators\":{\"type\":\"boolean\",\"description\":\"Whether the name of the person who created the entry should be shown.\"},\"show_dates\":{\"type\":\"boolean\",\"description\":\"Whether dates for items on the invoice should be shown.\"},\"show_notes\":{\"type\":\"boolean\",\"description\":\"Whether notes for items on the invoice should be shown.\"},\"show_hours\":{\"type\":\"boolean\",\"description\":\"Whether hours logged on a time entry on the invoice should be shown.\"},\"show_rates\":{\"type\":\"boolean\",\"description\":\"Whether the rate for the item should be shown.\"},\"show_tax\":{\"type\":\"boolean\",\"description\":\"Whether the item's taxable amount should be shown.\"},\"show_roles\":{\"type\":\"boolean\",\"description\":\"Whether the role of the person who created the item should be shown.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Client Invoice Defaults has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"client_invoice_defaults\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ClientInvoiceDefault\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/client_invoice_defaults/{id}\":{\"get\":{\"summary\":\"Fetching Client Invoice Defaults by ID\",\"description\":\"This endpoint returns structured Client Invoice Defaults objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `client_invoice_defaults` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-client-invoice-defaults-by-id\",\"tags\":[\"Client Invoice Defaults\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"The Client Invoice Defaults has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"client_invoice_defaults\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ClientInvoiceDefault\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating Client Invoice Defaults by ID\",\"description\":\"This endpoint returns structured Client Invoice Defaults objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `client_invoice_defaults` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-client-invoice-defaults-by-id\",\"tags\":[\"Client Invoice Defaults\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"client_invoice_default\":{\"type\":\"object\",\"properties\":{\"time_rollup_type\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Options for how time is formatted on an invoice. These options include 'Detailed', 'Grouped by task', and 'Grouped by person, then task'. They are represented by the numbers 0, 1, and 2, respectively.\"},\"expense_rollup_type\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Options for how expenses are formatted on an invoice. These options include 'Detailed' and 'Grouped', and are represented by the numbers 0 and 1, respectively.\"},\"rich_text\":{\"type\":\"string\",\"description\":\"The default rich text shown as additional details on the invoice.\"},\"show_project_names\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Whether project names should be shown on the invoice.\"},\"show_task_names\":{\"type\":\"boolean\",\"description\":\"Whether task names should be shown for invoice items.\"},\"show_subtotals\":{\"type\":\"boolean\",\"description\":\"Whether subtotals should be shown for time entries on the invoice.\"},\"show_creators\":{\"type\":\"boolean\",\"description\":\"Whether the name of the person who created the entry should be shown.\"},\"show_dates\":{\"type\":\"boolean\",\"description\":\"Whether dates for items on the invoice should be shown.\"},\"show_notes\":{\"type\":\"boolean\",\"description\":\"Whether notes for items on the invoice should be shown.\"},\"show_hours\":{\"type\":\"boolean\",\"description\":\"Whether hours logged on a time entry on the invoice should be shown.\"},\"show_rates\":{\"type\":\"boolean\",\"description\":\"Whether the rate for the item should be shown.\"},\"show_tax\":{\"type\":\"boolean\",\"description\":\"Whether the item's taxable amount should be shown.\"},\"show_roles\":{\"type\":\"boolean\",\"description\":\"Whether the role of the person who created the item should be shown.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Client Invoice Defaults has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"client_invoice_defaults\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ClientInvoiceDefault\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting Client Invoice Defaults by ID\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-client-invoice-defaults-by-id\",\"tags\":[\"Client Invoice Defaults\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Client Invoice Defaults has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/cost_rates\":{\"get\":{\"summary\":\"Get Cost Rates\",\"description\":\"This endpoint returns structured Cost Rate objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `cost_rates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-cost-rates\",\"tags\":[\"Cost Rates\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - The account membership associated with the cost rate.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Cost Rates have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"cost_rates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CostRate\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating one or many Cost Rates\",\"description\":\"Creates a new cost rate for a specified account membership and currency. If a cost rate already exists\\nfor the specified account membership and currency, it will be overridden, effectively making this an\\nupdate request as well. Up to 100 cost rates can be created or updated at once.\\n\\n**Note**: Updating a cost rate will set the cost rate for future work. Existing time entries will not be affected.\\n\\n\\nThis endpoint returns structured Cost Rate objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `cost_rates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-cost-rate\",\"tags\":[\"Cost Rates\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - The account membership associated with the cost rate.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"cost_rate\":{\"type\":\"object\",\"properties\":{\"account_membership_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account membership associated to the cost rate.\"},\"currency\":{\"type\":\"string\",\"description\":\"The ISO currency code for the cost rate currency.\"},\"amount_in_subunits\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost amount, in subunits of the currency (for example, cents for US dollars).\"}},\"required\":[\"account_membership_id\",\"currency\",\"amount_in_subunits\"]},\"cost_rates\":{\"type\":\"array\",\"description\":\"Multiple cost rates and their attributes in an array.\",\"items\":{\"type\":\"object\",\"properties\":{\"account_membership_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account membership associated to the cost rate.\"},\"currency\":{\"type\":\"string\",\"description\":\"The ISO currency code for the cost rate currency.\"},\"amount_in_subunits\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost amount, in subunits of the currency (for example, cents for US dollars).\"}},\"required\":[\"account_membership_id\",\"currency\",\"amount_in_subunits\"]}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Cost Rate has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"cost_rates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CostRate\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/cost_rates/{id}\":{\"put\":{\"summary\":\"Updating an existing Cost Rate\",\"description\":\"This endpoint returns structured Cost Rate objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `cost_rates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-cost-rate\",\"tags\":[\"Cost Rates\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - The account membership associated with the cost rate.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"cost_rate\":{\"type\":\"object\",\"properties\":{\"amount_in_subunits\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost amount, in subunits of the currency (for example, cents for US dollars).\"}},\"required\":[\"amount_in_subunits\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Cost Rate has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"cost_rates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CostRate\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Cost Rate\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-cost-rate\",\"tags\":[\"Cost Rates\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Cost Rate has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/currencies\":{\"get\":{\"summary\":\"Get a list of currencies\",\"description\":\"Returns all currencies supported by Kantata OX, unless filter parameters have been applied.\",\"operationId\":\"get-currencies\",\"tags\":[\"Currencies\"],\"parameters\":[{\"in\":\"query\",\"name\":\"addable_to_rate_card_set_version\",\"required\":false,\"description\":\"Filters for currencies that can be added to the rate card associated with the specified\\n[Rate Card Set Version](/tag/Rate-Card-Set-Version-(Effective-version-by-Date)) ID.\\nIf the associated rate card **is** the account default, all currencies supported by Kantata OX are returned.\\n\\nIf the associated rate card is **not** set as the account default, results are additionally limited\\nto currencies on the account default rate card.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"matching\",\"required\":false,\"description\":\"Filters for currencies that approximately match the specified value. Valid values are [ISO\\ncodes, names, or symbols of currencies supported by Kantata OX](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473).\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"iso_code\":{\"type\":\"string\",\"description\":\"ISO alphabetic code (for example, `USD`).\"},\"name\":{\"type\":\"string\",\"description\":\"Name of currency (for example, `United States Dollar`).\"},\"symbol\":{\"type\":\"string\",\"description\":\"Symbol associated with currency (for example, `$`).\"},\"subunit_to_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of subunits in one unit for currency.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/custom_branding\":{\"get\":{\"summary\":\"Fetch Custom Branding Settings\",\"description\":\"Retrieve custom branding information for the current user's account.\\n\\n\\nThis endpoint returns structured Custom Branding (Private Label) objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `private_label` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-custom-branding-settings\",\"tags\":[\"Custom Branding\"],\"parameters\":[{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Custom Branding (Private Label)s have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"private_label\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/PrivateLabel\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/custom_field_choices\":{\"get\":{\"summary\":\"Fetching a list of Custom Field Choices\",\"description\":\"Returns all possible choices for all `'single'` and `'multi'` type custom fields on the requester's account.\\n\\nThis endpoint returns structured Custom Field Choice objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_choices` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-custom-field-choices\",\"tags\":[\"Custom Field Choices\"],\"parameters\":[{\"in\":\"query\",\"name\":\"active\",\"description\":\"Only return non-obsolete custom field choices.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"for_choice_ids\",\"description\":\"Only return custom field choices for these specific custom field choice ids formatted '1,2,...'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"for_custom_fields\",\"description\":\"Only return custom field choices for these specific custom field ids formatted '1,2,...'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field` (CustomField)\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Includes custom field choices with a name that matches the search string.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `label:asc`, `label:desc`, `position:asc`, and `position:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"position:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_custom_field\",\"description\":\"Evenly distribute the choices fetched by their custom_field_id in groups the size of the number specified.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Custom Field Choices have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/custom_field_sets\":{\"get\":{\"summary\":\"Fetching a list of Custom Field Sets\",\"description\":\"This endpoint returns structured Custom Field Set objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_sets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-custom-field-sets\",\"tags\":[\"Custom Field Sets\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_fields` (CustomField) - The custom fields that belonging to the custom field set.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc`, `alphabetical:desc`, `created_at:asc`, and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_subject_type\",\"description\":\"Set by a specific subject type: Workspace, Story, User or WorkspaceGroup.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Custom Field Sets have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Custom Field Set\",\"description\":\"To create a custom field, the current user must be the Account Administrator.\\n\\nThis endpoint returns structured Custom Field Set objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_sets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-custom-field-set\",\"tags\":[\"Custom Field Sets\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_fields` (CustomField) - The custom fields that belonging to the custom field set.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"custom_field_set\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the custom field set.\"},\"subject_type\":{\"type\":\"string\",\"description\":\"The type of objects contained by the custom field set. The supported subjects\\nare currently Workspace, Story, User, and WorkspaceGroup.\"}},\"required\":[\"name\",\"subject_type\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Custom Field Set has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/custom_field_sets/{id}\":{\"get\":{\"summary\":\"Fetching a single Custom Field Set\",\"description\":\"This endpoint returns structured Custom Field Set objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_sets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-custom-field-set\",\"tags\":[\"Custom Field Sets\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_fields` (CustomField) - The custom fields that belonging to the custom field set.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Custom Field Set has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Custom Field Set\",\"description\":\"To update a custom field, the current user must be the Account Administrator.\\n\\nNOTE: `subject_type` cannot be changed.\\n\\n\\nThis endpoint returns structured Custom Field Set objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_sets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-custom-field-set\",\"tags\":[\"Custom Field Sets\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_fields` (CustomField) - The custom fields that belonging to the custom field set.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"custom_field_set\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the custom field set.\"},\"subject_type\":{\"type\":\"string\",\"description\":\"Subject type cannot be changed.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Custom Field Set has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Custom Field Set\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-custom-field-set\",\"tags\":[\"Custom Field Sets\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Custom Field Set has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/custom_field_values\":{\"get\":{\"summary\":\"Fetching a list of Custom Field Values\",\"description\":\"Returns all values for the specified set of\\n[Custom Fields](https://mavenlink.zendesk.com/hc/en-us/articles/202924760-Custom-Fields-Overview-#arrange).\\n\\nThis endpoint has its own rate limit. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for more information.\\n\\nCustom fields are organized into [sets](/tag/Custom-Field-Sets),\\nby the objects they store additional information for (Estimate, Project, Group, Resource, Task, or User).\\nUse the `subject_type` parameter to specify which set of Custom Fields to return values for:\\n* `Estimate`\\n* `Story` (Task)\\n* `User`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n\\nCustom field values for _archived_ Projects and Tasks are included in returned values.\\nValues are sorted from less to more recently updated.\\n\\n##### Note:\\nThe `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n  - `project_collaboration` (default)\\n  - `time_logging`\\n  - `financial`\\n  - `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects, so their minimum permissions are\\nset at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n  - `account_collaboration`\\n  - `project_creator`\\n  - `project_lead`\\n  - `reports_viewer`\\n  - `reports_viewer_with_cost`\\n  - `account_admin` (default)\\n\\n\\nThis endpoint returns structured Custom Field Value objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_values` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-custom-field-values\",\"tags\":[\"Custom Field Values\"],\"parameters\":[{\"in\":\"query\",\"name\":\"subject_type\",\"required\":true,\"description\":\"You must specify which set of Custom Fields to return values for:\\n* `Estimate`\\n* `Story` (Task)\\n* `User`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n\\nThis parameter is required.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field` (CustomField) - Retrieves the custom field the value is for. The response will include `custom_field_id`, which references the data in the `custom_fields` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `selected_choices` (CustomFieldChoice) - Retrieves the custom field choice that corresponds to the custom field value. The response will include `selected_choice_ids`, which references the data in the `custom_field_choices` top-level key.\\n- `setter` (User) - Retrieves the user that set the custom field value. The response will include `setter_id`, which references the data in the `users` top-level key.\\n- `subject` (polymorphic) - Retrieves the object which the custom field value is for. The response will include `subject_ref`, which references the data in the top-level key specified in the `key` field of `subject_ref`. The possible objects are as follows:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `subject_id:asc`, `subject_id:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_custom_field_id\",\"description\":\"Filters for values of the Custom Field(s) with the specified ID(s). Give multiple Custom Field IDs in a comma-separated list.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"with_setter_id\",\"description\":\"Filters for Custom Field Values set by a user with the specified ID(s). Give multiple user IDs in a comma-separated list.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"with_subject_id\",\"description\":\"Filters for Custom Field Values associated with the specified ID(s) of an Estimate, Project,\\n             Group, Resource, Task, or User. Give multiple IDs in a comma-separated list.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Custom Field Values have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Custom Field Value\",\"description\":\"Creates a new value for the specified custom field. Creating a value can also override existing values,\\neffectively making this an update request as well. Up to 100 values can be created at one time.\\n\\nWhen creating new [single or multi choice values](/tag/Custom-Field-Choices) that\\noverride existing values, note that new values are not _added_ to existing values, but instead _replace_ existing values.\\nAdditionally, every new value has a unique, new ID.\\n\\nThis endpoint has its own rate limit. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for more information.\\n\\n\\nThis endpoint returns structured Custom Field Value objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_values` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-custom-field-value\",\"tags\":[\"Custom Field Values\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field` (CustomField) - Retrieves the custom field the value is for. The response will include `custom_field_id`, which references the data in the `custom_fields` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `selected_choices` (CustomFieldChoice) - Retrieves the custom field choice that corresponds to the custom field value. The response will include `selected_choice_ids`, which references the data in the `custom_field_choices` top-level key.\\n- `setter` (User) - Retrieves the user that set the custom field value. The response will include `setter_id`, which references the data in the `users` top-level key.\\n- `subject` (polymorphic) - Retrieves the object which the custom field value is for. The response will include `subject_ref`, which references the data in the top-level key specified in the `key` field of `subject_ref`. The possible objects are as follows:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"custom_field_value\":{\"type\":\"object\",\"properties\":{\"subject_type\":{\"type\":\"string\",\"description\":\"You must specify which set of Custom Fields to return values for:\\n* `Estimate`\\n* `Story` (Task)\\n* `User`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n\\nThis parameter is required.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Estimate, Project, Group, Resource, Task, or User the custom field is for.\"},\"custom_field_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Custom Field to create or update the value for.\"},\"value\":{\"type\":\"string\",\"description\":\"The value to create or update to for the specified custom field.\\n\\nValues can be created or updated in these formats:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\n##### Note:\\nThe `write_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to edit the value of each custom field.\\n* Editing `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific changes,\\nso permissions are set at the project level:\\n- `project_collaboration`\\n- `time_logging`\\n- `financial`\\n- `project_admin` (default)\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to edit all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `write_access` settings.\\n* Editing `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide changes,\\nso permissions are set at the account level:\\n- `account_collaboration`\\n- `project_creator`\\n- `project_lead`\\n- `reports_viewer`\\n- `reports_viewer_with_cost`\\n- `account_admin` (default).\"}},\"required\":[\"subject_type\",\"subject_id\",\"custom_field_id\",\"value\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Custom Field Value has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Delete multiple custom field values\",\"description\":\"The IDs of the custom field values to delete can be provided in the `ids` query parameter or via the request body.\\n\\nRequest body example:\\n```{\\n  \\\"ids\\\": \\\"1,2,3\\\"\\n}```\\n\\nIf any specified custom field values cannot be deleted, the entire request will fail and an error message\\nwill be returned that specifies which ones could not be deleted and why.\\n\\n\\nThis endpoint returns structured Custom Field Value objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_values` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"delete-custom-field-values\",\"tags\":[\"Custom Field Values\"],\"parameters\":[{\"in\":\"query\",\"name\":\"ids\",\"required\":false,\"description\":\"A comma-separated list of IDs of custom field values. You can provide up to 100 IDs. The IDs can be\\nprovided in this query parameter or via the request body.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"204\":{\"description\":\"Custom Field Value has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/custom_field_values/{id}\":{\"get\":{\"summary\":\"Fetching a single Custom Field Value\",\"description\":\"This endpoint returns structured Custom Field Value objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_values` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-custom-field-value\",\"tags\":[\"Custom Field Values\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field` (CustomField) - Retrieves the custom field the value is for. The response will include `custom_field_id`, which references the data in the `custom_fields` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `selected_choices` (CustomFieldChoice) - Retrieves the custom field choice that corresponds to the custom field value. The response will include `selected_choice_ids`, which references the data in the `custom_field_choices` top-level key.\\n- `setter` (User) - Retrieves the user that set the custom field value. The response will include `setter_id`, which references the data in the `users` top-level key.\\n- `subject` (polymorphic) - Retrieves the object which the custom field value is for. The response will include `subject_ref`, which references the data in the top-level key specified in the `key` field of `subject_ref`. The possible objects are as follows:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Custom Field Value has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Custom Field Value\",\"description\":\"Updates an existing value for the specified custom field. Up to 100 values can be updated at one time.\\n\\n\\nThis endpoint returns structured Custom Field Value objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_field_values` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-custom-field-value\",\"tags\":[\"Custom Field Values\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field` (CustomField) - Retrieves the custom field the value is for. The response will include `custom_field_id`, which references the data in the `custom_fields` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `selected_choices` (CustomFieldChoice) - Retrieves the custom field choice that corresponds to the custom field value. The response will include `selected_choice_ids`, which references the data in the `custom_field_choices` top-level key.\\n- `setter` (User) - Retrieves the user that set the custom field value. The response will include `setter_id`, which references the data in the `users` top-level key.\\n- `subject` (polymorphic) - Retrieves the object which the custom field value is for. The response will include `subject_ref`, which references the data in the top-level key specified in the `key` field of `subject_ref`. The possible objects are as follows:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"custom_field_value\":{\"type\":\"object\",\"properties\":{\"value\":{\"type\":\"string\",\"description\":\"The new value that replaces the existing value for the specified custom field.\\n\\nThese value types are updated in the following formats:\\n\\n  | Value Type           | Format                                   | Sample         |\\n  | -------------------- |:----------------------------------------:| --------------:|\\n  | `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n  | `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n  | `number`             | `<integer_value>`                        |           `13` |\\n  | `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n  | `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\nFor [single or multi choice](/tag/Custom-Field-Choices) Custom Fields,\\nyou can think of selected choice(s) as a list, even with only 1 selected choice. The list of values in your\\nrequest becomes the new list of selected choices. And the new choices all have new, unique choice IDs.\\n\\n##### Note:\\nThe `write_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to edit the value of each custom field.\\n* Editing `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific changes,\\nso permissions are set at the project level:\\n- `project_collaboration`\\n- `time_logging`\\n- `financial`\\n- `project_admin` (default)\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to edit all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `write_access` settings.\\n* Editing `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide changes,\\nso permissions are set at the account level:\\n- `account_collaboration`\\n- `project_creator`\\n- `project_lead`\\n- `reports_viewer`\\n- `reports_viewer_with_cost`\\n- `account_admin` (default).\"}},\"required\":[\"value\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Custom Field Value has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Custom Field Value\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-custom-field-value\",\"tags\":[\"Custom Field Values\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Custom Field Value has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/custom_fields\":{\"get\":{\"summary\":\"Fetching a list of Custom Fields\",\"description\":\"Returns all Custom Fields, unless filter parameters have been applied.\\n\\nThis endpoint returns structured Custom Field objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_fields` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-custom-fields\",\"tags\":[\"Custom Fields\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (CustomFieldChoice) - Includes the ID of a Custom Field's choices.\\n- `creator` (User) - Includes the ID of a Custom Field's creator.\\n- `custom_field_set` (CustomFieldSet) - Includes the ID of the Custom Field Set that a field belongs to.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Filter by custom fields with a name similar to the specified string.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `name:asc`, `name:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"name:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"subject_type\",\"description\":\"Filters for the specified set of Custom Fields:\\n* `Estimate`\\n* `Story` (Task)\\n* `User`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Custom Fields have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Custom Field\",\"description\":\"This endpoint returns structured Custom Field objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_fields` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-custom-field\",\"tags\":[\"Custom Fields\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (CustomFieldChoice) - Includes the ID of a Custom Field's choices.\\n- `creator` (User) - Includes the ID of a Custom Field's creator.\\n- `custom_field_set` (CustomFieldSet) - Includes the ID of the Custom Field Set that a field belongs to.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"custom_field\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the new field.\"},\"value_type\":{\"type\":\"string\",\"description\":\"The format of the [custom field's value](/tag/Custom-Field-Values):\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\nThis is set to `string` by default.\"},\"default_text\":{\"type\":\"string\",\"description\":\"The message in an empty custom field, before a `string`, `date`, `number`, or `currency`  value is entered in.\\nThis only appears in the UI.\"},\"unique_constraint\":{\"type\":\"boolean\",\"description\":\"A boolean setting that requires a custom field value to be unique across Estimates, Projects, Groups,\\nResources, Tasks, or Users.\\n\\nThis is set to `false` by default.\"},\"choices\":{\"type\":\"array\",\"description\":\"The list of [choices](/tag/Custom-Field-Choices) a user can select from\\nfor a custom field's value(s). A choice has two attributes, a `label` and an `ID`. Different choices can have the\\nsame `label`, but every choice will have a unique `ID`.\\n\\nFor example, a request:\\n\\n```\\ncustom_field_choices: {\\n  ....\\n  choices: [\\n    { \\\"label\\\": \\\"Choice A\\\" },\\n    { \\\"label\\\": \\\"Choice B\\\" },\\n    { \\\"label\\\": \\\"Choice B\\\" },\\n    { \\\"label\\\": \\\"Choice B\\\" }\\n  ]\\n  ....\\n}\\n\\nWill have a response like:\\n\\n```\\ncustom_field_choices: {\\n  ....\\n  choices: [\\n    { \\\"label\\\": \\\"Choice A\\\", \\\"id\\\": \\\"180291\\\" },\\n    { \\\"label\\\": \\\"Choice B\\\", \\\"id\\\": \\\"180301\\\" },\\n    { \\\"label\\\": \\\"Choice B\\\", \\\"id\\\": \\\"180311\\\" },\\n    { \\\"label\\\": \\\"Choice B\\\", \\\"id\\\": \\\"180321\\\" }\\n  ]\\n  ....\\n}\\n```\\n\\nChoices in the UI appear in the same order as listed in the array.\\n\\nNote that the 2nd, 3rd, and 4th choices all have the same label, but different IDs.\",\"items\":{\"type\":\"object\",\"properties\":{\"label\":{\"type\":\"string\",\"description\":\"You can think of a label as the actual value a user can select for the custom field.\\n\\n*Note:* Different choices can have the same `label`.\"}}}},\"custom_field_set_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [Custom Field Set](/tag/Custom-Field-Sets) that the field belongs to.\\nWhen a set ID is not specified, the field is added to a Project set titled 'Default Project Set'.\\nThis means it becomes a Project field.\"},\"write_access\":{\"type\":\"string\",\"description\":\"The permission level required for a user to create, update, or delete a custom field's value.\"},\"read_access\":{\"type\":\"string\",\"description\":\"The `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n  - `project_collaboration` (default)\\n  - `time_logging`\\n  - `financial`\\n  - `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators are able to view\\nall Project, Resource, and Task custom fields and values across the account, regardless of project participation or\\n`read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects, so their minimum permissions\\nare set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n  - `account_collaboration`\\n  - `project_creator`\\n  - `project_lead`\\n  - `reports_viewer`\\n  - `reports_viewer_with_cost`\\n  - `account_admin` (default).\"}},\"required\":[\"name\",\"value_type\",\"custom_field_set_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Custom Field has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/custom_fields/{id}\":{\"put\":{\"summary\":\"Updating an existing Custom Field\",\"description\":\"Updates an existing custom field. \\n\\n### Parameters that cannot be updated\\nNote that the `unique_constraint` and `value_type` parameters cannot be updated.\\nThey are set during the process of [creating a custom field](/tag/Custom-Fields#operation/create-custom-field).\\n\\n### Updating choices\\nThis endpoint also allows you to update the list of choices for a custom field with\\n[single or multiple choices](/tag/Custom-Field-Choices). For important details\\nregarding how this endpoint affects the list of available choices and how to avoid\\ncreating duplicate choices, see the description of the `choice` body parameter.\\n\\n\\nThis endpoint returns structured Custom Field objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `custom_fields` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-custom-field\",\"tags\":[\"Custom Fields\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (CustomFieldChoice) - Includes the ID of a Custom Field's choices.\\n- `creator` (User) - Includes the ID of a Custom Field's creator.\\n- `custom_field_set` (CustomFieldSet) - Includes the ID of the Custom Field Set that a field belongs to.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"custom_field\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the field.\"},\"default_text\":{\"type\":\"string\",\"description\":\"The message in an empty custom field, before a `string`, `date`, `number`, or `currency`  value is entered in.\\nThis only appears in the UI.\"},\"choices\":{\"type\":\"array\",\"description\":\"The list of [choices](/tag/Custom-Field-Choices) a user can select from,\\nfor a custom field's value(s). Setting this field updates a custom field's \\ncomplete list of choices; it behaves as an overwrite.\\n**Include all existing choices in your request, whether you are updating their `label` or not.**\\nAny choices not included in your request *will be deleted* from the custom field.\\n\\n**How to avoid creating duplicate choices**\\n\\nChoices have two attributes, a `label` and an `ID`. Different choices can have the same `label`,\\nbut every choice has a unique `ID`. To properly update an existing choice within a list, you must specify the `ID`\\nof the choice you want to change. If you do not, a new choice with a unique, new `ID` is created instead.\\n\\nFor example:\\n\\n```\\ncustom_field_choices: {\\n  ....\\n  choices: [\\n    { \\\"label\\\": \\\"Choice A\\\", \\\"id\\\": \\\"180291\\\" },\\n    { \\\"label\\\": \\\"Choice B\\\", \\\"id\\\": \\\"180301\\\" },\\n    { \\\"label\\\": \\\"Choice C\\\" }\\n  ]\\n  ....\\n}\\n```\\n\\nChoices in the UI appear in the same order as listed in the array.\\n\\nThe 1st choice is an existing choice with an ID of `180291`, and is either staying or being updated to `Choice A`.\\nThe 2nd choice is an existing choice with an ID of `180301`, and is either staying or being updated to `Choice B`.\\nThe 3rd choice is a new choice to create, `Choice C`, and its unique ID will be returned in the response.\",\"items\":{\"type\":\"object\",\"properties\":{\"label\":{\"type\":\"string\",\"description\":\"You can think of a label as the actual value a user can select for the custom field.\\n\\n*Note:* Different choices can have the same `label`.\"},\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The unique ID of an existing choice(s). If you do not specify the `ID` of an existing choice in an update request,\\na new choice with a unique, new `ID` is generated instead. Use this parameter to avoid replacing\\nexisting choices with new ones.\"}}}},\"custom_field_set_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [Custom Field Set](/tag/Custom-Field-Sets) that the field belongs to.\\nWhen a set ID is not specified, the field is added to a Project set titled 'Default Project Set'.\\nThis means it becomes a Project field.\"},\"write_access\":{\"type\":\"string\",\"description\":\"The permission level required for a user to create, update, or delete a custom field value for a subject.\"},\"read_access\":{\"type\":\"string\",\"description\":\"The `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n  - `project_collaboration` (default)\\n  - `time_logging`\\n  - `financial`\\n  - `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n  - `account_collaboration`\\n  - `project_creator`\\n  - `project_lead`\\n  - `reports_viewer`\\n  - `reports_viewer_with_cost`\\n  - `account_admin` (default).\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Custom Field has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Custom Field\",\"description\":\"Deletes a custom field. Custom field values are deleted with their custom fields.\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-custom-field\",\"tags\":[\"Custom Fields\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Custom Field has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/estimate_scenario_resource_allocations/{id}\":{\"put\":{\"summary\":\"Updating an existing Estimate Scenario Resource Allocation\",\"description\":\"This endpoint returns structured Estimate Scenario Resource Allocation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenario_resource_allocations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-estimate-scenario-resource-allocation\",\"tags\":[\"Estimate Scenario Resource Allocations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `resource` (EstimateScenarioResource) - The scenario resource that owns the estimate scenario resource allocation.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"estimate_scenario_resource_allocation\":{\"type\":\"object\",\"properties\":{\"duration_days\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The length of time for the allocation (in days).\"},\"percent_allocated\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The percentage allocated. This must be a decimal number between (and including) 0 and 1.\"},\"relative_start_day\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of business days, after the start date of the project, that the resource\\nwill begin working on the project.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Estimate Scenario Resource Allocation has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenario_resource_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResourceAllocation\"}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/estimate_scenario_resources\":{\"get\":{\"summary\":\"Fetching a list of Estimate Scenario Resources\",\"description\":\"This endpoint provides a list of all scenario resources associated with the specified estimate\\nscenario.\\n\\n\\nThis endpoint returns structured Estimate Scenario Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenario_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-estimate-scenario-resources\",\"tags\":[\"Estimate Scenario Resources\"],\"parameters\":[{\"in\":\"query\",\"name\":\"estimate_scenario_id\",\"required\":true,\"description\":\"Required to retrieve the resources for a specified estimate scenario.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `allocation` (EstimateScenarioResourceAllocation) - The Estimate Scenario Resource Allocation of the Estimate Scenario Resource.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `geography` (Geography) - The Geography of the Estimate Scenario Resource.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `role` (Role)\\n- `user` (User).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetically:asc`, `alphabetically:desc`, `created_at:asc`, `created_at:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Estimate Scenario Resources have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"estimate_scenario_resource_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResourceAllocation\"}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Geography\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Estimate Scenario Resource\",\"description\":\"This endpoint returns structured Estimate Scenario Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenario_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-estimate-scenario-resource\",\"tags\":[\"Estimate Scenario Resources\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `allocation` (EstimateScenarioResourceAllocation) - The Estimate Scenario Resource Allocation of the Estimate Scenario Resource.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `geography` (Geography) - The Geography of the Estimate Scenario Resource.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `role` (Role)\\n- `user` (User).\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"estimate_scenario_resource\":{\"type\":\"object\",\"properties\":{\"estimate_scenario_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimate scenario to which the resource is attached.\"},\"label\":{\"type\":\"string\",\"description\":\"The name of the resource. An auto-generated label will be supplied if not present.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The role with which the resource will be associated.\"},\"allocation_attributes\":{\"type\":\"object\",\"properties\":{\"duration_days\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of business days a resource is expected to work on the project.\"},\"percent_allocated\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The percentage of available hours the resource will work on the project.\"},\"relative_start_day\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The zero-based day that a scenario resource is expected to start working on the project, relative\\nto the start date of the estimate scenario.\"}}},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"estimate_scenario_id\",\"role_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Estimate Scenario Resource has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"estimate_scenario_resource_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResourceAllocation\"}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Geography\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/estimate_scenario_resources/{id}\":{\"get\":{\"summary\":\"Fetching a single Estimate Scenario Resource\",\"description\":\"This endpoint returns structured Estimate Scenario Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenario_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-estimate-scenario-resource\",\"tags\":[\"Estimate Scenario Resources\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `allocation` (EstimateScenarioResourceAllocation) - The Estimate Scenario Resource Allocation of the Estimate Scenario Resource.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `geography` (Geography) - The Geography of the Estimate Scenario Resource.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `role` (Role)\\n- `user` (User).\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Estimate Scenario Resource has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"estimate_scenario_resource_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResourceAllocation\"}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Geography\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Estimate Scenario Resource\",\"description\":\"This endpoint returns structured Estimate Scenario Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenario_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-estimate-scenario-resource\",\"tags\":[\"Estimate Scenario Resources\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `allocation` (EstimateScenarioResourceAllocation) - The Estimate Scenario Resource Allocation of the Estimate Scenario Resource.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `geography` (Geography) - The Geography of the Estimate Scenario Resource.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `role` (Role)\\n- `user` (User).\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"estimate_scenario_resource\":{\"type\":\"object\",\"properties\":{\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The role with which the resource will be associated.\"},\"label\":{\"type\":\"string\",\"description\":\"The name of the resource.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"role_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Estimate Scenario Resource has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"estimate_scenario_resource_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResourceAllocation\"}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Geography\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Estimate Scenario Resource\",\"description\":\"This will delete an estimate scenario resource and its allocations.\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-estimate-scenario-resource\",\"tags\":[\"Estimate Scenario Resources\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Estimate Scenario Resource has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/estimate_scenarios\":{\"get\":{\"summary\":\"Fetching a list of Estimate Scenarios\",\"description\":\"This endpoint returns structured Estimate Scenario objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenarios` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-estimate-scenarios\",\"tags\":[\"Estimate Scenarios\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `estimate_scenario_resources` (EstimateScenarioResource) - The Estimate Scenario Resources of the Estimate Scenario.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card` (RateCard) - The rate card being used for the estimate scenario.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `name:asc` and `name:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"name\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Estimate Scenarios have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Estimate Scenario\",\"description\":\"This endpoint returns structured Estimate Scenario objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenarios` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-estimate-scenario\",\"tags\":[\"Estimate Scenarios\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `estimate_scenario_resources` (EstimateScenarioResource) - The Estimate Scenario Resources of the Estimate Scenario.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card` (RateCard) - The rate card being used for the estimate scenario.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"estimate_scenario\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the scenario (must be a unique name within it's estimate).\"},\"estimate_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the estimate that is associated with the scenario.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The planned start date of the project. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"budget_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The planned budget for the scenario.\"},\"rate_card_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate card being used to calculate the resources' rates. If this is not provided,\\na rate card with the same currency as the estimate will be selected from the\\naccount default rate cards.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"name\",\"estimate_id\",\"start_date\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Estimate Scenario has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/estimate_scenarios/{id}\":{\"get\":{\"summary\":\"Fetching a single Estimate Scenario\",\"description\":\"This endpoint returns structured Estimate Scenario objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenarios` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-estimate-scenario\",\"tags\":[\"Estimate Scenarios\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `estimate_scenario_resources` (EstimateScenarioResource) - The Estimate Scenario Resources of the Estimate Scenario.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card` (RateCard) - The rate card being used for the estimate scenario.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Estimate Scenario has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Estimate Scenario\",\"description\":\"This endpoint returns structured Estimate Scenario objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimate_scenarios` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-estimate-scenario\",\"tags\":[\"Estimate Scenarios\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `estimate_scenario_resources` (EstimateScenarioResource) - The Estimate Scenario Resources of the Estimate Scenario.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card` (RateCard) - The rate card being used for the estimate scenario.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"estimate_scenario\":{\"type\":\"object\",\"properties\":{\"budget_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The planned budget for the scenario.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the scenario (must be a unique name within it's estimate).\"},\"rate_card_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate card being used to calculate the resources' rates.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The planned start date of the project. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Estimate Scenario has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Estimate Scenario\",\"description\":\"Deletes an estimate scenario, including all of its resources and their allocations.\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-estimate-scenario\",\"tags\":[\"Estimate Scenarios\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Estimate Scenario has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/estimates\":{\"get\":{\"summary\":\"Fetching a list of Estimates\",\"description\":\"This endpoint returns structured Estimate objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-estimates\",\"tags\":[\"Estimates\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_custom_choice_value\",\"description\":\"Filter by a custom field choice value, represented as a string with the custom field ID, followed by a\\ncolon, and then comma-separated custom field choice value IDs. The custom field choice value can also be\\nthe word `blank`. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\n\\nThe following formats are supported:\\n\\n- `custom_field_ID:choice_value_ID`\\n- `custom_field_ID:choice_value_1_ID,choice_value_2_ID`\\n- `custom_field_ID:blank`\\n- `(custom_field_1_ID:choice_value_1_ID,choice_value_2_ID):(custom_field_2_ID:choice_value_3_ID)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_currency_value\",\"description\":\"Filter by a custom field currency value, represented as a string with the custom field ID, followed by a\\ncolon, and then the currency value. Optionally, the currency [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473) can be supplied as well, separated\\nfrom the currency value by another colon. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200.2:USD):(2:100)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_date_value\",\"description\":\"Filter by a custom field date value, represented as a string with the custom field ID, followed by a\\ncolon, the starting date, another colon, and then the ending date. You can provide both a starting date\\nand ending date, or provide just one. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:2014-12-05:2014-12-25):(2:2014-12-05)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_number_value\",\"description\":\"Filter by a custom field number value, represented as a string with the custom field ID, followed by a\\ncolon, and then the number value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200):(2:101)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_text_value\",\"description\":\"Filter by a custom field text value, represented as a string with the custom field ID, followed by a\\ncolon, and then the text value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:something):(2:else)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"creator\",\"description\":\"Only includes estimates in which the specified set IDs belong to the creator of the estimates. For example, '10,20'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"has_value_for_custom_field_ids\",\"description\":\"Filter by the presence of a custom field value for the specified comma-separated custom field ID(s).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created the estimate.\\n- `custom_field_values` (CustomFieldValue) - The value set on estimate custom fields.\\n- `estimate_scenarios` (EstimateScenario) - The EstimateScenarios of the estimate.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `workspace` (Workspace) - The Workspace that was created from the Project.\\n- `workspace_group` (WorkspaceGroup) - The WorkspaceGroup (client) of the estimate.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `name:asc`, and `name:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"name\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_workspace_group_ids\",\"description\":\"Only includes estimates for the specified workspace group IDs. For example, '1,2,3'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Estimates have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Estimate\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Estimate\",\"description\":\"This endpoint returns structured Estimate objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-estimate\",\"tags\":[\"Estimates\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created the estimate.\\n- `custom_field_values` (CustomFieldValue) - The value set on estimate custom fields.\\n- `estimate_scenarios` (EstimateScenario) - The EstimateScenarios of the estimate.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `workspace` (Workspace) - The Workspace that was created from the Project.\\n- `workspace_group` (WorkspaceGroup) - The WorkspaceGroup (client) of the estimate.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"estimate\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the estimate.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the estimate, by code (for example, 'AUD' or 'USD').\"},\"workspace_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the workspace group (client) of the estimate.\"},\"estimate_scenario\":{\"type\":\"object\",\"description\":\"The estimated budget, start date, and rate card associated with the estimate.\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the scenario (must be unique within it's estimate).\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The planned start date of the project. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"budget_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The planned budget for this scenario.\"},\"rate_card_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate card being used to calculate the resources' rates.\"}},\"required\":[\"name\",\"start_date\"]},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"name\",\"currency\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Estimate has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Estimate\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/estimates/{id}\":{\"get\":{\"summary\":\"Fetching a single Estimate\",\"description\":\"This endpoint returns structured Estimate objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-estimate\",\"tags\":[\"Estimates\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created the estimate.\\n- `custom_field_values` (CustomFieldValue) - The value set on estimate custom fields.\\n- `estimate_scenarios` (EstimateScenario) - The EstimateScenarios of the estimate.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `workspace` (Workspace) - The Workspace that was created from the Project.\\n- `workspace_group` (WorkspaceGroup) - The WorkspaceGroup (client) of the estimate.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Estimate has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Estimate\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Estimate\",\"description\":\"This endpoint returns structured Estimate objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `estimates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-estimate\",\"tags\":[\"Estimates\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created the estimate.\\n- `custom_field_values` (CustomFieldValue) - The value set on estimate custom fields.\\n- `estimate_scenarios` (EstimateScenario) - The EstimateScenarios of the estimate.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `workspace` (Workspace) - The Workspace that was created from the Project.\\n- `workspace_group` (WorkspaceGroup) - The WorkspaceGroup (client) of the estimate.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"estimate\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the Estimate.\"},\"workspace_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The Client the Estimate is created for.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the estimate.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Estimate has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"estimates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Estimate\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Estimate\",\"description\":\"Deletes the estimate and it's associated scenarios, scenario resources,\\nand scenario resource allocations.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-estimate\",\"tags\":[\"Estimates\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Estimate has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_budgets\":{\"get\":{\"summary\":\"Fetching a list of Expense Budgets\",\"description\":\"Gets a list of expense budgets.\\n\\nThis endpoint returns structured Expense Budgets objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_budgets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-expense-budgets\",\"tags\":[\"Expense Budgets\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `expenses` (Expense) - The expenses associated with the expense budget.\\n- `fixed_fee_items` (FixedFeeItem) - The fixed fee items associated with the expense budget.\\n- `story` (Story) - Retrieves the associated story (task). The response will include `story_id`, which references the data in the `stories` top-level key.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the expense budget is on. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter by workspace ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Expense Budgets have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_budgets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseBudget\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Expense Budgets\",\"description\":\"Creates a new expense budget.\\nThe following combinations of `fixed_fee`, `burns_budget`, and `billable` are allowed:\\n- `fixed_fee` and `burns_budget` and `billable`: Known as a fixed fee budget\\n- `burns_budget` and `billable`: Known as an itemized budget\\n- `burns_budget` only: Known as a cost-only budget\\n- `billable` only: Known as a pass-through budget\\n- `fixed_fee` and `billable`: Known as a pass-through fixed fee budget\\n\\n\\nThis endpoint returns structured Expense Budgets objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_budgets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-expense-budget\",\"tags\":[\"Expense Budgets\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `expenses` (Expense) - The expenses associated with the expense budget.\\n- `fixed_fee_items` (FixedFeeItem) - The fixed fee items associated with the expense budget.\\n- `story` (Story) - Retrieves the associated story (task). The response will include `story_id`, which references the data in the `stories` top-level key.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the expense budget is on. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"expense_budget\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the workspace to create the expense budget for.\"},\"title\":{\"type\":\"string\",\"description\":\"The name of the expense budget.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the expense budget.\"},\"fixed_fee\":{\"type\":\"boolean\",\"description\":\"Whether the expense will be billed as a fixed cost.\"},\"burns_budget\":{\"type\":\"boolean\",\"description\":\"Whether the expense budget affects the project margin.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"Whether the expense will be billed to the client.\"},\"expected_by\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the expenses are expected to be logged by. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the story (task) to associate this expense budget to.\"},\"cost_per_unit_in_subunits\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost, in the subunits of the currency (e.g. cents for USD).\"}},\"required\":[\"workspace_id\",\"title\",\"fixed_fee\",\"burns_budget\",\"billable\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Expense Budgets has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_budgets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseBudget\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_budgets/{id}\":{\"get\":{\"summary\":\"Fetching a single Expense Budgets\",\"description\":\"Gets a single expense budget.\\n\\nThis endpoint returns structured Expense Budgets objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_budgets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-expense-budget\",\"tags\":[\"Expense Budgets\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `expenses` (Expense) - The expenses associated with the expense budget.\\n- `fixed_fee_items` (FixedFeeItem) - The fixed fee items associated with the expense budget.\\n- `story` (Story) - Retrieves the associated story (task). The response will include `story_id`, which references the data in the `stories` top-level key.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the expense budget is on. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"expense_budget\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\"}},\"required\":[\"id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"The Expense Budgets has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_budgets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseBudget\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Expense Budgets\",\"description\":\"Updates an expense budget.\\n\\nThis endpoint returns structured Expense Budgets objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_budgets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-expense-budget\",\"tags\":[\"Expense Budgets\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `expenses` (Expense) - The expenses associated with the expense budget.\\n- `fixed_fee_items` (FixedFeeItem) - The fixed fee items associated with the expense budget.\\n- `story` (Story) - Retrieves the associated story (task). The response will include `story_id`, which references the data in the `stories` top-level key.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the expense budget is on. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"expense_budget\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The name of the expense budget.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the expense budget.\"},\"fixed_fee\":{\"type\":\"boolean\",\"description\":\"Whether the expense will be billed as a fixed cost.\"},\"burns_budget\":{\"type\":\"boolean\",\"description\":\"Whether the expense budget affects the project margin.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"Whether the expense will be billed to the client.\"},\"expected_by\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the expenses are expected to be logged by. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the story (task) to associate this expense budget to.\"},\"cost_per_unit_in_subunits\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost, in the subunits of the currency (e.g. cents for USD).\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Expense Budgets has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_budgets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseBudget\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Expense Budgets\",\"description\":\"Deletes an expense budget. An expense budget cannot be deleted if there are expenses logged to it.\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-expense-budget\",\"tags\":[\"Expense Budgets\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Expense Budgets has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_categories\":{\"get\":{\"summary\":\"Fetching a list of Expense Categories\",\"description\":\"This endpoint returns structured Expense Category objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_categories` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-expense-categories\",\"tags\":[\"Expense Categories\"],\"parameters\":[{\"in\":\"query\",\"name\":\"matching\",\"description\":\"By expense category names that match the specified name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_active\",\"description\":\"Only include expense categories that have not been deleted (deleted_at is NULL).\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc` and `alphabetical:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"alphabetical:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Expense Categories have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseCategory\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Expense Category\",\"description\":\"This endpoint returns structured Expense Category objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_categories` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-expense-category\",\"tags\":[\"Expense Categories\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"expense_category\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the expense category.\"}},\"required\":[\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Expense Category has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseCategory\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_categories/{id}\":{\"put\":{\"summary\":\"Updating an existing Expense Category\",\"description\":\"This endpoint returns structured Expense Category objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_categories` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-expense-category\",\"tags\":[\"Expense Categories\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"expense_category\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the expense category.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Expense Category has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseCategory\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Expense Category\",\"description\":\"Deleting an expense category updates the `deleted_at` attribute to the current time. Deleted\\nexpense categories are not included by default in the index action and can be retrieved by setting\\n`only_active` filter as false.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-expense-category\",\"tags\":[\"Expense Categories\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Expense Category has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_report_submissions\":{\"get\":{\"summary\":\"Fetching a list of Expense Report Submissions\",\"description\":\"Returns expense report submissions for the logged in user by default. When `all_on_account` filter is set\\nto true, the endpoint returns all expense report submissions on the account visible to the user.\\n\\n\\nThis endpoint returns structured Expense Report Submission objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_report_submissions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-expense-report-submissions\",\"tags\":[\"Expense Report Submissions\"],\"parameters\":[{\"in\":\"query\",\"name\":\"active\",\"description\":\"Returns only active submissions.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"all_on_account\",\"required\":false,\"description\":\"Return expense report submissions on the account.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `expenses` (Expense) - Include expense line items with the expense report submission.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `resolutions` (Resolution) - Include the resolutions (approvals, rejections, or cancelations).\\n- `user` (User) - Includes user who owns the line items on the submission.\\n- `workspace` (Workspace) - Includes workspace to which the submission belongs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"not_cancelled\",\"description\":\"Returns only submissions that are not cancelled.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `amount:asc`, `amount:desc`, `created_at:asc`, `created_at:desc`, `date:asc`, `date:desc`, `status:asc`, `status:desc`, `title:asc`, `title:desc`, `workspace_title:asc`, and `workspace_title:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"statuses\",\"description\":\"Returns submissions with the statuses specified. Multiple statuses can be supplied in a comma separated list.\\nValid values: ‘new’, ‘cancelled’, ‘rejected’, and ‘approved’.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_ids\",\"description\":\"Only includes submissions associated with the specified user ids.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Ordered by the submission's workspace id.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"workspace_ids\",\"description\":\"Only includes submissions associated with the specified workspace ids.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Expense Report Submissions have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_report_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseReportSubmission\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Expense Report Submission\",\"description\":\"This endpoint returns structured Expense Report Submission objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_report_submissions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-expense-report-submission\",\"tags\":[\"Expense Report Submissions\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `expenses` (Expense) - Include expense line items with the expense report submission.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `resolutions` (Resolution) - Include the resolutions (approvals, rejections, or cancelations).\\n- `user` (User) - Includes user who owns the line items on the submission.\\n- `workspace` (Workspace) - Includes workspace to which the submission belongs.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"expense_report_submission\":{\"type\":\"object\",\"properties\":{\"line_item_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of expense ids of the expenses that will be included in the Expense Report Submission.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"This can be included when the Expense Report Submission is being submitted on behalf of another user.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the Expense Report Submission.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the workspace that will own the Expense Report Submission and its expenses.\"},\"comment\":{\"type\":\"string\",\"description\":\"Additional notes on the Expense Report Submission.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"line_item_ids\",\"title\",\"workspace_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Expense Report Submission has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_report_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseReportSubmission\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_report_submissions/{id}\":{\"get\":{\"summary\":\"Fetching a single Expense Report Submission\",\"description\":\"This endpoint returns structured Expense Report Submission objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expense_report_submissions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-expense-report-submission\",\"tags\":[\"Expense Report Submissions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `expenses` (Expense) - Include expense line items with the expense report submission.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `resolutions` (Resolution) - Include the resolutions (approvals, rejections, or cancelations).\\n- `user` (User) - Includes user who owns the line items on the submission.\\n- `workspace` (Workspace) - Includes workspace to which the submission belongs.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Expense Report Submission has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expense_report_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseReportSubmission\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_report_submissions/{id}/approve\":{\"put\":{\"summary\":\"Approve an Expense Report Submission\",\"description\":\"You can approve an Expense Report Submission by accessing the approve endpoint\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"approve-expense-report-submission\",\"tags\":[\"Expense Report Submissions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-expense-report-submissionBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_report_submissions/{id}/cancel\":{\"put\":{\"summary\":\"Cancel an Expense Report Submission\",\"description\":\"You can cancel an Expense Report Submission by accessing the cancel endpoint\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"cancel-expense-report-submission\",\"tags\":[\"Expense Report Submissions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-expense-report-submissionBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expense_report_submissions/{id}/reject\":{\"put\":{\"summary\":\"Reject an Expense Report Submission\",\"description\":\"You can reject an Expense Report Submission by accessing the reject endpoint\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"reject-expense-report-submission\",\"tags\":[\"Expense Report Submissions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-expense-report-submissionBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expenses\":{\"get\":{\"summary\":\"Fetching a list of Expenses\",\"description\":\"The expenses endpoint provides a list of every expense that the user making the request is allowed to see—\\nacross all projects to which the user belongs.\\n\\nThe response will contain an array of expense objects, sorted by the `date` attribute in descending order,\\navailable under the `expenses` key.\\n\\n\\nThis endpoint returns structured Expense objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expenses` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-expenses\",\"tags\":[\"Expenses\"],\"parameters\":[{\"in\":\"query\",\"name\":\"approved\",\"description\":\"Filter for expenses that are on approved expense reports, or on a workspace that does not require approvals.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_by\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"date_expensed_between\",\"description\":\"Filter for expenses between the start and end dates in a colon-separated YYYY-MM-DD format. For example, `2013-06-01:2013-08-01`. If a date is not specified, it is interpreted as no start/end date.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"from_archived_workspaces\",\"description\":\"Filter for expenses from archived projects.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"in_active_invoice_id\",\"description\":\"Limit results to time entries current in the specified active invoice.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_submission` (ExpenseReportSubmission)\\n- `expense_category` (ExpenseCategory) - The category associated with the expense.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `receipt` (Attachments::ReceiptAttachment) - Information about receipts associated with this expense, returned in the `attachments` top-level key.\\n- `recent_submission` (ExpenseReportSubmission) - The most recent expense report the expense was submitted in, including any rejected or cancelled reports.\\n- `role` (Role) - The role of the user.\\n- `story` (Story) - Linked task, returned in the `stories` top-level key.\\n- `user` (User) - The user who created the expense, returned in the `users` top-level key.\\n- `vendor` (Vendor) - The party to which the expense is payable.\\n- `workspace` (Workspace) - The project to which this expense belongs, returned in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"invoiced\",\"description\":\"Include expenses that have been invoiced.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"mine\",\"description\":\"Filter for expenses created by the user.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"on_my_account\",\"description\":\"Only include expenses that are on internal projects. On my account false will include internal and external expenses.\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"user_can_edit\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `amount:asc`, `amount:desc`, `category:asc`, `category:desc`, `created_at:asc`, `created_at:desc`, `date:asc`, `date:desc`, `notes:asc`, `notes:desc`, `vendor_name:asc`, and `vendor_name:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"date:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"reimbursable\",\"description\":\"Filter for expenses that are reimbursable based on the provided value.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"submitted\",\"description\":\"Filter for expenses that have been submitted.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"uninvoiced\",\"description\":\"Filter for expenses that have not been invoiced.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"unsubmitted\",\"description\":\"Filter for expenses that have not been submitted.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_expense_approvals\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"with_expense_report_id\",\"description\":\"Filter for expenses associated with the specified expense report ID. If the\\n        report was canceled or rejected, no result is returned.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"with_recent_expense_report_ids\",\"description\":\"Filter for expenses associated with the specified expense report IDs, including from canceled and rejected reports.\\n        Give multiple report IDs in a comma separated list.\\n\\n        **Note**: Expenses are only associated with the most recent reports they were submitted in (`recent_submission`).\\n        If you re-submit an expense from a canceled or rejected report in a new report, the expense will only be returned\\n        in association with that most recent submission`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter for expenses associated with the specified project ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Expenses have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_ReceiptAttachment\"}},\"expense_report_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseReportSubmission\"}},\"expense_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseCategory\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Expense\",\"description\":\"You can create multiple expenses in a single request if you send an `expenses` array.  An example would be\\nto send a request with the following parameters encoded as `application/json`:\\n\\n  {\\\"expenses\\\": [\\n    {\\\"workspace_id\\\": 1, \\\"date\\\": \\\"2013-02-19T17:13:23-08:00\\\", \\\"category\\\": \\\"Food\\\", \\\"amount_in_cents\\\": 5000},\\n    {\\\"workspace_id\\\": 1, \\\"date\\\": \\\"2015-02-19T17:13:23-08:00\\\", \\\"category\\\": \\\"Travel\\\", \\\"amount_in_cents\\\": 10000}\\n  ]}\\n\\n\\nThis endpoint returns structured Expense objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expenses` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-expense\",\"tags\":[\"Expenses\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_submission` (ExpenseReportSubmission)\\n- `expense_category` (ExpenseCategory) - The category associated with the expense.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `receipt` (Attachments::ReceiptAttachment) - Information about receipts associated with this expense, returned in the `attachments` top-level key.\\n- `recent_submission` (ExpenseReportSubmission) - The most recent expense report the expense was submitted in, including any rejected or cancelled reports.\\n- `role` (Role) - The role of the user.\\n- `story` (Story) - Linked task, returned in the `stories` top-level key.\\n- `user` (User) - The user who created the expense, returned in the `users` top-level key.\\n- `vendor` (Vendor) - The party to which the expense is payable.\\n- `workspace` (Workspace) - The project to which this expense belongs, returned in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"user_can_edit\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"expense\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project in which the expense will be created.\"},\"date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date of the expense. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"expense_category_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the category with which the expense will be associated.\"},\"category\":{\"type\":\"string\",\"description\":\"The category of the expense as a string.\"},\"amount_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount of the expense, in cents. If 'foreign_exchange_amount' is specified, that overrides the 'amount_in_cents'.\"},\"foreign_exchange_amount\":{\"type\":\"object\",\"description\":\"If you have permission to convert expenses, this is the expense in foreign currency units.\",\"properties\":{\"source_value\":{\"type\":\"string\",\"description\":\"The amount of the expense, in foreign currency units.\"},\"source_currency\":{\"type\":\"string\",\"description\":\"The [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473-Supported-Currency-ISO-Codes) of the foreign currency in which the expense was incurred.\"}},\"required\":[\"source_value\",\"source_currency\"]},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The internal ID of the user the expense is associated with. This parameter is ignored unless the\\nauthorizing user has financial access in the project and is on the consultants team (or if the\\nauthorizing user is an account administrator and has proxy permissions via an account member with\\nthose permissions).\"},\"notes\":{\"type\":\"string\",\"description\":\"Freeform text related to the expense.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"A boolean that indicates whether or not the expense is billable.\"},\"receipt_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The optional ID of an attached receipt for the expense.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The optional ID of a task in the project (this will be linked to this expense). Depending on the\\nproject's settings, expenses can be associated with only expense budgets or only tasks.\"},\"expense_budget_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The optional ID of an expense budget in the project (this will be linked to this expense). Depending\\non the project's settings, expenses can be associated with only expense budgets or only tasks.\"},\"reimbursable\":{\"type\":\"boolean\",\"description\":\"A boolean that indicates whether the expense is reimbursable to the user.\"},\"vendor_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The optional ID of the vendor to which the expense is reimbursable.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"workspace_id\",\"date\",\"expense_category_id\",\"category\",\"amount_in_cents\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Expense has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_ReceiptAttachment\"}},\"expense_report_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseReportSubmission\"}},\"expense_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseCategory\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Delete multiple expenses\",\"description\":\"The IDs of the expenses to delete can be provided in the `ids` query parameter or via the request body.\\n\\nRequest body example:\\n```{\\n  \\\"ids\\\": \\\"1,2,3\\\"\\n}```\\n\\nIf any specified expenses cannot be deleted, the entire request will fail and an error message\\nwill be returned that specifies which ones could not be deleted and why.\\n\\n\\nThis endpoint returns structured Expense objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expenses` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"delete-expenses\",\"tags\":[\"Expenses\"],\"parameters\":[{\"in\":\"query\",\"name\":\"ids\",\"required\":false,\"description\":\"A comma-separated list of IDs of expenses. You can provide up to 100 IDs. The IDs can be\\nprovided in this query parameter or via the request body.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"204\":{\"description\":\"Expense has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/expenses/{id}\":{\"get\":{\"summary\":\"Fetching a single Expense\",\"description\":\"You can request either `GET /api/v1/expenses.json?only=5` or\\n`GET /api/v1/expenses/5.json`.  In both cases, default filters will be applied. Unless you\\nprovide the `from_archived_workspaces:true` filter you won't receive expenses from archived projects,\\nand will get a 404 status on the \\\"show\\\" route.\\n\\n\\nThis endpoint returns structured Expense objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expenses` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-expense\",\"tags\":[\"Expenses\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_submission` (ExpenseReportSubmission)\\n- `expense_category` (ExpenseCategory) - The category associated with the expense.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `receipt` (Attachments::ReceiptAttachment) - Information about receipts associated with this expense, returned in the `attachments` top-level key.\\n- `recent_submission` (ExpenseReportSubmission) - The most recent expense report the expense was submitted in, including any rejected or cancelled reports.\\n- `role` (Role) - The role of the user.\\n- `story` (Story) - Linked task, returned in the `stories` top-level key.\\n- `user` (User) - The user who created the expense, returned in the `users` top-level key.\\n- `vendor` (Vendor) - The party to which the expense is payable.\\n- `workspace` (Workspace) - The project to which this expense belongs, returned in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"user_can_edit\"]}}}],\"responses\":{\"200\":{\"description\":\"The Expense has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_ReceiptAttachment\"}},\"expense_report_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseReportSubmission\"}},\"expense_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseCategory\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Expense\",\"description\":\"An expense that has already been created can be updated with an HTTP PUT request. Any required or optional\\nattribute, with the exception of `workspace_id`, can be changed in an update.\\n\\n\\nThis endpoint returns structured Expense objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `expenses` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-expense\",\"tags\":[\"Expenses\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_submission` (ExpenseReportSubmission)\\n- `expense_category` (ExpenseCategory) - The category associated with the expense.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `receipt` (Attachments::ReceiptAttachment) - Information about receipts associated with this expense, returned in the `attachments` top-level key.\\n- `recent_submission` (ExpenseReportSubmission) - The most recent expense report the expense was submitted in, including any rejected or cancelled reports.\\n- `role` (Role) - The role of the user.\\n- `story` (Story) - Linked task, returned in the `stories` top-level key.\\n- `user` (User) - The user who created the expense, returned in the `users` top-level key.\\n- `vendor` (Vendor) - The party to which the expense is payable.\\n- `workspace` (Workspace) - The project to which this expense belongs, returned in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"user_can_edit\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"expense\":{\"type\":\"object\",\"properties\":{\"date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date of the expense in ISO8601 format. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"expense_category_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the category to which the expense will be associated.\"},\"category\":{\"type\":\"string\",\"description\":\"The category of the expense as a string.\"},\"amount_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount of the expense, in cents. If 'foreign_exchange_amount' is specified, that overrides the 'amount_in_cents'.\"},\"foreign_exchange_amount\":{\"type\":\"object\",\"description\":\"If you have permission to convert expenses, this is the expense in foreign currency units.\",\"properties\":{\"source_value\":{\"type\":\"string\",\"description\":\"The amount of the expense, in foreign currency units.\"},\"source_currency\":{\"type\":\"string\",\"description\":\"The [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473-Supported-Currency-ISO-Codes) of the foreign currency in which the expense was incurred.\"}},\"required\":[\"source_value\",\"source_currency\"]},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The internal ID of the user with whom the expense is associated. This parameter is ignored unless the\\nauthorizing user has financial access in the project and is on the consultants team; or if they\\nare an Account Administrator that has proxy permissions through an account member with the necessary permissions.\"},\"notes\":{\"type\":\"string\",\"description\":\"Freeform text related to the expense.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"A boolean that indicates whether or not this expense is billable.\"},\"receipt_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The optional ID of an attached receipt for this expense.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The optional ID of a task in the project (this will be linked to this expense). Depending on the\\nproject's settings, expenses can be associated with only expense budgets or only tasks.\"},\"expense_budget_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The optional ID of an expense budget in the project (this will be linked to this expense). Depending\\non the project's settings, expenses can be associated with only expense budgets or only tasks.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"amount_in_cents\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Expense has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_ReceiptAttachment\"}},\"expense_report_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseReportSubmission\"}},\"expense_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExpenseCategory\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Expense\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-expense\",\"tags\":[\"Expenses\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Expense has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/exports\":{\"get\":{\"summary\":\"Get a list of Data Exports\",\"description\":\"Returns information on all exports that have been requested, including their status and the data sets and columns that were selected for the exports.\\n\\nThis endpoint returns structured Data Export objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `exports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-exports\",\"tags\":[\"Data Exports\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - The user who generated the export.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Data Exports have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"exports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountDataExportResult\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Generate a Data Export\",\"description\":\"Generates an export. Use the data set `key` and each column `key` that you want to be included in your export. The values need to be properly formatted JSON, which means you may need to escape special characters. If no column keys are provided, the export will fail and return a 422 response.\\n\\n**Example**\\nThe following example creates a new export containing all the non-custom field columns for the User dataset created during October 2023.\\n\\n```\\ncurl -i -X POST 'https://api.mavenlink.com/api/v1/exports' -H 'Content-Type: application/json' -d '{\\n  \\\"export\\\": {\\n    \\\"export_definition\\\": {\\n      \\\"8ebff9db413b3115\\\": {\\n        \\\"columns\\\": [\\n          \\\"4eb02f5e2601433d\\\",\\n          \\\"b02d7f145ad95122\\\",\\n          \\\"2bfa2c20999efe62\\\",\\n          \\\"96cb337e5007738b\\\",\\n          \\\"27e2565ae34ed9eb\\\",\\n          \\\"d5111608cc214c2a\\\",\\n          \\\"e59d1cb61256a8cf\\\",\\n          \\\"77bfd7e48d5ff668\\\",\\n          \\\"23ca4c0d7b289c5f\\\",\\n          \\\"7172de0607dcb1ef\\\"\\n        ],\\n        \\\"filters\\\": {\\n          \\\"start_date\\\": \\\"2023-10-01\\\",\\n          \\\"end_date\\\": \\\"2023-10-31\\\"\\n        }\\n      }\\n    }\\n  }\\n}'\\n```\\n\\n\\nThis endpoint returns structured Data Export objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `exports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-export\",\"tags\":[\"Data Exports\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - The user who generated the export.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"export\":{\"type\":\"object\",\"properties\":{\"export_definition\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\",\"description\":\"The `key` value for the data set you want to export.\",\"properties\":{\"columns\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"The `key` values for each column you want to include in the export.\"},\"filters\":{\"type\":\"object\",\"description\":\"The filters that you want to apply to the export.\",\"properties\":{\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date to filter the export by, which restricts data to objects that were created on or after the given date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The end date to filter the export by, which restricts data to objects that were created on or before the given date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}},\"required\":[\"columns\"]}}},\"required\":[\"export_definition\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Data Export has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"exports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountDataExportResult\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/exports/available_datasets\":{\"get\":{\"summary\":\"Get Data Set Schema\",\"description\":\"Returns a list of the available data sets to export—as well as the respective available columns within each data set, which could include custom fields. The response will include unique `key` values for each individual data set and for each column. You will need to properly pass these keys in when you generate your data export.\",\"operationId\":\"get-exports-available-datasets\",\"tags\":[\"Data Export Schema\"],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"datasets\":{\"type\":\"object\",\"description\":\"The `key`, `display_name`, and `columns` for a data set.\",\"additionalProperties\":{\"type\":\"object\",\"description\":\"The `key` value for a data set.\",\"properties\":{\"key\":{\"type\":\"string\",\"description\":\"The `key` value for a data set.\"},\"display_name\":{\"type\":\"string\",\"description\":\"The name of a data set as it appears in the Data Exporter.\"},\"columns\":{\"type\":\"array\",\"description\":\"The `key` value and `display_name` for a column in a data set.\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\",\"description\":\"The `key` value for a column in a data set.\"},\"display_name\":{\"type\":\"string\",\"description\":\"The name of a column as it appears in the Data Exporter.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of a column in an export.\"},\"type\":{\"type\":\"string\",\"description\":\"The data type of a column.\"}}}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/exports/{id}\":{\"get\":{\"summary\":\"Get a single Data Export\",\"description\":\"Returns information on a single export that has been requested, including the status and the data sets and columns that were selected for the export.\\n\\nThis endpoint returns structured Data Export objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `exports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-export\",\"tags\":[\"Data Exports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - The user who generated the export.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Data Export has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"exports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountDataExportResult\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Cancel a Data Export\",\"description\":\"Cancel an export that is in a Queued status.\\n\\nThis endpoint returns structured Data Export objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `exports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-export\",\"tags\":[\"Data Exports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - The user who generated the export.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"export\":{\"type\":\"object\",\"properties\":{\"canceled\":{\"type\":\"boolean\",\"description\":\"If set to `true`, cancels an export with a Queued status.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Data Export has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"exports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountDataExportResult\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/exports/{id}/download_url\":{\"get\":{\"summary\":\"Download a Data Export\",\"description\":\"Returns a download URL for a successfully generated data export that expires in 60 seconds. With this URL, you can use `curl` or `wget` to download the export in a CSV format.\\n\\nThis endpoint returns structured Data Export objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `exports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"download-export\",\"tags\":[\"Data Exports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - The user who generated the export.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Data Exports have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"download_url\":{\"type\":\"string\",\"description\":\"The URL to download a generated data export that expires in 60 seconds.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/external_payments\":{\"get\":{\"summary\":\"Fetching a list of External Payments\",\"description\":\"The external payments currently visible to the user that is logged-in.\\n\\n\\nThis endpoint returns structured External Payment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `external_payments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-external-payments\",\"tags\":[\"External Payments\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `invoice` (Invoice) - The invoice (if any) for which the external payment was created.\\n- `user` (User) - The user who created the external payment.\\n- `workspace` (Workspace) - The project in which the external payment was created.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"invoice_id\",\"description\":\"Limit returned external payments to those paying the invoice with the specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `id:asc`, `id:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_id\",\"description\":\"Limit returned external payments to those created by the user with the specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Limit returned external payments to those logged within the specified workspace_id.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of External Payments have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"external_payments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalPayment\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new External Payment\",\"description\":\"Creates an external payment for the specified project or invoice. If an invoice ID is provided, a\\npayment is only created for that invoice when it's a single project invoice and in a non-draft pending state.\\n\\n\\nThis endpoint returns structured External Payment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `external_payments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-external-payment\",\"tags\":[\"External Payments\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `invoice` (Invoice) - The invoice (if any) for which the external payment was created.\\n- `user` (User) - The user who created the external payment.\\n- `workspace` (Workspace) - The project in which the external payment was created.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"external_payment\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project in which the payment will be created.\"},\"invoice_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the invoice (if any) that is being paid by the external payment.  This automatically sets the amount\\nattribute of the payment to the amount of the specified invoice, and will override any `amount_in_cents` parameter sent.\"},\"amount_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Indicates that the payment is not for an invoice, and will be ignored if an `invoice_id` is provided.\\nMust be in base cent units of the currency of the project in which the payment is created.\"},\"message\":{\"type\":\"string\",\"description\":\"An optional string describing the payment (255 characters maximum).\"}},\"required\":[\"workspace_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"External Payment has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"external_payments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalPayment\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/external_payments/{id}\":{\"get\":{\"summary\":\"Fetching a single External Payment\",\"description\":\"This endpoint returns structured External Payment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `external_payments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-external-payment\",\"tags\":[\"External Payments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `invoice` (Invoice) - The invoice (if any) for which the external payment was created.\\n- `user` (User) - The user who created the external payment.\\n- `workspace` (Workspace) - The project in which the external payment was created.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The External Payment has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"external_payments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalPayment\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing External Payment\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-external-payment\",\"tags\":[\"External Payments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"External Payment has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/external_references\":{\"get\":{\"summary\":\"Fetches all external references on a user's account\",\"description\":\"Returns external references, for objects of particular types, that are synced with the\\nthird-party systems.\\n\\n\\nThis endpoint returns structured External Reference objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `external_references` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-external-references\",\"tags\":[\"External References\"],\"parameters\":[{\"in\":\"query\",\"name\":\"subject_type\",\"required\":true,\"description\":\"The type of the Kantata OX object that has the external reference. One of\\n`Assignment`, `CustomField`, `CustomFieldChoice`, `CustomFieldSet`, `CustomFieldValue`, `Estimate`, `EstimateScenario`, `EstimateScenarioResource`, `Expense`, `Invoice`, `Participation`, `Post`, `RateCard`, `Role`, `Skill`, `StatusReport`, `Story`, `StoryAllocationDay`, `Submission`, `SurveyAnswer`, `SurveyQuestion`, `SurveyResponse`, `SurveyTemplate`, `TimeEntry`, `TimeOffEntry`, `User`, `Vendor`, `Workspace`, `WorkspaceAllocation`, `WorkspaceGroup`, or `WorkspaceResource`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_message\",\"description\":\"Only include external references with the specified external message.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_status\",\"description\":\"The status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `subject` (polymorphic) - The item with which the external reference is associated.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"last_synced_after\",\"description\":\"Filter for records last synced after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"last_synced_before\",\"description\":\"Filter for records last synced before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `last_synced_at:asc`, and `last_synced_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"last_synced_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"service_model\",\"description\":\"The type of the external object.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"service_model_ref\",\"description\":\"The object ID of an external object.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"service_name\",\"description\":\"The provider name of the integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"status\",\"description\":\"The status of the integration. Options are 'pending', 'successful', or 'failed'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"subject_id\",\"required\":false,\"description\":\"The ID of the Kantata OX object that has the external reference.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of External References have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"estimates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Estimate\"}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}},\"submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Submission\"}},\"survey_answers\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyAnswer\"}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}},\"survey_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyTemplate\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"time_off_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeOffEntry\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"workspace_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceAllocation\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/external_references/create_or_update\":{\"post\":{\"summary\":\"Create or update an external reference\",\"description\":\"This endpoint returns structured External Reference objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `external_references` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-or-update-external-reference\",\"tags\":[\"External References\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `subject` (polymorphic) - The item with which the external reference is associated.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"external_reference\":{\"type\":\"object\",\"properties\":{\"subject_type\":{\"type\":\"string\",\"description\":\"The type of the Kantata OX object to which this external reference belongs.\\nOne of `Assignment`, `CustomField`, `CustomFieldChoice`, `CustomFieldSet`, `CustomFieldValue`, `Estimate`, `EstimateScenario`, `EstimateScenarioResource`, `Expense`, `Invoice`, `Participation`, `Post`, `RateCard`, `Role`, `Skill`, `StatusReport`, `Story`, `StoryAllocationDay`, `Submission`, `SurveyAnswer`, `SurveyQuestion`, `SurveyResponse`, `SurveyTemplate`, `TimeEntry`, `TimeOffEntry`, `User`, `Vendor`, `Workspace`, `WorkspaceAllocation`, `WorkspaceGroup`, or `WorkspaceResource`.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Kantata OX object to which this external reference belongs.\"},\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of the integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The type of the external object to which this reference belongs.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The ID of the external object to which this external reference belongs.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration. Options are 'pending', 'successful', or 'failed'.\"},\"external_link\":{\"type\":\"string\",\"description\":\"A URL that links to either the external object or event.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"external_message\":{\"type\":\"string\",\"description\":\"An optional message about the external object.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"An optional field, indicates whether the subject should be locked. To prevent changes\\nto the object in Kantata OX, set this to true. This currently only applies to expense\\nreport rejections.\"}},\"required\":[\"subject_type\",\"subject_id\",\"service_name\",\"service_model\",\"service_model_ref\",\"external_link\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"External Reference has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"custom_fields\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomField\"}},\"custom_field_choices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldChoice\"}},\"custom_field_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldSet\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"estimates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Estimate\"}},\"estimate_scenarios\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenario\"}},\"estimate_scenario_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/EstimateScenarioResource\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}},\"submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Submission\"}},\"survey_answers\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyAnswer\"}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}},\"survey_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyTemplate\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"time_off_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeOffEntry\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"workspace_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceAllocation\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/external_references/{id}\":{\"delete\":{\"summary\":\"Deleting an existing External Reference\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-external-reference\",\"tags\":[\"External References\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"External Reference has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/foreign_exchange/exchange_tables\":{\"get\":{\"summary\":\"Fetching a list of Exchange Tables\",\"description\":\"Returns a list of exchange tables associated with your account, and their default settings details.\",\"operationId\":\"get-exchange-tables\",\"tags\":[\"Exchange Tables\"],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of pagination pages available.\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Current pagination page.\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of elements in a pagination page.\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"}}}},\"exchange_tables\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the exchange table.\"},\"account_default\":{\"type\":\"boolean\",\"description\":\"If true, this is set as the default exchange table for currency conversions across your entire account.\"},\"insights_account_default\":{\"type\":\"boolean\",\"description\":\"If true, this is set as the default exchange table for currency conversions in Insights reports.\"}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Exchange Table\",\"description\":\"Creates a new exchange table.\",\"operationId\":\"create-exchange-table\",\"tags\":[\"Exchange Tables\"],\"parameters\":[{\"in\":\"query\",\"name\":\"name\",\"required\":true,\"description\":\"Give a name for your new exchange table.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"account_default\",\"required\":false,\"description\":\"If `true`, sets the exchange table to be the default\\n            for currency conversions across your entire account.\\n            This includes currency conversions in Insights reports, unless you set a different table\\n            as the `insights_account_default`.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"insights_account_default\",\"required\":false,\"description\":\"If `true`, sets the exchange table to be\\n            the default for currency conversions in Insights reports.\\n            The `insights_account_default` exchange table must have 400 or fewer currency pairs\\n            in order for exchange rates information to display in Insights reports.\",\"schema\":{\"type\":\"boolean\"}}],\"responses\":{\"200\":{\"description\":\"object has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of pagination pages available.\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Current pagination page.\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of elements in a pagination page.\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"}}}},\"exchange_tables\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the exchange table.\"},\"account_default\":{\"type\":\"boolean\",\"description\":\"If true, this is set as the default exchange table for currency conversions across your entire account.\"},\"insights_account_default\":{\"type\":\"boolean\",\"description\":\"If true, this is set as the default exchange table for currency conversions in Insights reports.\"}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/foreign_exchange/exchange_tables/{id}\":{\"get\":{\"summary\":\"Fetching a single Exchange Table\",\"description\":\"Returns default settings details for a specified exchange table.\",\"operationId\":\"get-exchange-table\",\"tags\":[\"Exchange Tables\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"The object has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the exchange table.\"},\"account_default\":{\"type\":\"boolean\",\"description\":\"If true, this is set as the default exchange table for currency conversions across your entire account.\"},\"insights_account_default\":{\"type\":\"boolean\",\"description\":\"If true, this is set as the default exchange table for currency conversions in Insights reports.\"}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Exchange Table\",\"description\":\"Updates the name and/or default settings for a specified exchange table.\",\"operationId\":\"update-exchange-table\",\"tags\":[\"Exchange Tables\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"account_default\",\"required\":false,\"description\":\"If `true`, sets the exchange table to be the default\\n            for currency conversions across your entire account.\\n            This includes currency conversions in Insights reports, unless you set a different table\\n            as the `insights_account_default`.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"insights_account_default\",\"required\":false,\"description\":\"If `true`, sets the exchange table to be\\n            the default for currency conversions in Insights reports.\\n            The `insights_account_default` exchange table must have 400 or fewer currency pairs\\n            in order for exchange rates information to display in Insights reports.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"name\",\"required\":false,\"description\":\"Update the name of the exchange table.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"object has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of pagination pages available.\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Current pagination page.\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of elements in a pagination page.\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"}}}},\"exchange_tables\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the exchange table.\"},\"account_default\":{\"type\":\"boolean\",\"description\":\"If true, this is set as the default exchange table for currency conversions across your entire account.\"},\"insights_account_default\":{\"type\":\"boolean\",\"description\":\"If true, this is set as the default exchange table for currency conversions in Insights reports.\"}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/foreign_exchange/exchange_tables/{id}/rates\":{\"post\":{\"summary\":\"Import Exchange Rates\",\"description\":\"Add or update exchange rates for a specified exchange table by importing rates as a .csv file, or in a JSON array of hashes.\",\"operationId\":\"import-exchange-tables\",\"tags\":[\"Exchange Tables\"],\"parameters\":[{\"in\":\"query\",\"name\":\"csv_file\",\"required\":true,\"description\":\"A CSV file with the following headers: **Source Currency**, **Target Currency**, **Exchange Rate**, and **Effective Date**.\\n\\nFor more details on how to format your CSV file, please see the [Knowledge Base](https://mavenlink.zendesk.com/hc/en-us/articles/360047982574).\\n\\nAlternatively, you can provide exchanges rates via the `exchange_rates` parameter. If both `csv_file` and `exchange_rates` are provided, `csv_file` will override `exchange_rates`.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"string\"}},{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"exchange_rates\":{\"type\":\"array\",\"description\":\"An array of hashes represents an entire exchange rate table, while each hash represents a row in the table. Each row (hash) contains four (4) fields that make up a currency conversion, organized by columns in a table. These fields are source currency, target currency, effective date, and exchange rate of each currency conversion. Add hashes to define a new currency exchange, or modify the fields of existing hashes to update those currency conversions.\",\"items\":{\"type\":\"object\",\"properties\":{\"source_currency\":{\"type\":\"string\",\"description\":\"The currency you are converting from.\"},\"target_currency\":{\"type\":\"string\",\"description\":\"The currency you are converting to.\"},\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the exchange rate takes effect. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"exchange_rate\":{\"type\":\"string\",\"description\":\"The rate of the exchange from source to target currency. For example, a rate of 1.53 for a USD (source) to AUD (target) conversion would mean 1USD = 1.53AUD.\"}}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"object has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of pagination pages available.\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Current pagination page.\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of elements in a pagination page.\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"}}}},\"exchange_rates\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the exchange rate.\"},\"exchange_table_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the exchange table.\"},\"source_currency\":{\"type\":\"string\",\"description\":\"The currency you are converting from.\"},\"target_currency\":{\"type\":\"string\",\"description\":\"The currency you are converting to.\"},\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the exchange rate takes effect.\"},\"rate\":{\"type\":\"string\",\"description\":\"The rate of the exchange from source to target currency. For example, a rate of 1.53 for a USD (source) to AUD (target) conversion\\n                  would mean 1USD = 1.53AUD.\"},\"source_currency_symbol\":{\"type\":\"string\",\"description\":\"The symbol for the source currency.\"}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"get\":{\"summary\":\"Fetching a list of Exchange Rates\",\"description\":\"Returns all current exchange rates for a specified exchange table, unless filter parameters have been applied..\",\"operationId\":\"get-exchange-rates\",\"tags\":[\"Exchange Tables\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"date\",\"required\":false,\"description\":\"Filter for rates by the date the exchange rate takes effect. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"page\",\"required\":false,\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"per_page\",\"required\":false,\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"source_currency\",\"required\":false,\"description\":\"Filter for rates with the specified source currency (in [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473-Supported-Currency-ISO-Codes) format). The source currency is the currency you are converting from.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"target_currency\",\"required\":false,\"description\":\"Filter for rates with the specified target currency (in [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473-Supported-Currency-ISO-Codes) format). The target currency is the currency you are converting to.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of exchange tables in the response.\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of pagination pages available.\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Current pagination page.\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Number of elements in a pagination page.\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\",\"description\":\"The ID of the exchange table.\"}}}},\"exchange_rates\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the exchange rate.\"},\"exchange_table_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the exchange table.\"},\"source_currency\":{\"type\":\"string\",\"description\":\"The currency you are converting from.\"},\"target_currency\":{\"type\":\"string\",\"description\":\"The currency you are converting to.\"},\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the exchange rate takes effect.\"},\"rate\":{\"type\":\"string\",\"description\":\"The rate of the exchange from source to target currency. For example, a rate of 1.53 for a USD (source) to AUD (target) conversion\\n                  would mean 1USD = 1.53AUD.\"},\"source_currency_symbol\":{\"type\":\"string\",\"description\":\"The symbol for the source currency.\"}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/holiday_calendar_associations\":{\"get\":{\"summary\":\"Fetching a list of Holiday Calendar Associations\",\"description\":\"This endpoint returns structured Holiday Calendar Association objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendar_associations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-holiday-calendar-associations\",\"tags\":[\"Holiday Calendar Associations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_holiday_calendar_id\",\"description\":\"Show only Holiday Calendar Associations that are associated with a specific Holiday Calendar.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_holiday_name\",\"description\":\"Show only Holiday Calendar Associations associated with Holidays that have a name which matches the search parameter.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday` (Holiday) - The Holiday associated with this HolidayCalendarAssociation.\\n- `holiday_calendar` (HolidayCalendar) - The Holiday Calendar associated with this HolidayCalendarAssociation.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Holiday Calendar Associations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendar_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarAssociation\"}},\"holidays\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Holiday\"}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Holiday Calendar Association\",\"description\":\"This endpoint returns structured Holiday Calendar Association objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendar_associations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-holiday-calendar-association\",\"tags\":[\"Holiday Calendar Associations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday` (Holiday) - The Holiday associated with this HolidayCalendarAssociation.\\n- `holiday_calendar` (HolidayCalendar) - The Holiday Calendar associated with this HolidayCalendarAssociation.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"holiday_calendar_association\":{\"type\":\"object\",\"properties\":{\"holiday_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the holiday to be associated with a calendar.\"},\"holiday_calendar_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the calendar to be associated with a holiday.\"}},\"required\":[\"holiday_id\",\"holiday_calendar_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Holiday Calendar Association has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendar_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarAssociation\"}},\"holidays\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Holiday\"}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/holiday_calendar_associations/{id}\":{\"get\":{\"summary\":\"Fetching a single Holiday Calendar Association\",\"description\":\"This endpoint returns structured Holiday Calendar Association objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendar_associations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-holiday-calendar-association\",\"tags\":[\"Holiday Calendar Associations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday` (Holiday) - The Holiday associated with this HolidayCalendarAssociation.\\n- `holiday_calendar` (HolidayCalendar) - The Holiday Calendar associated with this HolidayCalendarAssociation.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Holiday Calendar Association has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendar_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarAssociation\"}},\"holidays\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Holiday\"}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Holiday Calendar Association\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-holiday-calendar-association\",\"tags\":[\"Holiday Calendar Associations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Holiday Calendar Association has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/holiday_calendar_memberships\":{\"get\":{\"summary\":\"Fetching a list of Holiday Calendar Memberships\",\"description\":\"This endpoint returns structured Holiday Calendar Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendar_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-holiday-calendar-memberships\",\"tags\":[\"Holiday Calendar Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_holiday_calendar_id\",\"description\":\"Include holiday calendar memberships for the specified holiday calendar ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_user_id\",\"description\":\"Include holiday calendar memberships for the specified user ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday_calendar` (HolidayCalendar) - The Holiday Calendar associated with this HolidayCalendarMembership.\\n- `user` (User) - The User participating in the Holiday Calendar.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `start_date:asc` and `start_date:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"start_date:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Holiday Calendar Memberships have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendar_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarMembership\"}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Holiday Calendar Membership\",\"description\":\"This endpoint returns structured Holiday Calendar Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendar_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-holiday-calendar-membership\",\"tags\":[\"Holiday Calendar Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday_calendar` (HolidayCalendar) - The Holiday Calendar associated with this HolidayCalendarMembership.\\n- `user` (User) - The User participating in the Holiday Calendar.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"holiday_calendar_membership\":{\"type\":\"object\",\"properties\":{\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the calendar begins to apply to the user. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"holiday_calendar_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the calendar that is associated to the user.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user assigned to the calendar.\"}},\"required\":[\"start_date\",\"holiday_calendar_id\",\"user_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Holiday Calendar Membership has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendar_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarMembership\"}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/holiday_calendar_memberships/{id}\":{\"get\":{\"summary\":\"Fetching a single Holiday Calendar Membership\",\"description\":\"This endpoint returns structured Holiday Calendar Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendar_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-holiday-calendar-membership\",\"tags\":[\"Holiday Calendar Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday_calendar` (HolidayCalendar) - The Holiday Calendar associated with this HolidayCalendarMembership.\\n- `user` (User) - The User participating in the Holiday Calendar.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Holiday Calendar Membership has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendar_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarMembership\"}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Holiday Calendar Membership\",\"description\":\"This endpoint returns structured Holiday Calendar Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendar_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-holiday-calendar-membership\",\"tags\":[\"Holiday Calendar Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday_calendar` (HolidayCalendar) - The Holiday Calendar associated with this HolidayCalendarMembership.\\n- `user` (User) - The User participating in the Holiday Calendar.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"holiday_calendar_membership\":{\"type\":\"object\",\"properties\":{\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The new date that the calendar begins to apply to the user. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"holiday_calendar_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the calendar that is associated to the user.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Holiday Calendar Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendar_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarMembership\"}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Holiday Calendar Membership\",\"description\":\"Unlink the calendar from the user.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-holiday-calendar-membership\",\"tags\":[\"Holiday Calendar Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Holiday Calendar Membership has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/holiday_calendars\":{\"get\":{\"summary\":\"Fetching a list of Holiday Calendars\",\"description\":\"This endpoint returns structured Holiday Calendar objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendars` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-holiday-calendars\",\"tags\":[\"Holiday Calendars\"],\"parameters\":[{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Limits holiday calendars to names matching the specified query.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `default`, `name:asc`, and `name:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"default\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Holiday Calendars have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Holiday Calendar\",\"description\":\"This endpoint returns structured Holiday Calendar objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendars` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-holiday-calendar\",\"tags\":[\"Holiday Calendars\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"holiday_calendar\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the holiday calendar.\"}},\"required\":[\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Holiday Calendar has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/holiday_calendars/{id}\":{\"get\":{\"summary\":\"Fetching a single Holiday Calendar\",\"description\":\"This endpoint returns structured Holiday Calendar objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendars` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-holiday-calendar\",\"tags\":[\"Holiday Calendars\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"The Holiday Calendar has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Holiday Calendar\",\"description\":\"This endpoint returns structured Holiday Calendar objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holiday_calendars` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-holiday-calendar\",\"tags\":[\"Holiday Calendars\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"holiday_calendar\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name to which the holiday calendar is being changed.\"}},\"required\":[\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Holiday Calendar has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holiday_calendars\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendar\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Holiday Calendar\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-holiday-calendar\",\"tags\":[\"Holiday Calendars\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Holiday Calendar has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/holidays\":{\"get\":{\"summary\":\"Fetching a list of Holidays\",\"description\":\"This endpoint returns structured Holiday objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holidays` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-holidays\",\"tags\":[\"Holidays\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday_calendar_associations` (HolidayCalendarAssociation) - The Holiday Calendar Associations for this Holiday.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Includes holidays matching the specified name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"not_on_calendars\",\"description\":\"Includes holidays not specified in the comma separated list of calendar IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"calendar_names_list\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `start_date:asc` and `start_date:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"start_date:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Holidays have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holidays\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Holiday\"}},\"holiday_calendar_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarAssociation\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Holiday\",\"description\":\"This endpoint returns structured Holiday objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holidays` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-holiday\",\"tags\":[\"Holidays\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday_calendar_associations` (HolidayCalendarAssociation) - The Holiday Calendar Associations for this Holiday.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"calendar_names_list\"]}}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/create-holidayBody\"},\"responses\":{\"200\":{\"description\":\"Holiday has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holidays\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Holiday\"}},\"holiday_calendar_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarAssociation\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/holidays/{id}\":{\"get\":{\"summary\":\"Fetching a single Holiday\",\"description\":\"This endpoint returns structured Holiday objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holidays` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-holiday\",\"tags\":[\"Holidays\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday_calendar_associations` (HolidayCalendarAssociation) - The Holiday Calendar Associations for this Holiday.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"calendar_names_list\"]}}}],\"responses\":{\"200\":{\"description\":\"The Holiday has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holidays\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Holiday\"}},\"holiday_calendar_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarAssociation\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Holiday\",\"description\":\"This endpoint returns structured Holiday objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `holidays` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-holiday\",\"tags\":[\"Holidays\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `holiday_calendar_associations` (HolidayCalendarAssociation) - The Holiday Calendar Associations for this Holiday.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"calendar_names_list\"]}}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/create-holidayBody\"},\"responses\":{\"200\":{\"description\":\"Holiday has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"holidays\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Holiday\"}},\"holiday_calendar_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/HolidayCalendarAssociation\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Holiday\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-holiday\",\"tags\":[\"Holidays\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Holiday has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/insights_access_group_memberships\":{\"get\":{\"summary\":\"Fetching a list of Insights Access Group Memberships\",\"description\":\"This endpoint returns structured Insights Access Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `insights_access_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-insights-access-group-memberships\",\"tags\":[\"Insights Access Group Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_access_group_id\",\"description\":\"Return only memberships associated with a specified Insights Access Group ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_user_name\",\"description\":\"Return only memberships associated with a specified user name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the associated user.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"user_name\",\"account_permission\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"user_ids\",\"description\":\"Return only memberships associated with the specified user IDs.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}}],\"responses\":{\"200\":{\"description\":\"A list of Insights Access Group Memberships have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"insights_access_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/InsightsAccessGroupMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Insights Access Group Membership\",\"description\":\"Adds a user to an Insights Access Group. Only Account Administrators can add users to Insights Access Groups.\\n\\n\\nThis endpoint returns structured Insights Access Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `insights_access_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-insights-access-group-membership\",\"tags\":[\"Insights Access Group Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the associated user.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"user_name\",\"account_permission\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"insights_access_group_membership\":{\"type\":\"object\",\"properties\":{\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user to add to the Insights Access Group.\"},\"insights_access_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Insights Access Group to add the user to.\"}},\"required\":[\"user_id\",\"insights_access_group_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Insights Access Group Membership has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"insights_access_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/InsightsAccessGroupMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/insights_access_group_memberships/{id}\":{\"get\":{\"summary\":\"Fetching a single Insights Access Group Membership\",\"description\":\"This endpoint returns structured Insights Access Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `insights_access_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-insights-access-group-membership\",\"tags\":[\"Insights Access Group Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the associated user.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"user_name\",\"account_permission\"]}}}],\"responses\":{\"200\":{\"description\":\"The Insights Access Group Membership has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"insights_access_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/InsightsAccessGroupMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Insights Access Group Membership\",\"description\":\"Only Account Administrators can update Insights Access Group Memberships.\\n\\n**Note**: To move a user from one Insights Access Group to another, delete the existing Access Group\\nMembership, then create a new one.\\n\\n\\nThis endpoint returns structured Insights Access Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `insights_access_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-insights-access-group-membership\",\"tags\":[\"Insights Access Group Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the associated user.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"user_name\",\"account_permission\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"insights_access_group_membership\":{\"type\":\"object\",\"properties\":{\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the user can create and edit custom classic Insights dashboards and reports.\\n\\n**Warning**: Giving a user `can_edit` permission gives them access to *all* account data via Insights.\\n\\n**Note**: It may take up to 15 minutes for the system to sync the `can_edit` field.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Insights Access Group Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"insights_access_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/InsightsAccessGroupMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Insights Access Group Membership\",\"description\":\"Removes a user from an Insights Access Group. Only Account Administrators can\\ndelete Insights Access Group Memberships.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-insights-access-group-membership\",\"tags\":[\"Insights Access Group Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Insights Access Group Membership has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/insights_reports\":{\"get\":{\"summary\":\"Get Insights Reports\",\"description\":\"Returns a list of classic Insights reports on your Kantata OX account. When a `title` is provided, reports that match the `title` are returned. When a `title` is not provided, all classic Insights reports on your account are returned.\",\"operationId\":\"get-insights-reports\",\"tags\":[\"Insights Reports\"],\"parameters\":[{\"in\":\"query\",\"name\":\"title\",\"required\":false,\"description\":\"Specify the title of the report you would like to find similar matches for.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"identifier\":{\"type\":\"string\",\"description\":\"A unique identifier that each Insights report has. This identifier is primarily used by the Insights Report Exports endpoint to schedule exports of Insights reports.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of an Insights report, defined by users.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time a report was last updated.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time at which a report was created.\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/invoices\":{\"get\":{\"summary\":\"Fetching a list of Invoices\",\"description\":\"This endpoint returns structured Invoice objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `invoices` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-invoices\",\"tags\":[\"Invoices\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `additional_items` (AdditionalItem) - When included, the `additional_item_ids` array will reference all additional items included in the invoice.\\n- `expenses` (Expense) - When included, the `expense_ids` array will reference all expenses included in the invoice.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `fixed_fee_items` (FixedFeeItem) - When included, the `fixed_fee_items` array will reference all fixed fee items included in the invoice.\\n- `recipient` (User) - The User who received the invoice. Namely, the client lead at the time that the invoice\\nwas created (or null, if no lead client existed at the time).\\n- `time_entries` (TimeEntry) - When included, the `time_entry_ids` array will reference all time entries included in the invoice.\\n- `user` (User) - The user who created the invoice.\\n- `workspaces` (Workspace) - When included, the `workspace_ids` array will reference all projects covered by the invoice.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `id:asc`, `id:desc`, `invoice_date:asc`, `invoice_date:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"paid\",\"description\":\"When `true` is passed, only paid invoices are returned.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"pending\",\"description\":\"When `true` is passed, only non-accepted, non-draft invoices are returned.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_invoice_number\",\"description\":\"Provide one or more user invoice numbers, separated by commas. When provided, only invoices\\n              with the specified user invoice numbers will be returned.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"within_dates\",\"description\":\"Provide a date range in 2000-01-01:2000-12-31 format. When provided, only invoices created\\n              within the specified range will be returned.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_drafts\",\"description\":\"When `true` is passed, draft invoices will not be returned.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Provide one or more workspace IDs, separated by commas. If present, only invoices\\n              in the provided projects will be returned.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Invoices have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"additional_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AdditionalItem\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Invoice\",\"description\":\"This endpoint returns structured Invoice objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `invoices` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-invoice\",\"tags\":[\"Invoices\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `additional_items` (AdditionalItem) - When included, the `additional_item_ids` array will reference all additional items included in the invoice.\\n- `expenses` (Expense) - When included, the `expense_ids` array will reference all expenses included in the invoice.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `fixed_fee_items` (FixedFeeItem) - When included, the `fixed_fee_items` array will reference all fixed fee items included in the invoice.\\n- `recipient` (User) - The User who received the invoice. Namely, the client lead at the time that the invoice\\nwas created (or null, if no lead client existed at the time).\\n- `time_entries` (TimeEntry) - When included, the `time_entry_ids` array will reference all time entries included in the invoice.\\n- `user` (User) - The user who created the invoice.\\n- `workspaces` (Workspace) - When included, the `workspace_ids` array will reference all projects covered by the invoice.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"invoice\":{\"type\":\"object\",\"properties\":{\"time_entry_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"[Time Entry](/tag/Time-Entries) IDs. (At least one of the following is required: time_entry_ids, expense_ids, additional_items, or fixed_fee_items).\"},\"expense_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"[Expense](/tag/Expenses) IDs. (At least one of the following is required: time_entry_ids, expense_ids, additional_items, or fixed_fee_items).\"},\"fixed_fee_items\":{\"type\":\"array\",\"description\":\"Fixed fee item objects to create (At least one of the following is required: time_entry_ids, expense_ids, additional_items, or fixed_fee_items).\",\"items\":{\"type\":\"object\",\"properties\":{\"notes\":{\"type\":\"string\",\"description\":\"Notes to display on the fixed fee item.\"},\"amount\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The value of the fixed fee item, in the currency's main unit. Dollars, for example.\"},\"taxable\":{\"type\":\"boolean\",\"description\":\"Whether the fixed fee item is taxable.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [Story](/tag/Stories) associated with the fixed fee item.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [Workspace](/tag/Workspaces) associated with the fixed fee item.\"}}}},\"additional_items\":{\"type\":\"array\",\"description\":\"Additional item objects to create (At least one of the following is required: time_entry_ids, expense_ids, additional_items, or fixed_fee_items).\",\"items\":{\"type\":\"object\",\"properties\":{\"notes\":{\"type\":\"string\",\"description\":\"Notes to be displayed on the additional item.\"},\"amount\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The value of the additional item, in the currency's main unit. Dollars, for example.\"},\"taxable\":{\"type\":\"boolean\",\"description\":\"Whether the additional item is taxable.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [Workspace](/tag/Workspaces) associated with the additional item.\"}}}},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [Workspace](/tag/Workspaces) in which to create the invoice.\"},\"workspace_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of the [Workspaces](/tag/Workspaces) in which to create the (multi-project) invoice.\"},\"payment_schedule\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of days within which the total amount of the invoice is expected to be paid. For example, use `30` for a Net 30 payment schedule. See https://en.wikipedia.org/wiki/Net_D.\"},\"invoice_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The invoice date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"user_invoice_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The invoice number (defined by the user).\"},\"draft\":{\"type\":\"boolean\",\"description\":\"Whether the invoice is a draft.\"},\"message\":{\"type\":\"string\",\"description\":\"Notes to be displayed on the invoice.\"},\"user_invoice_title\":{\"type\":\"string\",\"description\":\"The invoice title (defined by the user).\"},\"purchase_order\":{\"type\":\"string\",\"description\":\"The invoice purchase order (defined by the user).\"},\"project_code\":{\"type\":\"string\",\"description\":\"The invoice project code (defined by the user).\"},\"suppress_emails\":{\"type\":\"boolean\",\"description\":\"Setting suppress_emails to true will prevent creation emails from being sent.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"time_entry_ids\",\"expense_ids\",\"fixed_fee_items\",\"additional_items\",\"workspace_id\",\"payment_schedule\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Invoice has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"additional_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AdditionalItem\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/invoices/next_invoice_number\":{\"get\":{\"summary\":\"Retrieve the next available invoice number.\",\"operationId\":\"get-next-invoice-number\",\"tags\":[\"Invoices\"],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"next_invoice_number\":{\"type\":\"string\",\"description\":\"The next invoice number.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/invoices/{id}\":{\"get\":{\"summary\":\"Fetching a single Invoice\",\"description\":\"This endpoint returns structured Invoice objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `invoices` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-invoice\",\"tags\":[\"Invoices\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `additional_items` (AdditionalItem) - When included, the `additional_item_ids` array will reference all additional items included in the invoice.\\n- `expenses` (Expense) - When included, the `expense_ids` array will reference all expenses included in the invoice.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `fixed_fee_items` (FixedFeeItem) - When included, the `fixed_fee_items` array will reference all fixed fee items included in the invoice.\\n- `recipient` (User) - The User who received the invoice. Namely, the client lead at the time that the invoice\\nwas created (or null, if no lead client existed at the time).\\n- `time_entries` (TimeEntry) - When included, the `time_entry_ids` array will reference all time entries included in the invoice.\\n- `user` (User) - The user who created the invoice.\\n- `workspaces` (Workspace) - When included, the `workspace_ids` array will reference all projects covered by the invoice.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Invoice has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"additional_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AdditionalItem\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Invoice\",\"description\":\"This endpoint returns structured Invoice objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `invoices` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-invoice\",\"tags\":[\"Invoices\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `additional_items` (AdditionalItem) - When included, the `additional_item_ids` array will reference all additional items included in the invoice.\\n- `expenses` (Expense) - When included, the `expense_ids` array will reference all expenses included in the invoice.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `fixed_fee_items` (FixedFeeItem) - When included, the `fixed_fee_items` array will reference all fixed fee items included in the invoice.\\n- `recipient` (User) - The User who received the invoice. Namely, the client lead at the time that the invoice\\nwas created (or null, if no lead client existed at the time).\\n- `time_entries` (TimeEntry) - When included, the `time_entry_ids` array will reference all time entries included in the invoice.\\n- `user` (User) - The user who created the invoice.\\n- `workspaces` (Workspace) - When included, the `workspace_ids` array will reference all projects covered by the invoice.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"invoice\":{\"type\":\"object\",\"properties\":{\"time_entry_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of [Time Entry](/tag/Time-Entries) IDs. Setting this field updates the invoice's complete list of time entries; it behaves as an overwrite. Any time entries not included in your request will be removed from the invoice. Additionally, sending an empty array will remove all time entries from the invoice. At least one time entry, expense, fixed fee item, or additional item must be on the invoice.\"},\"expense_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of [Expense](/tag/Expenses) IDs. Setting this field updates the invoice's complete list of expenses; it behaves as an overwrite. Any expenses not included in your request will be removed from the invoice. Additionally, sending an empty array will remove all expenses from the invoice. At least one time entry, expense, fixed fee item, or additional item must be on the invoice.\"},\"payment_schedule\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of days within which the total amount of the invoice is expected to be paid. For example, use `30` for a Net 30 payment schedule. See https://en.wikipedia.org/wiki/Net_D.\"},\"invoice_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The invoice date.  Determines the date from which the payment schedule will start. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"user_invoice_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The invoice number (defined by the user).\"},\"draft\":{\"type\":\"boolean\",\"description\":\"Whether the invoice is a draft.\"},\"message\":{\"type\":\"string\",\"description\":\"Notes to be displayed on the invoice.\"},\"user_invoice_title\":{\"type\":\"string\",\"description\":\"The invoice title (defined by the user).\"},\"purchase_order\":{\"type\":\"string\",\"description\":\"The invoice purchase order (defined by the user).\"},\"project_code\":{\"type\":\"string\",\"description\":\"The invoice project code (defined by the user).\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Invoice has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"additional_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AdditionalItem\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Invoice\",\"description\":\"You can delete draft invoices with this endpoint. Active invoices cannot be\\ndeleted. They must be cancelled instead.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-invoice\",\"tags\":[\"Invoices\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Invoice has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/invoices/{id}/cancel\":{\"put\":{\"summary\":\"Cancel an existing invoice.\",\"description\":\"You can cancel active invoices with this endpoint.\\n\\nThis endpoint returns structured Invoice objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `invoices` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"cancel-invoice\",\"tags\":[\"Invoices\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `additional_items` (AdditionalItem) - When included, the `additional_item_ids` array will reference all additional items included in the invoice.\\n- `expenses` (Expense) - When included, the `expense_ids` array will reference all expenses included in the invoice.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `fixed_fee_items` (FixedFeeItem) - When included, the `fixed_fee_items` array will reference all fixed fee items included in the invoice.\\n- `recipient` (User) - The User who received the invoice. Namely, the client lead at the time that the invoice\\nwas created (or null, if no lead client existed at the time).\\n- `time_entries` (TimeEntry) - When included, the `time_entry_ids` array will reference all time entries included in the invoice.\\n- `user` (User) - The user who created the invoice.\\n- `workspaces` (Workspace) - When included, the `workspace_ids` array will reference all projects covered by the invoice.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Invoice has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"additional_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AdditionalItem\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"expenses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Expense\"}},\"fixed_fee_items\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/FixedFeeItem\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/line_item_locks\":{\"get\":{\"summary\":\"Fetching a list of Line Item Locks\",\"description\":\"This endpoint returns structured Line Item Lock objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `line_item_locks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-line-item-locks\",\"tags\":[\"Line Item Locks\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user that set the line item lock on the account.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Line Item Locks have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"line_item_locks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/LineItemLock\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Line Item Lock\",\"description\":\"A line item lock will be created on your account at the specified lock date. On successful creation of a\\nline item lock, a representation of it will be returned to you.\\n\\nIf your account requires time to be approved, creation will fail unless all time entries before the\\nspecified lock date have been approved. The Kantata OX UI has an auto approval tool for your convenience\\nif you find yourself in this scenario.\\n\\n\\nThis endpoint returns structured Line Item Lock objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `line_item_locks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-line-item-lock\",\"tags\":[\"Line Item Locks\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user that set the line item lock on the account.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"line_item_lock\":{\"type\":\"object\",\"properties\":{\"locked_to\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Specify the date before which no one on the account will be able to submit or edit time entries.\\n(note: This must be a Saturday.) If any Line Item Locks previously existed on your account,\\nthis must be set to a later date than said preexisting lock. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}},\"required\":[\"locked_to\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Line Item Lock has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"line_item_locks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/LineItemLock\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/line_item_locks/{id}\":{\"get\":{\"summary\":\"Fetching a single Line Item Lock\",\"description\":\"This endpoint returns structured Line Item Lock objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `line_item_locks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-line-item-lock\",\"tags\":[\"Line Item Locks\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user that set the line item lock on the account.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Line Item Lock has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"line_item_locks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/LineItemLock\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/organization_memberships\":{\"get\":{\"summary\":\"Fetching a list of Organization Memberships\",\"description\":\"This endpoint returns structured Organization Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `organization_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-organization-memberships\",\"tags\":[\"Organization Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"department_id\",\"description\":\"Returns only organization memberships with the specified department ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"geography_id\",\"description\":\"Returns only organization memberships with the specified geography ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `department` (Organization) - The department of the associated member.\\n- `geography` (Organization) - The geography of the associated member.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"member_id\",\"description\":\"Returns only organization memberships with the specified member ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"member_type\",\"description\":\"Returns only organization memberships with the specified member type (user or workspace).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"primary\",\"description\":\"Return only the organization membership that is set as the primary for the object (`true`) or only the organization memberships that\\nare not the primary (`false`). This filter requires the primary organization feature.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Organization Memberships have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Organization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Organization Membership\",\"description\":\"This endpoint returns structured Organization Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `organization_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-organization-membership\",\"tags\":[\"Organization Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `department` (Organization) - The department of the associated member.\\n- `geography` (Organization) - The geography of the associated member.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"organization_membership\":{\"type\":\"object\",\"properties\":{\"geography_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the membership's geography.\"},\"department_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the membership's department.\"},\"member_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project or user.\"},\"member_type\":{\"type\":\"string\",\"description\":\"The type of object that describes the member (workspace or user).\"}},\"required\":[\"geography_id\",\"department_id\",\"member_id\",\"member_type\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Organization Membership has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Organization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/organization_memberships/{id}\":{\"get\":{\"summary\":\"Fetching a single Organization Membership\",\"description\":\"This endpoint returns structured Organization Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `organization_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-organization-membership\",\"tags\":[\"Organization Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `department` (Organization) - The department of the associated member.\\n- `geography` (Organization) - The geography of the associated member.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Organization Membership has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Organization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Organization Membership\",\"description\":\"This endpoint returns structured Organization Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `organization_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-organization-membership\",\"tags\":[\"Organization Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `department` (Organization) - The department of the associated member.\\n- `geography` (Organization) - The geography of the associated member.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"organization_membership\":{\"type\":\"object\",\"properties\":{\"geography_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the membership's geography.\"},\"department_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the membership's department.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Organization Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Organization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Organization Membership\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-organization-membership\",\"tags\":[\"Organization Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Organization Membership has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/organizations\":{\"get\":{\"summary\":\"Fetching a list of Organizations\",\"description\":\"This endpoint returns structured Organization objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `organizations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-organizations\",\"tags\":[\"Organizations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"for_current_user\",\"description\":\"Filter for organizations the current user belongs to. The parameter value is ignored (i.e. regardless of the value you supply, including this filter will always filter by organizations the current user belongs to).\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Where organization name is like specified parameter.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc`, `alphabetical:desc`, `created_at:asc`, and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"alphabetical:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"type\",\"description\":\"Where the organization is of a specified type.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Organizations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Organization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Organization\",\"description\":\"This endpoint returns structured Organization objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `organizations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-organization\",\"tags\":[\"Organizations\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"organization\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the organization.\"},\"parent_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the parent organization.\"}},\"required\":[\"name\",\"parent_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Organization has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Organization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/organizations/{id}\":{\"get\":{\"summary\":\"Fetching a single Organization\",\"description\":\"This endpoint returns structured Organization objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `organizations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-organization\",\"tags\":[\"Organizations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"The Organization has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Organization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Organization\",\"description\":\"This endpoint returns structured Organization objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `organizations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-organization\",\"tags\":[\"Organizations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"organization\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the organization.\"},\"parent_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the parent organization being created.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Organization has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"organizations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Organization\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Organization\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-organization\",\"tags\":[\"Organizations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Organization has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/participations\":{\"get\":{\"summary\":\"Fetching a list of Participations\",\"description\":\"The Participations index action only returns participations from projects that are visible to the requester.\\nSee the [Projects KB documentation](https://mavenlink.zendesk.com/hc/en-us/sections/200022139-Projects) for more information about how visibility restrictions work.\\n\\n\\nThis endpoint returns structured Participation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `participations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-participations\",\"tags\":[\"Participations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"workspace_id\",\"required\":true,\"description\":\"This parameter is required to identify the project you want to retrieve participations for.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_user\",\"description\":\"Retrieves participations for the specified user ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_user_full_name\",\"description\":\"Matches against users' full names.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_roles` (Role) - Retrieves all of the project roles of the participant. The response will include `active_role_ids`, which references the data in the `roles` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `primary_role` (Role) - Retrieves account role of the participant. Only visible when the authenticated user is on the same account the project is on. The response will include `primary_role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user (also known as the participant). The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace` (Workspace) - Retrieves the project. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the resource(s) associated with the participation, ordered alphabetically. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_role` (Role) - Retrieves the primary project role for the participant. The response will include `workspace_role_id`, which references the data in the `roles` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"mavens_only\",\"description\":\"Only consultant participations.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"not_assigned_to_story\",\"description\":\"Not assigned to the specified story ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"not_following_story\",\"description\":\"Not following the specified story ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"access_level\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `updated_at:asc`, `updated_at:desc`, `user_name:asc`, and `user_name:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Participations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Participation\",\"description\":\"This endpoint returns structured Participation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `participations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-participation\",\"tags\":[\"Participations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_roles` (Role) - Retrieves all of the project roles of the participant. The response will include `active_role_ids`, which references the data in the `roles` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `primary_role` (Role) - Retrieves account role of the participant. Only visible when the authenticated user is on the same account the project is on. The response will include `primary_role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user (also known as the participant). The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace` (Workspace) - Retrieves the project. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the resource(s) associated with the participation, ordered alphabetically. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_role` (Role) - Retrieves the primary project role for the participant. The response will include `workspace_role_id`, which references the data in the `roles` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"access_level\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"participation\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project the participation will belong to.\"},\"role\":{\"type\":\"string\",\"description\":\"The team a participant is on in a project, defined as either the \\\"maven\\\" (provider) or \\\"buyer\\\" (client) team.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user that wants to participate in the project.\"},\"can_invite\":{\"type\":\"boolean\",\"description\":\"Permission for the participant to invite other users into the project.\"},\"can_schedule_their_hours\":{\"type\":\"boolean\",\"description\":\"Permission for the participant to schedule their own hours.\"},\"can_schedule_team_hours\":{\"type\":\"boolean\",\"description\":\"Permission for the participant to schedule hours for project team members.\"},\"permissions\":{\"type\":\"string\",\"description\":\"Permission for the user in the workspace. It must be any combination of \\\"edit\\\", \\\"view_only\\\", \\\"view_and_post\\\",\\n\\\"can_edit\\\", \\\"can_post\\\", \\\"can_edit_expense\\\", \\\"can_edit_time\\\", \\\"can_invite\\\", \\\"can_schedule_their_hours\\\", or\\n\\\"can_schedule_team_hours\\\" delimited by commas. ex. \\\"can_post,can_edit_time\\\"\\n\\nIf \\\"can_invite\\\", \\\"can_schedule_their_hours\\\", or \\\"can_schedule_team_hours\\\" are not set—either via the individual\\nfields or the `permissions` string—they will inherit the default values defined in the account's Project Permissions Defaults.\"},\"access_level\":{\"type\":\"string\",\"description\":\"Access level for the user in the workspace. Valid options include \\\"edit_tasks\\\", \\\"view_tasks\\\", \\\"edit_time_and_expenses\\\", \\\"view_time_and_expenses\\\",\\n\\\"edit_financials\\\", \\\"view_financials\\\", \\\"admin\\\". Legacy options include \\\"financial\\\", \\\"time_logging\\\", \\\"collaboration\\\".\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"workspace_id\",\"role\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Participation has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/participations/{id}\":{\"get\":{\"summary\":\"Fetching a single Participation\",\"description\":\"This endpoint returns structured Participation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `participations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-participation\",\"tags\":[\"Participations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_roles` (Role) - Retrieves all of the project roles of the participant. The response will include `active_role_ids`, which references the data in the `roles` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `primary_role` (Role) - Retrieves account role of the participant. Only visible when the authenticated user is on the same account the project is on. The response will include `primary_role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user (also known as the participant). The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace` (Workspace) - Retrieves the project. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the resource(s) associated with the participation, ordered alphabetically. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_role` (Role) - Retrieves the primary project role for the participant. The response will include `workspace_role_id`, which references the data in the `roles` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"access_level\"]}}}],\"responses\":{\"200\":{\"description\":\"The Participation has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Participation\",\"description\":\"This endpoint returns structured Participation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `participations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-participation\",\"tags\":[\"Participations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_roles` (Role) - Retrieves all of the project roles of the participant. The response will include `active_role_ids`, which references the data in the `roles` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `primary_role` (Role) - Retrieves account role of the participant. Only visible when the authenticated user is on the same account the project is on. The response will include `primary_role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user (also known as the participant). The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace` (Workspace) - Retrieves the project. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the resource(s) associated with the participation, ordered alphabetically. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_role` (Role) - Retrieves the primary project role for the participant. The response will include `workspace_role_id`, which references the data in the `roles` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"access_level\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"participation\":{\"type\":\"object\",\"properties\":{\"team_lead\":{\"type\":\"boolean\",\"description\":\"Update the role of the participant to be the team lead of the project.\"},\"cost_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Update the cost rate in cents per hour for the participant.\"},\"rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Update the bill rate in cents per hour for the participant.\\nThis bill rate is ignored if Rate cards are enabled on the account.\"},\"workspace_role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the participant's assigned role on a project.\"},\"can_invite\":{\"type\":\"boolean\",\"description\":\"Permission for the participant to invite other users into the project.\"},\"can_schedule_their_hours\":{\"type\":\"boolean\",\"description\":\"Permission for the participant to schedule their own hours.\"},\"can_schedule_team_hours\":{\"type\":\"boolean\",\"description\":\"Permission for the participant to schedule hours for project team members.\"},\"permissions\":{\"type\":\"string\",\"description\":\"Permission for the user in the workspace. It must be any combination of \\\"edit\\\", \\\"view_only\\\", \\\"view_and_post\\\",\\n\\\"can_edit\\\", \\\"can_post\\\", \\\"can_edit_expense\\\", \\\"can_edit_time\\\", \\\"can_invite\\\", \\\"can_schedule_their_hours\\\", or\\n\\\"can_schedule_team_hours\\\" delimited by commas. ex. \\\"can_post,can_edit_time\\\"\\n\\nIf \\\"can_invite\\\", \\\"can_schedule_their_hours\\\", or \\\"can_schedule_team_hours\\\" are not set—either via the individual\\nfields or the `permissions` string—they will inherit the default values defined in the account's Project Permissions Defaults.\"},\"access_level\":{\"type\":\"string\",\"description\":\"Access level for the user in the workspace. Valid options include \\\"edit_tasks\\\", \\\"view_tasks\\\", \\\"edit_time_and_expenses\\\", \\\"view_time_and_expenses\\\",\\n\\\"edit_financials\\\", \\\"view_financials\\\", \\\"admin\\\". Legacy options include \\\"financial\\\", \\\"time_logging\\\", \\\"collaboration\\\".\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Participation has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Participation\",\"description\":\"Removes a participant from a project and deletes their associated project data.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-participation\",\"tags\":[\"Participations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Participation has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/posts\":{\"get\":{\"summary\":\"Fetching a list of Posts\",\"description\":\"This endpoint returns structured Post objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `posts` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-posts\",\"tags\":[\"Posts\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"from_archived_workspaces\",\"description\":\"Also includes posts from archived projects.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `attachments` (Attachments::PostAttachment) - Any attachments associated to the post.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `google_documents` (GoogleDocument) - The post's Google document objects, available in `google_document_ids`; returned in the `google_documents` top-level key.\\n- `newest_reply` (Post) - The most recent reply to the post.\\n- `newest_reply_user` (User) - The user who made the most recent reply to the post.\\n- `recipients` (User) - On private posts, the `recipient_ids` array contains the IDs of recipients, returned in the `users` top-level key.\\n- `replies` (Post) - Replies made to this post, returned in the `posts` top-level key. Posts will contain a `reply_ids` array.\\n- `story` (Story) - The task (if any) to which the post is linked.\\n- `subject` (polymorphic) - When you include this association, posts that are replies will have a `subject_id` key. This references\\ntheir parent post in the `posts` top-level key.\\n- `user` (User) - The user who created the post.\\n- `workspace` (Workspace) - The project to which this post belongs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `newest_reply_at:asc` and `newest_reply_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"newest_reply_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"parents_only\",\"description\":\"Results will only include parent posts (without including replies by themselves).\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"private\",\"description\":\"Only includes posts that are private to the current user.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"search\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"story_id\",\"description\":\"Only includes posts from the specified task.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"story_ids\",\"description\":\"Filter for posts linked to specific tasks. Provide a comma-separated list of task IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Only includes posts from the specified project.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Posts have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_PostAttachment\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Post\",\"description\":\"This endpoint returns structured Post objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `posts` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-post\",\"tags\":[\"Posts\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `attachments` (Attachments::PostAttachment) - Any attachments associated to the post.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `google_documents` (GoogleDocument) - The post's Google document objects, available in `google_document_ids`; returned in the `google_documents` top-level key.\\n- `newest_reply` (Post) - The most recent reply to the post.\\n- `newest_reply_user` (User) - The user who made the most recent reply to the post.\\n- `recipients` (User) - On private posts, the `recipient_ids` array contains the IDs of recipients, returned in the `users` top-level key.\\n- `replies` (Post) - Replies made to this post, returned in the `posts` top-level key. Posts will contain a `reply_ids` array.\\n- `story` (Story) - The task (if any) to which the post is linked.\\n- `subject` (polymorphic) - When you include this association, posts that are replies will have a `subject_id` key. This references\\ntheir parent post in the `posts` top-level key.\\n- `user` (User) - The user who created the post.\\n- `workspace` (Workspace) - The project to which this post belongs.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"post\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project in which the post will be created.\"},\"message\":{\"type\":\"string\",\"description\":\"The content created in the new post.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the item to which the new post is replying (only `required` for replies).\"},\"subject_type\":{\"type\":\"string\",\"description\":\"The type of item to which the new post is replying (only `required` for replies). Accepted values are `Post.`.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the task to which the new post should be linked.\"},\"recipient_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of User IDs for which the post is visible. These users must be participating in the target\\nproject. Including this parameter will make the post private.\"},\"attachment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of PostAttachment IDs to be associated with the post. Create PostAttachments using\\nthe attachments endpoint.\"},\"google_documents\":{\"type\":\"array\",\"description\":\"An array of Google document to be associated with the post.\",\"items\":{\"type\":\"object\",\"properties\":{\"resource_id\":{\"type\":\"string\",\"description\":\"A unique identifier for the Google document.\"},\"access\":{\"type\":\"string\",\"description\":\"Allowed access to the Google document.\"}}}},\"backdated_to\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Backdates the post creation date on imports. Defaults to *Now*. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}},\"required\":[\"workspace_id\",\"message\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Post has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_PostAttachment\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/posts/{id}\":{\"get\":{\"summary\":\"Fetching a single Post\",\"description\":\"By default, you won't receive Posts from archived workspaces (and will receive a 404 status\\non the \\\"show\\\" route) unless you provide the `from_archived_workspaces:true` filter.\\n\\n\\nThis endpoint returns structured Post objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `posts` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-post\",\"tags\":[\"Posts\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `attachments` (Attachments::PostAttachment) - Any attachments associated to the post.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `google_documents` (GoogleDocument) - The post's Google document objects, available in `google_document_ids`; returned in the `google_documents` top-level key.\\n- `newest_reply` (Post) - The most recent reply to the post.\\n- `newest_reply_user` (User) - The user who made the most recent reply to the post.\\n- `recipients` (User) - On private posts, the `recipient_ids` array contains the IDs of recipients, returned in the `users` top-level key.\\n- `replies` (Post) - Replies made to this post, returned in the `posts` top-level key. Posts will contain a `reply_ids` array.\\n- `story` (Story) - The task (if any) to which the post is linked.\\n- `subject` (polymorphic) - When you include this association, posts that are replies will have a `subject_id` key. This references\\ntheir parent post in the `posts` top-level key.\\n- `user` (User) - The user who created the post.\\n- `workspace` (Workspace) - The project to which this post belongs.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Post has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_PostAttachment\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Post\",\"description\":\"This endpoint returns structured Post objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `posts` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-post\",\"tags\":[\"Posts\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `attachments` (Attachments::PostAttachment) - Any attachments associated to the post.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `google_documents` (GoogleDocument) - The post's Google document objects, available in `google_document_ids`; returned in the `google_documents` top-level key.\\n- `newest_reply` (Post) - The most recent reply to the post.\\n- `newest_reply_user` (User) - The user who made the most recent reply to the post.\\n- `recipients` (User) - On private posts, the `recipient_ids` array contains the IDs of recipients, returned in the `users` top-level key.\\n- `replies` (Post) - Replies made to this post, returned in the `posts` top-level key. Posts will contain a `reply_ids` array.\\n- `story` (Story) - The task (if any) to which the post is linked.\\n- `subject` (polymorphic) - When you include this association, posts that are replies will have a `subject_id` key. This references\\ntheir parent post in the `posts` top-level key.\\n- `user` (User) - The user who created the post.\\n- `workspace` (Workspace) - The project to which this post belongs.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"post\":{\"type\":\"object\",\"properties\":{\"message\":{\"type\":\"string\",\"description\":\"The message content of the post.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the task that is linked to the post.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Post has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_PostAttachment\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Post\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-post\",\"tags\":[\"Posts\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Post has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_accounting_records\":{\"get\":{\"summary\":\"Fetching a list of Project Accounting Records\",\"description\":\"Returns all project accounting records (`Baseline`, `Earned Value`, `Earned Value Forecasting`,\\n`Forecasting`,  and `Recognition`), unless filter parameters have been applied.\\n\\n\\nThis endpoint returns structured Project Accounting Records objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_accounting_records` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-project-accounting-records\",\"tags\":[\"Project Accounting Records\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_at\",\"required\":false,\"description\":\"Filters for records created on or after the specified date (e.g. `GET /api/v1/project_accounting_records.json?created_at=2014-02-25`). The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"end_date\",\"required\":false,\"description\":\"Filters for records with accounting periods that end on specified dates.\\n\\nYou can filter for records with an accounting period that ends...\\n* within a date range, with a pair of semicolon-separated dates (e.g. `2019-09-14;2019-09-15`),\\n* on or _after_ a date, with only the date before the semicolon (e.g. `2019-09-14;`),\\n* on or _before_ a date, with only the date after the semicolon (e.g. `;2019-09-14`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"ids\",\"required\":false,\"description\":\"Filters for records with the specified IDs. Give multiple record IDs\\n            in a comma-separated list (e.g. `GET /api/v1/project_accounting_records.json?ids=55,16,73`).\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `role` (Role) - Includes the ID of the role associated with the record.\\n- `story` (Story) - Includes the ID of the task related to the record.\\n- `user` (User) - Includes the ID(s) of user(s) associated with the record\\n                    (e.g. who created the record, who the record was created for, etc.).\\n- `workspace` (Workspace) - Includes the ID of the project the record belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"show_deleted\",\"required\":false,\"description\":\"If `true`, returns only deleted project accounting records. Set to `false` by default.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"start_date\",\"required\":false,\"description\":\"Filters for records with accounting periods that begin on specified dates.\\n\\nYou can filter for records with an accounting period that begins...\\n* within a date range, with a pair of semicolon-separated dates (e.g. `2019-09-14;2019-09-15`),\\n* on or _after_ a date, with only the date before the semicolon (e.g. `2019-09-14;`),\\n* on or _before_ a date, with only the date after the semicolon (e.g. `;2019-09-14`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"status\",\"required\":false,\"description\":\"Filters for records with the specified status.\\n\\nValid values: `Draft`, `Pending Approval`, `Approved`, `Cancelled`.\\n\\n*Note:* Records without a status cannot be returned with this filter.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}},{\"in\":\"query\",\"name\":\"type\",\"description\":\"Only includes Project Accounting Records of the specified type.\\n                    Valid values: `Baseline`, `Earned Value`, `Earned Value Forecasting`, `Forecasting`, `Recognition`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"user_id\",\"description\":\"Only includes Project Accounting Records for the specified user_id.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_ids\",\"required\":false,\"description\":\"Filters for records from projects with the specified IDs. Give multiple project IDs\\n            in a comma-separated list (e.g. `GET /api/v1/project_accounting_records.json?workspace_ids=25344,76545`).\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}}],\"responses\":{\"200\":{\"description\":\"A list of Project Accounting Records have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_accounting_records\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectAccounting_Models_ProjectAccountingRecord\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Project Accounting Records\",\"description\":\"Creates a single or multiple project accounting records.\\n\\nThis endpoint returns structured Project Accounting Records objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_accounting_records` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-project-accounting-record\",\"tags\":[\"Project Accounting Records\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `role` (Role) - Includes the ID of the role associated with the record.\\n- `story` (Story) - Includes the ID of the task related to the record.\\n- `user` (User) - Includes the ID(s) of user(s) associated with the record\\n                    (e.g. who created the record, who the record was created for, etc.).\\n- `workspace` (Workspace) - Includes the ID of the project the record belongs to.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"project_accounting_record\":{\"type\":\"object\",\"description\":\"A single project accounting record and its attributes.\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project the record belongs to.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the accounting period begins,\\n        in ISO8601 format (e.g. `2014-06-25`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the accounting period ends,\\n        in ISO8601 format (e.g. `2014-02-25`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the record. Valid values are\\n        [ISO codes of currencies supported by Kantata OX](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473).\"},\"type\":{\"type\":\"string\",\"description\":\"The type of project accounting record:\\n* `Baseline`\\n* `Earned Value`\\n* `Earned Value Forecasting`\\n* `Forecasting`\\n* `Recognition` (Default)\\n\\nIf not specified, a `Recognition` record is created by default.\\n\\n**Note:** Make sure to include the spaces in `Earned Value` and `Earned Value Forecasting`\\nwhen making a request.\"},\"amount\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The amount being calculated for baseline, forecasting,\\n        earned value, earned value forecasting, or revenue recognition within the specified accounting period,\\n        up to 2 decimal places (e.g. 575.75).\\n        Values can also be negative (e.g. -96.75).\"},\"amount_to_date\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The total amount spent to date\\n        (for all accounting periods), up to 2 decimal places (e.g. 1252.33).\\n        Values can also be negative (e.g. -83.33).\"},\"budget\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The budget of the project or task,\\n        up to 2 decimal places (e.g. 2457.52). Values can also be negative (e.g. -350.52).\"},\"contract_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"This can be a contract's start or end date in ISO8601 format,\\n        or any other date a user prefers. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"cost\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The cost of the project or task within the specified accounting period,\\n        up to 2 decimal places (e.g. 3003.56). Values can also be negative (e.g. -350.72).\"},\"cost_eac\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The\\n        [estimated cost](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n        of the project or task when it is completed, up to 2 decimal places (e.g. 8326.55).\\n        Values can also be negative (e.g. -426.55).\\n        This updates during the course of a project or task, as costs are logged.\"},\"description\":{\"type\":\"string\",\"description\":\"This can be a brief description of the record,\\n        or anything a user prefers.\"},\"fees\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The fees from the specified accounting period,\\n        up to 2 decimal places (e.g. 324.53). Values can also be negative (e.g. -41.53).\"},\"hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The [hours](https://mavenlink.zendesk.com/hc/en-us/articles/360059325413)\\n        spent within the specified accounting period, up to 2 decimal places (e.g. 23.25).\\n        Values can also be negative (e.g. -7.25).\"},\"hours_eac\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The\\n        [estimated hours](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n        for the project or task when it is completed, up to 2 decimal places (e.g. 82.25).\\n        Values can also be negative (e.g. -22.25).\\n        This updates during the course of a project or task, as hours are logged.\"},\"hours_etc\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The\\n        [estimated hours](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n        until completion (`hours_eac` - `hours`) of the project or task, up to two decimal places (e.g. 53.25).\\n        Values can also be negative (e.g. -10.25).\"},\"total_estimated_hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The hours initially estimated for the project or task,\\n        up to 2 decimal places (e.g. 83.50). Values can also be negative (e.g. -12.25).\\n        This value does not change over the course of a project.\"},\"total_hours_to_date\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The total hours logged to date for the project or task,\\n        up to 2 decimal places (e.g. 32.25). Values can also be negative (e.g. -5.75).\"},\"labor_type\":{\"type\":\"string\",\"description\":\"The type of cost associated with the record.\\n        Valid values are `labor` or `non-labor`.\"},\"notes\":{\"type\":\"string\",\"description\":\"This can be any extra information to note about the record.\"},\"percent_complete\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"How much of the project or task is complete\\n        in decimal format, up to 2 places (e.g. 0.75). Values can also be negative (e.g. -.25).\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the role associated with the record.\"},\"service_type\":{\"type\":\"string\",\"description\":\"This can be an organization-specific category of services\\n        that is related to the record (e.g. Branding, Campaigns, Photography, etc.).\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the record.\\n        Valid values: `Draft`, `Pending Approval`, `Approved`, `Cancelled`.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the task related to the record.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user associated with the record\\n        (e.g. who created the record, who the record was created for, etc.).\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"workspace_id\",\"start_date\",\"end_date\",\"currency\"]},\"project_accounting_records\":{\"type\":\"array\",\"description\":\"Multiple project accounting records and their attributes in an array.\",\"items\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project the record belongs to.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the accounting period begins,\\n        in ISO8601 format (e.g. `2014-06-25`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the accounting period ends,\\n        in ISO8601 format (e.g. `2014-02-25`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the record. Valid values are\\n        [ISO codes of currencies supported by Kantata OX](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473).\"},\"type\":{\"type\":\"string\",\"description\":\"The type of project accounting record:\\n* `Baseline`\\n* `Earned Value`\\n* `Earned Value Forecasting`\\n* `Forecasting`\\n* `Recognition` (Default)\\n\\nIf not specified, a `Recognition` record is created by default.\\n\\n**Note:** Make sure to include the spaces in `Earned Value` and `Earned Value Forecasting`\\nwhen making a request.\"},\"amount\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The amount being calculated for baseline, forecasting,\\n        earned value, earned value forecasting, or revenue recognition within the specified accounting period,\\n        up to 2 decimal places (e.g. 575.75).\\n        Values can also be negative (e.g. -96.75).\"},\"amount_to_date\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The total amount spent to date\\n        (for all accounting periods), up to 2 decimal places (e.g. 1252.33).\\n        Values can also be negative (e.g. -83.33).\"},\"budget\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The budget of the project or task,\\n        up to 2 decimal places (e.g. 2457.52). Values can also be negative (e.g. -350.52).\"},\"contract_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"This can be a contract's start or end date in ISO8601 format,\\n        or any other date a user prefers. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"cost\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The cost of the project or task within the specified accounting period,\\n        up to 2 decimal places (e.g. 3003.56). Values can also be negative (e.g. -350.72).\"},\"cost_eac\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The\\n        [estimated cost](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n        of the project or task when it is completed, up to 2 decimal places (e.g. 8326.55).\\n        Values can also be negative (e.g. -426.55).\\n        This updates during the course of a project or task, as costs are logged.\"},\"description\":{\"type\":\"string\",\"description\":\"This can be a brief description of the record,\\n        or anything a user prefers.\"},\"fees\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The fees from the specified accounting period,\\n        up to 2 decimal places (e.g. 324.53). Values can also be negative (e.g. -41.53).\"},\"hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The [hours](https://mavenlink.zendesk.com/hc/en-us/articles/360059325413)\\n        spent within the specified accounting period, up to 2 decimal places (e.g. 23.25).\\n        Values can also be negative (e.g. -7.25).\"},\"hours_eac\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The\\n        [estimated hours](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n        for the project or task when it is completed, up to 2 decimal places (e.g. 82.25).\\n        Values can also be negative (e.g. -22.25).\\n        This updates during the course of a project or task, as hours are logged.\"},\"hours_etc\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The\\n        [estimated hours](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n        until completion (`hours_eac` - `hours`) of the project or task, up to two decimal places (e.g. 53.25).\\n        Values can also be negative (e.g. -10.25).\"},\"total_estimated_hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The hours initially estimated for the project or task,\\n        up to 2 decimal places (e.g. 83.50). Values can also be negative (e.g. -12.25).\\n        This value does not change over the course of a project.\"},\"total_hours_to_date\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The total hours logged to date for the project or task,\\n        up to 2 decimal places (e.g. 32.25). Values can also be negative (e.g. -5.75).\"},\"labor_type\":{\"type\":\"string\",\"description\":\"The type of cost associated with the record.\\n        Valid values are `labor` or `non-labor`.\"},\"notes\":{\"type\":\"string\",\"description\":\"This can be any extra information to note about the record.\"},\"percent_complete\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"How much of the project or task is complete\\n        in decimal format, up to 2 places (e.g. 0.75). Values can also be negative (e.g. -.25).\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the role associated with the record.\"},\"service_type\":{\"type\":\"string\",\"description\":\"This can be an organization-specific category of services\\n        that is related to the record (e.g. Branding, Campaigns, Photography, etc.).\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the record.\\n        Valid values: `Draft`, `Pending Approval`, `Approved`, `Cancelled`.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the task related to the record.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user associated with the record\\n        (e.g. who created the record, who the record was created for, etc.).\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"workspace_id\",\"start_date\",\"end_date\",\"currency\"]}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Project Accounting Records has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_accounting_records\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectAccounting_Models_ProjectAccountingRecord\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_accounting_records/delete\":{\"put\":{\"summary\":\"Soft Deleting a Project Accounting Record\",\"description\":\"Soft deletes a specified project accounting record. View deleted records by\\nFetching a list of Project Accounting Records with the `show_deleted` filter set to `true`.\\n\\n\\nThis endpoint returns structured Project Accounting Records objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_accounting_records` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"soft-delete-project-accounting-record\",\"tags\":[\"Project Accounting Records\"],\"parameters\":[{\"in\":\"query\",\"name\":\"csv_file\",\"required\":false,\"description\":\"The ID(s) of record(s) to delete, in a\\n            [.csv file](https://app.mavenlink.com/sample_remove_project_accounting_records.csv)\\n            with rows/lines of ID numbers under a header of `ID`.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"ids\",\"required\":false,\"description\":\"The ID(s) of record(s) to delete, in an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `role` (Role) - Includes the ID of the role associated with the record.\\n- `story` (Story) - Includes the ID of the task related to the record.\\n- `user` (User) - Includes the ID(s) of user(s) associated with the record\\n                    (e.g. who created the record, who the record was created for, etc.).\\n- `workspace` (Workspace) - Includes the ID of the project the record belongs to.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Project Accounting Records has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_accounting_records\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectAccounting_Models_ProjectAccountingRecord\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_accounting_records/export_to_csv\":{\"get\":{\"summary\":\"Exporting Project Account Records in a CSV\",\"description\":\"Downloads a .csv file of all project accounting records.\\n\\n\\nThis endpoint returns structured Project Accounting Records objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_accounting_records` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"export-project-accounting-record-to-csv\",\"tags\":[\"Project Accounting Records\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `role` (Role) - Includes the ID of the role associated with the record.\\n- `story` (Story) - Includes the ID of the task related to the record.\\n- `user` (User) - Includes the ID(s) of user(s) associated with the record\\n                    (e.g. who created the record, who the record was created for, etc.).\\n- `workspace` (Workspace) - Includes the ID of the project the record belongs to.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Project Accounting Records have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_accounting_records\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectAccounting_Models_ProjectAccountingRecord\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_accounting_records/import_csv\":{\"post\":{\"summary\":\"Importing Project Account Records in a CSV\",\"description\":\"Imports up to 5000 project accounting records with a\\n[csv file](https://app.mavenlink.com/sample_import_project_accounting_records.csv)\\nwith a .txt or .csv extension.\\n\\nEach row/line is a record, and each record has attributes. Headers\\nindicate which attributes are being specified for imported records.\\nHeaders can include:\\n\\n* **Project ID** (required)\\n* **Story ID**\\n* **Role ID**\\n* **User ID**\\n* **Type** (recommended)\\n* **Period Start Date** (required)\\n* **Period End Date** (required)\\n* **Contract Date**\\n* **Currency** (required)\\n* **Amount**\\n* **Amount To Date**\\n* **Budget**\\n* **Cost**\\n* **Cost EAC**\\n* **Fees**\\n* **Labor Type**\\n* **Hours**\\n* **Hours EAC**\\n* **Hours ETC**\\n* **Total Estimated Hours**\\n* **Total Hours to Date**\\n* **Percent Complete**\\n* **Status**\\n* **Service Type**\\n* **Description**\\n* **Notes**\\n\\nOnly **Project ID**, **Period Start Date**, **Period End Date**,\\nand **Currency** are required for a csv import. But when it is not specified,\\n**Type** defaults to `Recognition`. Other valid values for **Type** are\\n`Baseline`, `Earned Value`, `Earned Value Forecasting`, and `Forecasting`.\\n\\n\\nThis endpoint returns structured Project Accounting Records objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_accounting_records` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"import-project-accounting-records\",\"tags\":[\"Project Accounting Records\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `role` (Role) - Includes the ID of the role associated with the record.\\n- `story` (Story) - Includes the ID of the task related to the record.\\n- `user` (User) - Includes the ID(s) of user(s) associated with the record\\n                    (e.g. who created the record, who the record was created for, etc.).\\n- `workspace` (Workspace) - Includes the ID of the project the record belongs to.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Project Accounting Records has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_accounting_records\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectAccounting_Models_ProjectAccountingRecord\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_accounting_records/{id}\":{\"get\":{\"summary\":\"Fetching a single Project Accounting Records\",\"description\":\"Returns a specified project accounting record.\\n\\n\\nThis endpoint returns structured Project Accounting Records objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_accounting_records` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-project-accounting-record\",\"tags\":[\"Project Accounting Records\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `role` (Role) - Includes the ID of the role associated with the record.\\n- `story` (Story) - Includes the ID of the task related to the record.\\n- `user` (User) - Includes the ID(s) of user(s) associated with the record\\n                    (e.g. who created the record, who the record was created for, etc.).\\n- `workspace` (Workspace) - Includes the ID of the project the record belongs to.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Project Accounting Records has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_accounting_records\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectAccounting_Models_ProjectAccountingRecord\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_snapshots\":{\"get\":{\"summary\":\"Fetching a list of Project Snapshots\",\"description\":\"Gets a list of Project Snapshots. You can only see snapshots for projects where you have the Edit Financials project permission or higher.\\n\\n\\nThis endpoint returns structured Project Snapshots objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_snapshots` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-project-snapshots\",\"tags\":[\"Project Snapshots\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_title\",\"description\":\"Filter for snapshots with a title that match the specified search term. This filter is not case sensitive.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_snapshot_assignments` (Project::Snapshots::Models::ProjectSnapshotAssignment) - Retrieves task assignments saved in snapshots. The response will include `project_snapshot_assignment_ids`, which references the data in the `project_snapshot_assignments` top-level key.\\n- `project_snapshot_custom_field_values` (Project::Snapshots::Models::ProjectSnapshotCustomFieldValue) - Retrieves project custom fields saved in snapshots. The response will include `project_snapshot_custom_field_value_ids`, which references the data in the `project_snapshot_custom_field_values` top-level key.\\n- `project_snapshot_resources` (Project::Snapshots::Models::ProjectSnapshotResource) - Retrieves the resources saved in snapshots. The response will include `project_snapshot_resource_ids`, which references the data in the `project_snapshot_resources` top-level key.\\n- `project_snapshot_task_custom_field_values` (Project::Snapshots::Models::ProjectSnapshotCustomFieldValue) - Retrieves task custom fields saved in snapshots. The response will include `project_snapshot_task_custom_field_value_ids`, which references the data in the `project_snapshot_custom_field_values` top-level key.\\n- `project_snapshot_tasks` (Project::Snapshots::Models::ProjectSnapshotTask) - Retrieves the tasks saved in snapshots. The response will include `project_snapshot_task_ids`, which references the data in the `project_snapshot_tasks` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter for snapshots by workspace ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Project Snapshots have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_snapshots\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshot\"}},\"project_snapshot_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotResource\"}},\"project_snapshot_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotTask\"}},\"project_snapshot_custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotCustomFieldValue\"}},\"project_snapshot_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotAssignment\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a Project Snapshot\",\"description\":\"Creates a Project Snapshot. You must have the Edit Financials project permission or higher to create a project snapshot. \\n\\nThis endpoint has its own rate limit. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for more information.\\n\\n\\nThis endpoint returns structured Project Snapshots objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_snapshots` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-project-snapshot\",\"tags\":[\"Project Snapshots\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_snapshot_assignments` (Project::Snapshots::Models::ProjectSnapshotAssignment) - Retrieves task assignments saved in snapshots. The response will include `project_snapshot_assignment_ids`, which references the data in the `project_snapshot_assignments` top-level key.\\n- `project_snapshot_custom_field_values` (Project::Snapshots::Models::ProjectSnapshotCustomFieldValue) - Retrieves project custom fields saved in snapshots. The response will include `project_snapshot_custom_field_value_ids`, which references the data in the `project_snapshot_custom_field_values` top-level key.\\n- `project_snapshot_resources` (Project::Snapshots::Models::ProjectSnapshotResource) - Retrieves the resources saved in snapshots. The response will include `project_snapshot_resource_ids`, which references the data in the `project_snapshot_resources` top-level key.\\n- `project_snapshot_task_custom_field_values` (Project::Snapshots::Models::ProjectSnapshotCustomFieldValue) - Retrieves task custom fields saved in snapshots. The response will include `project_snapshot_task_custom_field_value_ids`, which references the data in the `project_snapshot_custom_field_values` top-level key.\\n- `project_snapshot_tasks` (Project::Snapshots::Models::ProjectSnapshotTask) - Retrieves the tasks saved in snapshots. The response will include `project_snapshot_task_ids`, which references the data in the `project_snapshot_tasks` top-level key.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"project_snapshot\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the workspace to take a snapshot of.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the snapshot.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the snapshot.\"},\"replace_baseline\":{\"type\":\"boolean\",\"description\":\"Whether the snapshot should be set as the workspace's baseline.\"}},\"required\":[\"workspace_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Project Snapshots has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_snapshots\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshot\"}},\"project_snapshot_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotResource\"}},\"project_snapshot_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotTask\"}},\"project_snapshot_custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotCustomFieldValue\"}},\"project_snapshot_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotAssignment\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_snapshots/{id}\":{\"put\":{\"summary\":\"Updating a Project Snapshot\",\"description\":\"Updates the metadata of a Project Snapshot.\\n\\n\\nThis endpoint returns structured Project Snapshots objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_snapshots` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-project-snapshot\",\"tags\":[\"Project Snapshots\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_snapshot_assignments` (Project::Snapshots::Models::ProjectSnapshotAssignment) - Retrieves task assignments saved in snapshots. The response will include `project_snapshot_assignment_ids`, which references the data in the `project_snapshot_assignments` top-level key.\\n- `project_snapshot_custom_field_values` (Project::Snapshots::Models::ProjectSnapshotCustomFieldValue) - Retrieves project custom fields saved in snapshots. The response will include `project_snapshot_custom_field_value_ids`, which references the data in the `project_snapshot_custom_field_values` top-level key.\\n- `project_snapshot_resources` (Project::Snapshots::Models::ProjectSnapshotResource) - Retrieves the resources saved in snapshots. The response will include `project_snapshot_resource_ids`, which references the data in the `project_snapshot_resources` top-level key.\\n- `project_snapshot_task_custom_field_values` (Project::Snapshots::Models::ProjectSnapshotCustomFieldValue) - Retrieves task custom fields saved in snapshots. The response will include `project_snapshot_task_custom_field_value_ids`, which references the data in the `project_snapshot_custom_field_values` top-level key.\\n- `project_snapshot_tasks` (Project::Snapshots::Models::ProjectSnapshotTask) - Retrieves the tasks saved in snapshots. The response will include `project_snapshot_task_ids`, which references the data in the `project_snapshot_tasks` top-level key.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"project_snapshot\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the snapshot to update.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the snapshot.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the snapshot.\"},\"replace_baseline\":{\"type\":\"boolean\",\"description\":\"Whether the snapshot should be set as the workspace's baseline.\"}},\"required\":[\"id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Project Snapshots has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_snapshots\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshot\"}},\"project_snapshot_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotResource\"}},\"project_snapshot_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotTask\"}},\"project_snapshot_custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotCustomFieldValue\"}},\"project_snapshot_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Project_Snapshots_Models_ProjectSnapshotAssignment\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_template_additional_tabs\":{\"get\":{\"summary\":\"Fetching a list of Project Template Additional Tabs\",\"description\":\"This endpoint returns structured Project Template Additional Tab objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_template_additional_tabs` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-project-template-additional-tabs\",\"tags\":[\"Project Template Additional Tabs\"],\"parameters\":[{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `updated_at:asc` and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"project_template_id\",\"description\":\"Filter by project template ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Project Template Additional Tabs have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_template_additional_tabs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAdditionalTab\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Project Template Additional Tab\",\"description\":\"Adds an additional tab to a project template.\\n\\n\\nThis endpoint returns structured Project Template Additional Tab objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_template_additional_tabs` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-project-template-additional-tab\",\"tags\":[\"Project Template Additional Tabs\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"project_template_additional_tab\":{\"type\":\"object\",\"properties\":{\"project_template_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the template to add the additional tab to.\"},\"tab_type\":{\"type\":\"string\",\"description\":\"The type of the additional tab. Options are `form` and `dashboard` (i.e. an Insights dynamic dashboard).\"},\"associated_tab_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the form or dynamic dashboard.\"}},\"required\":[\"project_template_id\",\"tab_type\",\"associated_tab_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Project Template Additional Tab has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_template_additional_tabs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAdditionalTab\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_template_additional_tabs/{id}\":{\"delete\":{\"summary\":\"Deleting an existing Project Template Additional Tab\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-project-template-additional-tab\",\"tags\":[\"Project Template Additional Tabs\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Project Template Additional Tab has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_template_assignments\":{\"get\":{\"summary\":\"Fetching a list of Project Template Assignments\",\"description\":\"This endpoint returns structured Project Template Assignment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_template_assignments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-project-template-assignments\",\"tags\":[\"Project Template Assignments\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_template` (ProjectTemplate) - The project template associated with the assignment.\\n- `role` (Role).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"total_estimated_minutes\",\"total_count\",\"role_initials\",\"role_name\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `updated_at:asc` and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"project_template_id\",\"required\":false,\"description\":\"Limits project template assignments to a specific project template.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Project Template Assignments have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_template_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAssignment\"}},\"project_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplate\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Project Template Assignment\",\"description\":\"This endpoint returns structured Project Template Assignment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_template_assignments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-project-template-assignment\",\"tags\":[\"Project Template Assignments\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_template` (ProjectTemplate) - The project template associated with the assignment.\\n- `role` (Role).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"total_estimated_minutes\",\"total_count\",\"role_initials\",\"role_name\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"project_template_assignment\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of resource or assignment placeholder for the associated project template.\"},\"project_template_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated project template.\"}},\"required\":[\"name\",\"project_template_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Project Template Assignment has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_template_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAssignment\"}},\"project_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplate\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_template_assignments/{id}\":{\"get\":{\"summary\":\"Fetching a single Project Template Assignment\",\"description\":\"This endpoint returns structured Project Template Assignment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_template_assignments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-project-template-assignment\",\"tags\":[\"Project Template Assignments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_template` (ProjectTemplate) - The project template associated with the assignment.\\n- `role` (Role).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"total_estimated_minutes\",\"total_count\",\"role_initials\",\"role_name\"]}}}],\"responses\":{\"200\":{\"description\":\"The Project Template Assignment has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_template_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAssignment\"}},\"project_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplate\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Project Template Assignment\",\"description\":\"This endpoint returns structured Project Template Assignment objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_template_assignments` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-project-template-assignment\",\"tags\":[\"Project Template Assignments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_template` (ProjectTemplate) - The project template associated with the assignment.\\n- `role` (Role).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"total_estimated_minutes\",\"total_count\",\"role_initials\",\"role_name\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"project_template_assignment\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of resource or assignment placeholder for the associated project template.\"}},\"required\":[\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Project Template Assignment has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_template_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAssignment\"}},\"project_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplate\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Project Template Assignment\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-project-template-assignment\",\"tags\":[\"Project Template Assignments\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Project Template Assignment has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_templates\":{\"get\":{\"summary\":\"Fetching a list of Project Templates\",\"description\":\"This endpoint returns structured Project Template objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_templates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-project-templates\",\"tags\":[\"Project Templates\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_title\",\"description\":\"Only includes project templates where the title matches the specified search.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_template_additional_tabs` (ProjectTemplateAdditionalTab) - Retrieves the additional tabs added to the template. The response will include `project_template_additional_tab_ids`, which references the data in the `project_template_additional_tabs` top-level key.\\n- `project_template_assignments` (ProjectTemplateAssignment) - Project template assignments associated with the project template.\\n- `user` (User) - The user who created the project template (referenced by user_id).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Alias of by_title.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"mine\",\"description\":\"Only includes project templates created by the requesting user.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"raw_json\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `budget:asc`, `budget:desc`, `description:asc`, `description:desc`, `duration:asc`, `duration:desc`, `full_name:asc`, `full_name:desc`, `is_budgeted:asc`, `is_budgeted:desc`, `title:asc`, `title:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Project Templates have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplate\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"project_template_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAssignment\"}},\"project_template_additional_tabs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAdditionalTab\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Project Template\",\"description\":\"This endpoint returns structured Project Template objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_templates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-project-template\",\"tags\":[\"Project Templates\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_template_additional_tabs` (ProjectTemplateAdditionalTab) - Retrieves the additional tabs added to the template. The response will include `project_template_additional_tab_ids`, which references the data in the `project_template_additional_tabs` top-level key.\\n- `project_template_assignments` (ProjectTemplateAssignment) - Project template assignments associated with the project template.\\n- `user` (User) - The user who created the project template (referenced by user_id).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"raw_json\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"project_template\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title of the project template.\"},\"sharing\":{\"type\":\"string\",\"description\":\"The sharing setting for the template. Viewable and editable templates can be seen by users on the account other than the creator.\",\"enum\":[\"private_template\",\"viewable_template\",\"editable_template\"]},\"is_budgeted\":{\"type\":\"boolean\",\"description\":\"The project template has financial attributes including overall budget, task budgets, and task time estimates.\"},\"budget\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated overall budget of the project associated with the template.\"},\"duration\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated number of days that the associated project will take.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the project template.\"},\"description\":{\"type\":\"string\",\"description\":\"A description of the project template which does not carry over to the project description when applied.\"},\"raw_json\":{\"type\":\"string\",\"description\":\"A JSON hash that contains all project templates' tasks.\"}},\"required\":[\"title\",\"currency\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Project Template has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplate\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"project_template_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAssignment\"}},\"project_template_additional_tabs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAdditionalTab\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/project_templates/{id}\":{\"get\":{\"summary\":\"Fetching a single Project Template\",\"description\":\"This endpoint returns structured Project Template objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_templates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-project-template\",\"tags\":[\"Project Templates\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_template_additional_tabs` (ProjectTemplateAdditionalTab) - Retrieves the additional tabs added to the template. The response will include `project_template_additional_tab_ids`, which references the data in the `project_template_additional_tabs` top-level key.\\n- `project_template_assignments` (ProjectTemplateAssignment) - Project template assignments associated with the project template.\\n- `user` (User) - The user who created the project template (referenced by user_id).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"raw_json\"]}}}],\"responses\":{\"200\":{\"description\":\"The Project Template has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplate\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"project_template_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAssignment\"}},\"project_template_additional_tabs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAdditionalTab\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Project Template\",\"description\":\"This endpoint returns structured Project Template objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `project_templates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-project-template\",\"tags\":[\"Project Templates\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `project_template_additional_tabs` (ProjectTemplateAdditionalTab) - Retrieves the additional tabs added to the template. The response will include `project_template_additional_tab_ids`, which references the data in the `project_template_additional_tabs` top-level key.\\n- `project_template_assignments` (ProjectTemplateAssignment) - Project template assignments associated with the project template.\\n- `user` (User) - The user who created the project template (referenced by user_id).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"raw_json\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"project_template\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title of the project template.\"},\"sharing\":{\"type\":\"string\",\"description\":\"The sharing setting for the template. Viewable and editable templates can be seen by users on the account other than the creator.\",\"enum\":[\"private_template\",\"viewable_template\",\"editable_template\"]},\"is_budgeted\":{\"type\":\"boolean\",\"description\":\"The project template has financial attributes including overall budget, task budgets, and task time estimates.\"},\"budget\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated overall budget of the project associated with the template.\"},\"duration\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated number of days that the associated project will take to complete.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the project template.\"},\"description\":{\"type\":\"string\",\"description\":\"A description of the project template which does not carry over to the project description when applied.\"},\"raw_json\":{\"type\":\"string\",\"description\":\"A JSON hash that contains all project templates' tasks.\"}},\"required\":[\"title\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Project Template has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"project_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplate\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"project_template_assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAssignment\"}},\"project_template_additional_tabs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProjectTemplateAdditionalTab\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Project Template\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-project-template\",\"tags\":[\"Project Templates\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Project Template has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/proof_review_participations\":{\"get\":{\"summary\":\"Fetching a list of Proof Review Participations\",\"description\":\"This endpoint returns structured Proof Review Participation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_review_participations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-proof-review-participations\",\"tags\":[\"Proof Review Participations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `proof_review` (ProofReview) - The ProofReview associated with the ProofReviewParticipation.\\n- `user` (User) - The user associated with the ProofReviewParticipation.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Proof Review Participations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_review_participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReviewParticipation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/proof_review_participations/{id}\":{\"put\":{\"summary\":\"Updating an existing Proof Review Participation\",\"description\":\"This endpoint returns structured Proof Review Participation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_review_participations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-proof-review-participation\",\"tags\":[\"Proof Review Participations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `proof_review` (ProofReview) - The ProofReview associated with the ProofReviewParticipation.\\n- `user` (User) - The user associated with the ProofReviewParticipation.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"proof_review_participation\":{\"type\":\"object\",\"properties\":{\"status\":{\"type\":\"string\",\"description\":\"The status of the user's participation. This can move from 'in_progress' to 'rejected' or 'approved'.\"}},\"required\":[\"status\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Proof Review Participation has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_review_participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReviewParticipation\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/proof_reviews\":{\"get\":{\"summary\":\"Fetching a list of Proof Reviews\",\"description\":\"This endpoint returns structured Proof Review objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_reviews` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-proof-reviews\",\"tags\":[\"Proof Reviews\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `participations` (ProofReviewParticipation) - Represents the user assigned to review the proof, along with any actions they have taken on it.\\n- `proof_revision` (ProofRevision) - The version to which this review is associated.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"proof_revision_id\",\"description\":\"Scoped to the specified proof revision.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Proof Reviews have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}},\"proof_review_participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReviewParticipation\"}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Proof Review\",\"description\":\"This endpoint returns structured Proof Review objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_reviews` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-proof-review\",\"tags\":[\"Proof Reviews\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `participations` (ProofReviewParticipation) - Represents the user assigned to review the proof, along with any actions they have taken on it.\\n- `proof_revision` (ProofRevision) - The version to which this review is associated.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"proof_review\":{\"type\":\"object\",\"properties\":{\"proof_revision_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the proof revision on which the review is created.\"},\"user_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of all users added as participants in the proof review.\"}},\"required\":[\"proof_revision_id\",\"user_ids\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Proof Review has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}},\"proof_review_participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReviewParticipation\"}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/proof_reviews/{id}\":{\"put\":{\"summary\":\"Updating an existing Proof Review\",\"description\":\"This endpoint returns structured Proof Review objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_reviews` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-proof-review\",\"tags\":[\"Proof Reviews\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `participations` (ProofReviewParticipation) - Represents the user assigned to review the proof, along with any actions they have taken on it.\\n- `proof_revision` (ProofRevision) - The version to which this review is associated.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"proof_review\":{\"type\":\"object\",\"properties\":{\"status\":{\"type\":\"string\",\"description\":\"The creator or Project Administrator can update the status to in_progress to continue a rejected review.\\nThis sets the status of the participant who rejected it to *waiting*.\"}},\"required\":[\"status\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Proof Review has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}},\"proof_review_participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReviewParticipation\"}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Proof Review\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-proof-review\",\"tags\":[\"Proof Reviews\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Proof Review has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/proof_revisions\":{\"get\":{\"summary\":\"Fetching a list of Proof Revisions\",\"description\":\"This endpoint returns structured Proof Revision objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_revisions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-proof-revisions\",\"tags\":[\"Proof Revisions\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `proof` (Proof)\\n- `proof_review` (ProofReview).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `revision_date:asc` and `revision_date:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"revision_date:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Proof Revisions have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Proof Revision\",\"description\":\"This endpoint returns structured Proof Revision objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_revisions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-proof-revision\",\"tags\":[\"Proof Revisions\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `proof` (Proof)\\n- `proof_review` (ProofReview).\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"proof_revision\":{\"type\":\"object\",\"properties\":{\"proof_id\":{\"type\":\"integer\",\"format\":\"int32\"},\"attachment_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the ProofAttachment associated with the revision.\"},\"title\":{\"type\":\"string\"}},\"required\":[\"proof_id\",\"attachment_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Proof Revision has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/proof_revisions/{id}\":{\"get\":{\"summary\":\"Fetching a single Proof Revision\",\"description\":\"This endpoint returns structured Proof Revision objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_revisions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-proof-revision\",\"tags\":[\"Proof Revisions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `proof` (Proof)\\n- `proof_review` (ProofReview).\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Proof Revision has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Proof Revision\",\"description\":\"This endpoint returns structured Proof Revision objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proof_revisions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-proof-revision\",\"tags\":[\"Proof Revisions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `proof` (Proof)\\n- `proof_review` (ProofReview).\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"proof_revision\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Proof Revision has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"proof_reviews\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofReview\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/proofs\":{\"get\":{\"summary\":\"Fetching a list of Proofs\",\"description\":\"Proofs are assets, belonging to a task that has been uploaded for review. Although they can have\\nseveral revisions, proofs only have a single *current* revision.\\n\\n\\nThis endpoint returns structured Proof objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proofs` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-proofs\",\"tags\":[\"Proofs\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_story\",\"description\":\"By proofs associated to a task.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_workspace\",\"description\":\"By proofs associated to a project (through their tasks).\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `current_revision` (ProofRevision)\\n- `revisions` (ProofRevision)\\n- `story` (Story).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"By matching title.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `associated_task:asc`, `associated_task:desc`, `created_at:asc`, `created_at:desc`, `creator_name:asc`, `creator_name:desc`, `revision_date:asc`, `revision_date:desc`, `title:asc`, and `title:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Proofs have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Proof\",\"description\":\"This endpoint returns structured Proof objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proofs` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-proof\",\"tags\":[\"Proofs\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `current_revision` (ProofRevision)\\n- `revisions` (ProofRevision)\\n- `story` (Story).\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"proof\":{\"type\":\"object\",\"properties\":{\"story_id\":{\"type\":\"string\",\"description\":\"The task to which the proof will be added.\"},\"attachment_id\":{\"type\":\"string\",\"description\":\"The attachment the proof references.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the proof.\"}},\"required\":[\"story_id\",\"attachment_id\",\"title\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Proof has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/proofs/{id}\":{\"get\":{\"summary\":\"Fetching a single Proof\",\"description\":\"This endpoint returns structured Proof objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proofs` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-proof\",\"tags\":[\"Proofs\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `current_revision` (ProofRevision)\\n- `revisions` (ProofRevision)\\n- `story` (Story).\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Proof has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Proof\",\"description\":\"This endpoint returns structured Proof objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `proofs` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-proof\",\"tags\":[\"Proofs\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `current_revision` (ProofRevision)\\n- `revisions` (ProofRevision)\\n- `story` (Story).\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"proof\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title of the proof.\"}},\"required\":[\"title\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Proof has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"proof_revisions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ProofRevision\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Proof\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-proof\",\"tags\":[\"Proofs\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Proof has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_roles\":{\"get\":{\"summary\":\"Fetching a list of Rate Card Roles\",\"description\":\"Returns the Rate Card Roles associated with all Rate Card Versions on Rate Cards that belong to the logged-in user's account.\\n\\nRate Card Roles can only be accessed by an Administrator on the account.\\n\\n\\nThis endpoint returns structured Rate Card Role objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_roles` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card-roles\",\"tags\":[\"Rate Card Role (Rate for a Role)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_version` (RateCardVersion) - The Rate Card Version to which this Rate Card Role belongs.\\n- `role` (Role) - The account Role that this Rate Card Role represents.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"rate_card_version_id\",\"description\":\"Restricts Rate Card Roles to the specified Rate Card Version.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_role_ids\",\"description\":\"Restricts Rate Card Roles to the specified role ids.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}}],\"responses\":{\"200\":{\"description\":\"A list of Rate Card Roles have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardRole\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Rate Card Role\",\"description\":\"A Rate Card Role can only be created by an Administrator on the account.\\n\\n\\nThis endpoint returns structured Rate Card Role objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_roles` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-rate-card-role\",\"tags\":[\"Rate Card Role (Rate for a Role)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_version` (RateCardVersion) - The Rate Card Version to which this Rate Card Role belongs.\\n- `role` (Role) - The account Role that this Rate Card Role represents.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card_role\":{\"type\":\"object\",\"properties\":{\"rate_card_version_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Rate Card Version to which the Rate Card Role belongs.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Role being represented by the Rate Card Role.\"},\"rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The bill rate, in cents per hour, for the associated role.\"}},\"required\":[\"rate_card_version_id\",\"role_id\",\"rate\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card Role has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardRole\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_roles/{id}\":{\"get\":{\"summary\":\"Fetching a single Rate Card Role\",\"description\":\"A Rate Card Role can only be accessed by an Administrator on the account.\\n\\n\\nThis endpoint returns structured Rate Card Role objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_roles` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card-role\",\"tags\":[\"Rate Card Role (Rate for a Role)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_version` (RateCardVersion) - The Rate Card Version to which this Rate Card Role belongs.\\n- `role` (Role) - The account Role that this Rate Card Role represents.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Rate Card Role has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardRole\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Rate Card Role\",\"description\":\"A Rate Card Role can only be modified by an Administrator on the account.\\n\\n\\nThis endpoint returns structured Rate Card Role objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_roles` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-rate-card-role\",\"tags\":[\"Rate Card Role (Rate for a Role)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_version` (RateCardVersion) - The Rate Card Version to which this Rate Card Role belongs.\\n- `role` (Role) - The account Role that this Rate Card Role represents.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card_role\":{\"type\":\"object\",\"properties\":{\"rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The bill rate, in cents per hour, for the associated role.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card Role has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardRole\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Rate Card Role\",\"description\":\"If a A Rate Card Role belongs to a Rate Card Version that is in use, it cannot be deleted. A Rate Card Role can\\nonly be deleted by an Administrator on the account.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-rate-card-role\",\"tags\":[\"Rate Card Role (Rate for a Role)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Rate Card Role has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_set_versions\":{\"get\":{\"summary\":\"Fetching a list of Rate Card Set Versions\",\"description\":\"Rate Card Set Versions are only accessible to Administrators on the account.\\n\\n\\nThis endpoint returns structured Rate Card Set Version objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_set_versions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card-set-versions\",\"tags\":[\"Rate Card Set Version (Effective version by Date)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"effective_on_date\",\"description\":\"Returns Rate Card Set Versions that are effective on the requested date.\\nThe date should be in `<ISO_8601 Date Format>` eg. `'2014-02-25'`. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set this version belongs to.\\n- `rate_card_versions` (RateCardVersion) - The Rate Card Version of each Rate Card defined on the Rate Card Set.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"rate_card_set_id\",\"description\":\"Restricts Rate Card Set Versions to the specified Rate Card Set.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Rate Card Set Versions have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Rate Card Set Version\",\"description\":\"Rate Card Set Versions can only created by an Administrator on the account.\\n\\nCreating/Cloning a Rate Card Set Version on a Rate Card Set, does the following:\\n  - Creates/Clones a Rate Card Version for each existing Rate Card on the associated Rate Card Set.\\n  - Creates/Clones necessary associations for each Rate Card Version.\\n\\n\\nThis endpoint returns structured Rate Card Set Version objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_set_versions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-rate-card-set-version\",\"tags\":[\"Rate Card Set Version (Effective version by Date)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"clone_id\",\"required\":false,\"description\":\"The ID of the Rate Card Set Version to be cloned.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set this version belongs to.\\n- `rate_card_versions` (RateCardVersion) - The Rate Card Version of each Rate Card defined on the Rate Card Set.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card_set_version\":{\"type\":\"object\",\"properties\":{\"rate_card_set_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Rate Card Set to which this version belongs.\"},\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date from the which the current rate card set version takes effect. This will default to today. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}},\"required\":[\"rate_card_set_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card Set Version has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_set_versions/{id}\":{\"get\":{\"summary\":\"Fetching a single Rate Card Set Version\",\"description\":\"A Rate Card Set Version is only accessible to an Administrator on the account.\\n\\n\\nThis endpoint returns structured Rate Card Set Version objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_set_versions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card-set-version\",\"tags\":[\"Rate Card Set Version (Effective version by Date)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set this version belongs to.\\n- `rate_card_versions` (RateCardVersion) - The Rate Card Version of each Rate Card defined on the Rate Card Set.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Rate Card Set Version has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Rate Card Set Version\",\"description\":\"A Rate Card Set Version can only be modified when the effective date is in the future, or when it is not yet\\npublished.\\n\\n\\nThis endpoint returns structured Rate Card Set Version objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_set_versions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-rate-card-set-version\",\"tags\":[\"Rate Card Set Version (Effective version by Date)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set this version belongs to.\\n- `rate_card_versions` (RateCardVersion) - The Rate Card Version of each Rate Card defined on the Rate Card Set.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card_set_version\":{\"type\":\"object\",\"properties\":{\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date from the which the current Rate Card Set Version takes effect. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card Set Version has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Rate Card Set Version\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-rate-card-set-version\",\"tags\":[\"Rate Card Set Version (Effective version by Date)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Rate Card Set Version has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_set_versions/{id}/publish\":{\"put\":{\"summary\":\"Publish a Rate Card Set Version\",\"description\":\"Publishing a Rate Card Set Version means activating the version from the set effective date.\\nA Rate Card Set Version can be published to any future date, but cannot be published on the same\\neffective date as another Rate Card Set Version on the same Rate Card Set. Once published, a Rate Card\\nSet Version cannot be unpublished.\\n\\n\\nThis endpoint returns structured Rate Card Set Version objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_set_versions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"publish-rate-card-set-version\",\"tags\":[\"Rate Card Set Version (Effective version by Date)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set this version belongs to.\\n- `rate_card_versions` (RateCardVersion) - The Rate Card Version of each Rate Card defined on the Rate Card Set.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Rate Card Set Version has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"activated\":{\"type\":\"boolean\",\"description\":\"Indicates whether the Rate Card Set Version has been published.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_set_versions/{rate_card_set_version_id}/rate_card_table_rows\":{\"get\":{\"summary\":\"Fetch Rate Card Table Rows\",\"description\":\"Returns all Rate Card Table Rows for a specified Rate Card Set Version.\",\"operationId\":\"get-rate-card-table-rows-for-set-version\",\"tags\":[\"Rate Card Table Rows\"],\"parameters\":[{\"in\":\"path\",\"name\":\"rate_card_set_version_id\",\"required\":true,\"description\":\"The ID of the Rate card set version.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of Rate Card Table Rows in the Rate Card Set Version.\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of Rate Card Table Rows in the Rate Card Set Version.\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total number of pagination pages.\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The current pagination page.\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of Rate Card Table Rows in a pagination page.\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\",\"description\":\"The ID of the Rate Card Table Row, defined as `<rate_card_set_version_id>`:`<role_id>`.\"}}}},\"rate_card_table_rows\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The ID of the Rate Card Table Row, defined as `<rate_card_set_version_id>`:`<role_id>`.\"},\"rate_card_set_id\":{\"type\":\"string\",\"description\":\"The ID of the Rate Card Set.\"},\"rate_card_set_version_id\":{\"type\":\"string\",\"description\":\"The ID of the Rate Card Table Set Version.\"},\"role_id\":{\"type\":\"string\",\"description\":\"The ID of the Role.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the Role.\"},\"removable\":{\"type\":\"boolean\",\"description\":\"If `true`, this Rate Card Table Row is removable.\"},\"cells\":{\"type\":\"object\",\"properties\":{\"currency\":{\"type\":\"object\",\"properties\":{\"rate_card_role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Rate Card Role for the specified currency.\"},\"rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate for the specified Rate Card Role.\"}}}}}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_set_versions/{rate_card_set_version_id}/rate_card_table_rows/{role_id}\":{\"delete\":{\"summary\":\"Delete a Rate Card Table Row\",\"description\":\"Deletes all Rate Card Roles for a specified Rate Card Set Version and Role.\",\"operationId\":\"delete-rate-card-table-row\",\"tags\":[\"Rate Card Table Rows\"],\"parameters\":[{\"in\":\"path\",\"name\":\"rate_card_set_version_id\",\"required\":true,\"description\":\"The ID of the Rate card set version.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"path\",\"name\":\"role_id\",\"required\":true,\"description\":\"The ID of the Role.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"object has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Create or Update Rate Card Table Row\",\"description\":\"Creates or updates a Rate Card Table Row for a specified Rate Card Set Version and Role.\",\"operationId\":\"create-or-update-rate-table-row\",\"tags\":[\"Rate Card Table Rows\"],\"parameters\":[{\"in\":\"path\",\"name\":\"rate_card_set_version_id\",\"required\":true,\"description\":\"The ID of the Rate card set version.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"path\",\"name\":\"role_id\",\"required\":true,\"description\":\"The ID of the Role.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card_table_row\":{\"type\":\"object\",\"properties\":{\"rates\":{\"type\":\"array\",\"description\":\"The currencies and rates for each row.\",\"items\":{\"type\":\"object\",\"properties\":{\"currency\":{\"type\":\"string\",\"description\":\"The [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473)\\n                of the currency.\"},\"rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate in subunits (e.g. 25000 cents = 250 dollars).\"}},\"required\":[\"currency\",\"rate\"]}}},\"required\":[\"rates\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"object has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of Rate Card Table Rows in the Rate Card Set Version.\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of Rate Card Table Rows in the Rate Card Set Version.\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total number of pagination pages.\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The current pagination page.\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of Rate Card Table Rows in a pagination page.\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\",\"description\":\"The ID of the Rate Card Table Row, defined as `<rate_card_set_version_id>`:`<role_id>`.\"}}}},\"rate_card_table_rows\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The ID of the Rate Card Table Row, defined as `<rate_card_set_version_id>`:`<role_id>`.\"},\"rate_card_set_id\":{\"type\":\"string\",\"description\":\"The ID of the Rate Card Set.\"},\"rate_card_set_version_id\":{\"type\":\"string\",\"description\":\"The ID of the Rate Card Table Set Version.\"},\"role_id\":{\"type\":\"string\",\"description\":\"The ID of the Role.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the Role.\"},\"removable\":{\"type\":\"boolean\",\"description\":\"If `true`, this Rate Card Table Row is removable.\"},\"cells\":{\"type\":\"object\",\"properties\":{\"currency\":{\"type\":\"object\",\"properties\":{\"rate_card_role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Rate Card Role for the specified currency.\"},\"rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate for the specified Rate Card Role.\"}}}}}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_sets\":{\"get\":{\"summary\":\"Fetching a list of Rate Card Sets\",\"description\":\"Rate Card Sets are only accessible to users with Financial access (Project Lead or higher) on the account.\\n\\nAn initial request to this endpoint, will generate an account default Rate Card Set and a create a\\nRate Card Set Version. This account default Rate Card Set will include a separate Rate Card for every currency\\nused in projects on the user's account.\\n\\n\\nThis endpoint returns structured Rate Card Set objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_sets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card-sets\",\"tags\":[\"Rate Card Sets (Group of Rate Cards)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"active\",\"description\":\"Includes only Rate Card Sets with published Rate Card Set Versions.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"has_active_currency\",\"description\":\"Includes only Rate Card Sets that have a rate card with the specified currency and belong to\\na published Rate Card Set Version.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_currency\",\"description\":\"Includes only Rate Card Sets that have a rate card with the specified currency.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set_versions` (RateCardSetVersion) - Rate Card Set Versions belonging to the Rate Card Set.\\n- `rate_cards` (RateCard) - Rate Cards (currencies) belonging to the Rate Card Set.\\n- `workspace_groups` (WorkspaceGroup) - Groups associated with the Rate Card Set.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Includes only Rate Card Sets with a title matching the specified term.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `title:asc`, and `title:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"workspace_groups\",\"description\":\"Filter rate card sets by their associated workspace groups. Provide a comma-separated list of workspace group IDs, for example `10,20`.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Rate Card Sets have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Rate Card Set\",\"description\":\"This endpoint returns structured Rate Card Set objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_sets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-rate-card-set\",\"tags\":[\"Rate Card Sets (Group of Rate Cards)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"clone_version_id\",\"required\":false,\"description\":\"The ID of the existing Rate Card Set Version to be cloned.\\nCloning creates a Rate Card Set that contains the following:\\n  - A clone of the specified Rate Card Set Version.\\n  - A clone of all the associations of the specified Rate Card Set Version.\\n  - A clone of all the Rate Cards belonging to the Rate Card Set for the specified Rate Card Set Version.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set_versions` (RateCardSetVersion) - Rate Card Set Versions belonging to the Rate Card Set.\\n- `rate_cards` (RateCard) - Rate Cards (currencies) belonging to the Rate Card Set.\\n- `workspace_groups` (WorkspaceGroup) - Groups associated with the Rate Card Set.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card_set\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title of the Rate Card Set.\"}},\"required\":[\"title\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card Set has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_sets/{id}\":{\"get\":{\"summary\":\"Fetching a single Rate Card Set\",\"description\":\"A Rate Card Set can only be accessed by users with Financial access (Project Lead or higher) on the account.\\n\\n\\nThis endpoint returns structured Rate Card Set objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_sets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card-set\",\"tags\":[\"Rate Card Sets (Group of Rate Cards)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set_versions` (RateCardSetVersion) - Rate Card Set Versions belonging to the Rate Card Set.\\n- `rate_cards` (RateCard) - Rate Cards (currencies) belonging to the Rate Card Set.\\n- `workspace_groups` (WorkspaceGroup) - Groups associated with the Rate Card Set.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Rate Card Set has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Rate Card Set\",\"description\":\"This endpoint returns structured Rate Card Set objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_sets` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-rate-card-set\",\"tags\":[\"Rate Card Sets (Group of Rate Cards)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card_set_versions` (RateCardSetVersion) - Rate Card Set Versions belonging to the Rate Card Set.\\n- `rate_cards` (RateCard) - Rate Cards (currencies) belonging to the Rate Card Set.\\n- `workspace_groups` (WorkspaceGroup) - Groups associated with the Rate Card Set.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card_set\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title of the Rate Card Set.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card Set has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Rate Card Set\",\"description\":\"A Rate Card Set cannot be deleted if:\\n  - The Rate Card Set is the account default.\\n  - A Rate Card belonging to the Rate Card Set is being used by a project.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-rate-card-set\",\"tags\":[\"Rate Card Sets (Group of Rate Cards)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Rate Card Set has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_versions\":{\"get\":{\"summary\":\"Fetching a list of Rate Card Versions\",\"description\":\"Rate Card Versions are only accessible by Administrators on the account.\\n\\n\\nThis endpoint returns structured Rate Card Version objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_versions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card-versions\",\"tags\":[\"Rate Card Versions\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"effective_on_date\",\"description\":\"Returns Rate Card Versions that are effective on the requested date.\\nThe date should be in `<ISO_8601 Date Format>` eg. `'2014-02-25'`. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card` (RateCard) - The Rate Card to which this version belongs.\\n- `rate_card_roles` (RateCardRole) - The Rate Card Roles owned by this Rate Card Version.\\n- `rate_card_set_version` (RateCardSetVersion) - The Rate Card Set Version to which this version belongs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"rate_card_id\",\"description\":\"Restricts Rate Card Versions to the specified Rate Card ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"rate_card_set_id\",\"description\":\"Restricts Rate Card Versions to the specified Rate Card Set ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"rate_card_set_version_id\",\"description\":\"Restricts Rate Card Versions to the specified Rate Card Set Version ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Rate Card Versions have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"rate_card_roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardRole\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_card_versions/{id}\":{\"get\":{\"summary\":\"Fetching a single Rate Card Version\",\"description\":\"Rate Card Versions are only accessible by Administrators on the account.\\n\\n\\nThis endpoint returns structured Rate Card Version objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_versions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card-version\",\"tags\":[\"Rate Card Versions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card` (RateCard) - The Rate Card to which this version belongs.\\n- `rate_card_roles` (RateCardRole) - The Rate Card Roles owned by this Rate Card Version.\\n- `rate_card_set_version` (RateCardSetVersion) - The Rate Card Set Version to which this version belongs.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Rate Card Version has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"rate_card_roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardRole\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Rate Card Version\",\"description\":\"Rate Card Versions can only be modified by Administrators on the account.\\n\\n\\nThis endpoint returns structured Rate Card Version objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_card_versions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-rate-card-version\",\"tags\":[\"Rate Card Versions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `rate_card` (RateCard) - The Rate Card to which this version belongs.\\n- `rate_card_roles` (RateCardRole) - The Rate Card Roles owned by this Rate Card Version.\\n- `rate_card_set_version` (RateCardSetVersion) - The Rate Card Set Version to which this version belongs.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card_version\":{\"type\":\"object\",\"properties\":{\"default_rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default rate for all roles that do not have explicit rates associated with them.\"}},\"required\":[\"default_rate\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card Version has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"rate_card_set_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSetVersion\"}},\"rate_card_roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardRole\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_cards\":{\"get\":{\"summary\":\"Fetching a list of Rate Cards\",\"description\":\"Returns Rate Cards on every Rate Card Set belonging to the account of the user that is logged-in.\\nThis endpoint is only accessible to users with Financial access (Project Lead or higher) on the account.\\n\\n\\nThis endpoint returns structured Rate Card objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_cards` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-cards\",\"tags\":[\"Rate Cards (Multiple Currencies)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"active\",\"description\":\"Returns Rate Cards that have been published.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"currencies\",\"description\":\"Restricts Rate Cards to the specified currencies e.g. 'USD,CAD,GBP'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `effective_rate_card_version` (RateCardVersion) - Returns todays effective Rate Card Version for the user that is logged-in.  Must be used with the `only` parameter.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set to which this Rate Card belongs.\\n- `rate_card_versions` (RateCardVersion) - Includes only Rate Card Versions which this Rate Card owns.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Returns rate cards matching a provide text value.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"matching_title_or_currency\",\"description\":\"Returns rate cards matching a provide text value considering either the title or currency code.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"rate_card_set_id\",\"description\":\"Restricts Rate Cards to the specified Rate Card Set.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Rate Cards have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Rate Card\",\"description\":\"Creating a Rate Card automatically creates a Rate Card Version and associates it with the specified\\nRate Card Set Version. If you are adding a Rate Card with a new currency on a custom Rate Card Set, it needs to\\nbe added to the account default Rate Card Set first.\\nWhen you add a Rate Card with a new currency on a Rate Card Set that already has published Rate Card Set\\nversions, a cloned Rate Card Version will be added to all previous Rate Card Set Versions on the Rate\\nCard Set.\\nA Rate Card can only be created by Administrators on the account.\\n\\n\\nThis endpoint returns structured Rate Card objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_cards` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-rate-card\",\"tags\":[\"Rate Cards (Multiple Currencies)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `effective_rate_card_version` (RateCardVersion) - Returns todays effective Rate Card Version for the user that is logged-in.  Must be used with the `only` parameter.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set to which this Rate Card belongs.\\n- `rate_card_versions` (RateCardVersion) - Includes only Rate Card Versions which this Rate Card owns.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card\":{\"type\":\"object\",\"properties\":{\"rate_card_set_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Rate Card Set to which the Rate Card belongs.\"},\"rate_card_set_version_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Rate Card Set Version to which the Rate Card belongs.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency that the Rate Card represents in the Rate Card. For example, `USD`.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"rate_card_set_id\",\"rate_card_set_version_id\",\"currency\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/rate_cards/{id}\":{\"get\":{\"summary\":\"Fetching a single Rate Card\",\"description\":\"This endpoint is only accessible to users with Financial access (Project Lead or higher) on the account.\\n\\n\\nThis endpoint returns structured Rate Card objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_cards` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-rate-card\",\"tags\":[\"Rate Cards (Multiple Currencies)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `effective_rate_card_version` (RateCardVersion) - Returns todays effective Rate Card Version for the user that is logged-in.  Must be used with the `only` parameter.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set to which this Rate Card belongs.\\n- `rate_card_versions` (RateCardVersion) - Includes only Rate Card Versions which this Rate Card owns.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Rate Card has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Rate Card\",\"description\":\"A Rate Card can only be editied by an Administrator on the account. The currency of the Rate Card\\ncannot be changed if it is already in use by a project.\\n\\n\\nThis endpoint returns structured Rate Card objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `rate_cards` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-rate-card\",\"tags\":[\"Rate Cards (Multiple Currencies)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `effective_rate_card_version` (RateCardVersion) - Returns todays effective Rate Card Version for the user that is logged-in.  Must be used with the `only` parameter.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card_set` (RateCardSet) - The Rate Card Set to which this Rate Card belongs.\\n- `rate_card_versions` (RateCardVersion) - Includes only Rate Card Versions which this Rate Card owns.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"rate_card\":{\"type\":\"object\",\"properties\":{\"currency\":{\"type\":\"string\",\"description\":\"The currency that the Rate Card will represent in the Rate Card Set. For example, `USD`.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Rate Card has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"rate_cards\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCard\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}},\"rate_card_versions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardVersion\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Rate Card\",\"description\":\"When you delete a Rate Card, its Rate Card Versions and the Rate Card Roles associated\\nwith the Rate Card Versions will also be deleted. Once a Rate Card is deleted, neither the Rate Card nor\\nits associated data is recoverable. A Rate Card cannot be deleted if it is already in use by a project.\\nA Rate Card can only be deleted by an Administrator on the account.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-rate-card\",\"tags\":[\"Rate Cards (Multiple Currencies)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Rate Card has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/recommendations/estimate_scenario_resource\":{\"get\":{\"summary\":\"Fetch Estimate Scenario Resource Recommendations\",\"description\":\"Returns an ordered list of Recommendations (up to 1000) for an estimate scenario resource.\",\"operationId\":\"get-estimate-scenario-resource-recommendations\",\"tags\":[\"Recommendations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the EstimateScenarioResource for which to retrieve recommendations.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"recommendations\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user that is recommended.\"},\"rank\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rank of the user that is recommended.\"}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/resource_requests\":{\"get\":{\"summary\":\"Fetching a list of Resource Requests\",\"description\":\"Returns resource requests visible to the logged in user by default. When `pending_requests_only` filter is set\\nto true, the endpoint returns only pending resource requests.\\n\\n\\nThis endpoint returns structured Resource Requests objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resource_requests` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-resource-requests\",\"tags\":[\"Resource Requests\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approvers` (User) - The users available to approver or reject the resource request.\\n- `creator` (User) - The person submitting the resource request.\\n- `resource` (WorkspaceResource) - The resource the request is intending to assign a user to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"pending_requests_only\",\"description\":\"Returns only the pending resource requests.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"requests_for_approver\",\"description\":\"Returns only the requests where the specified user is the approver.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Resource Requests have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resource_requests\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ResourceRequest\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Resource Requests\",\"description\":\"This endpoint returns structured Resource Requests objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resource_requests` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-resource-request\",\"tags\":[\"Resource Requests\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approvers` (User) - The users available to approver or reject the resource request.\\n- `creator` (User) - The person submitting the resource request.\\n- `resource` (WorkspaceResource) - The resource the request is intending to assign a user to.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"resource_request\":{\"type\":\"object\",\"properties\":{\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resource for which the resource request will be created.\"},\"resource_workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"A resource will be created for this project in addition to the resource request.\"},\"resource_role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"A resource will be created with this role in addition to the resource request.\"},\"approver_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of the people selected to approve this request.\"},\"workspace_allocation_start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Set the allocation start date for a created workspace resource. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"workspace_allocation_end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Set the allocation start date for a created workspace resource. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"workspace_allocation_percentage\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Set the allocation percentage for a created workspace resource.\"},\"custom_fields\":{\"type\":\"array\",\"description\":\"Determines the custom field values for the workspace resource.\",\"items\":{\"type\":\"object\",\"properties\":{\"custom_field_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the custom field.\"},\"value\":{\"type\":\"string\",\"description\":\"The value for the corresponding custom field. The value formats for different types are:\\n\\n* `string` - `<text_string>`, eg. `'foo'`\\n* `date` - `<ISO_8601 Date Format>` eg. `'2014-02-25'` `(accepted range: '1900-01-01' to '2015-12-31')`\\n* `number` - `<integer_value>` eg. `'13'`\\n* `currency` - `[<int_value_in_cents>, <currency_code>]` eg. `'[998, USD]'`\\n* `single` and `multi` - `[<choice_ids>]` eg. `'[1, 2, 4]'`.\"}}}}},\"required\":[\"approver_ids\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Resource Requests has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resource_requests\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ResourceRequest\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/resource_requests/{id}\":{\"get\":{\"summary\":\"Fetching a single Resource Requests\",\"description\":\"This endpoint returns structured Resource Requests objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resource_requests` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-resource-request\",\"tags\":[\"Resource Requests\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approvers` (User) - The users available to approver or reject the resource request.\\n- `creator` (User) - The person submitting the resource request.\\n- `resource` (WorkspaceResource) - The resource the request is intending to assign a user to.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Resource Requests has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resource_requests\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ResourceRequest\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Resource Requests\",\"description\":\"This endpoint returns structured Resource Requests objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resource_requests` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-resource-request\",\"tags\":[\"Resource Requests\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approvers` (User) - The users available to approver or reject the resource request.\\n- `creator` (User) - The person submitting the resource request.\\n- `resource` (WorkspaceResource) - The resource the request is intending to assign a user to.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"resource_request\":{\"type\":\"object\",\"properties\":{\"request_resolution_status\":{\"type\":\"string\",\"description\":\"The state for request resolution, one of approve, reject, or cancel.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user being named (staffed) on this unnamed resource.\"},\"allocations_state\":{\"type\":\"boolean\",\"description\":\"Whether to set the allocations to hard or soft allocated when naming the resource. When nothing is passed in, the allocations are defaulted to hard allocated.\"}},\"required\":[\"request_resolution_status\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Resource Requests has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resource_requests\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ResourceRequest\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/resource_requests/{id}/update_approver\":{\"put\":{\"summary\":\"Update Resource Request Approver\",\"description\":\"This endpoint returns structured Resource Requests objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resource_requests` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-resource-request-approver\",\"tags\":[\"Resource Requests\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `approvers` (User) - The users available to approver or reject the resource request.\\n- `creator` (User) - The person submitting the resource request.\\n- `resource` (WorkspaceResource) - The resource the request is intending to assign a user to.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"resource_request\":{\"type\":\"object\",\"properties\":{\"new_approver_id\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The ID of the user who is the new approver.\"}},\"required\":[\"new_approver_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Resource Requests has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resource_requests\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ResourceRequest\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/roles\":{\"get\":{\"summary\":\"Fetching a list of Roles\",\"description\":\"The Roles endpoint provides a list of all active roles that belong to the account of the user making the request.\\n\\nThe response will contain an array of role objects, sorted alphabetically by the `name` attribute\\navailable under the key named `roles`.\\n\\n\\nThis endpoint returns structured Role objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `roles` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-roles\",\"tags\":[\"Roles\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"for_rate_card\",\"description\":\"Only includes roles from a given rate card.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"for_scenario_rate_card\",\"description\":\"Only includes roles that are on the scenario's rate card.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"for_workspace\",\"description\":\"Only includes roles for a specific project ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"for_workspace_rate_card\",\"description\":\"Only includes roles that are on the workspace's rate card.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Only includes roles with names that match the search string.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"not_on_rate_card_set_version\",\"description\":\"Only includes roles that are not already on the rate card set version.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_active\",\"description\":\"Only includes roles that have not been soft-deleted (via deleted_at).\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc` and `alphabetical:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"alphabetical:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Roles have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Role\",\"description\":\"This endpoint returns structured Role objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `roles` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-role\",\"tags\":[\"Roles\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"role\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the role being created.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Role has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/roles/{id}\":{\"get\":{\"summary\":\"Fetching a single Role\",\"description\":\"This endpoint returns structured Role objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `roles` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-role\",\"tags\":[\"Roles\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Role has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Role\",\"description\":\"This endpoint returns structured Role objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `roles` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-role\",\"tags\":[\"Roles\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"role\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The updated name of the existing role.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Role has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Role\",\"description\":\"The Role will be soft-deleted if it is currently in use. If not, it will be removed.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-role\",\"tags\":[\"Roles\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Role has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/scheduled_jobs/insights_report_exports\":{\"get\":{\"summary\":\"Get Scheduled Report Exports\",\"description\":\"Returns a list of scheduled exports of classic Insights reports.\",\"operationId\":\"get-scheduled-report-exports\",\"tags\":[\"Insights Report Exports\"],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of a scheduled report export.\"},\"title\":{\"type\":\"string\",\"description\":\"The name of a scheduled report export.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of a scheduled report export, if provided.\"},\"external_report_object_identifier\":{\"type\":\"string\",\"description\":\"The unique identifier of the report you want to export on a schedule. Each report has one.\"},\"recurrence\":{\"type\":\"object\",\"description\":\"The schedule for when you would like the report export to repeat, defined by the `cadence` and `start_time`.\",\"properties\":{\"cadence\":{\"type\":\"string\",\"description\":\"How often a scheduled export runs, defined as either `hourly` or `daily`.\"},\"start_time\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The timestamp for when a schedule begins. Daily scheduled exports recur at this time everyday. This property is only applicable to non-hourly schedules.\"}}},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The timestamp for when an export of a report was completed.\"},\"latest_success\":{\"type\":\"object\",\"description\":\"Download the most recent successfully exported report.\",\"properties\":{\"url\":{\"type\":\"string\",\"description\":\"The URL to the most recent successful report export. Download the exported report within 60 seconds. The URL expiration period is subject to change. If you do not download the report within 60 seconds, you can send a new request to generate a new URL.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Timestamp for when the most recent successful report export was completed.\"}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Create a new Scheduled Report Export\",\"description\":\"Create a new scheduled job. Set a schedule for a classic Insights report to be exported from Kantata OX to download later. You will need to write a script to download the report.\",\"operationId\":\"create-scheduled-report-export\",\"tags\":[\"Insights Report Exports\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"insights_report_export\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"Give a name for the scheduled report export.\"},\"description\":{\"type\":\"string\",\"description\":\"Give a description for the scheduled report export.\"},\"external_report_object_identifier\":{\"type\":\"string\",\"description\":\"Enter the unique identifier of the classic Insights report you want to export on a schedule. Each report has one. Use the Insights Report endpoint to get the identifier for the report you want to export.\"},\"recurrence\":{\"type\":\"object\",\"description\":\"A schedule for when you would like the report export to repeat, consisting of the `cadence` and `start_time` that you define.\",\"properties\":{\"cadence\":{\"type\":\"string\",\"description\":\"Define how often a scheduled export runs. Valid values: `hourly`, `daily`.\"},\"start_time\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Define the date and time a schedule begins in ISO 8601 format. Daily scheduled exports will recur at this time everyday. This parameter is required for all non-hourly schedules. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}},\"required\":[\"cadence\"]}},\"required\":[\"external_report_object_identifier\",\"recurrence\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"object has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of a scheduled report export.\"},\"title\":{\"type\":\"string\",\"description\":\"The name of a scheduled report export.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of a scheduled report export, if provided.\"},\"external_report_object_identifier\":{\"type\":\"string\",\"description\":\"The unique identifier of the report you want to export on a schedule. Each report has one.\"},\"recurrence\":{\"type\":\"object\",\"description\":\"The schedule for when you would like the report export to repeat, defined by the `cadence` and `start_time`.\",\"properties\":{\"cadence\":{\"type\":\"string\",\"description\":\"How often a scheduled export runs, defined as either `hourly` or `daily`.\"},\"start_time\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The timestamp for when a schedule begins. Daily scheduled exports recur at this time everyday. This property is only applicable to non-hourly schedules.\"}}},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The timestamp for when an export of a report was completed.\"},\"latest_success\":{\"type\":\"object\",\"description\":\"Download the most recent successfully exported report.\",\"properties\":{\"url\":{\"type\":\"string\",\"description\":\"The URL to the most recent successful report export. Download the exported report within 60 seconds. The URL expiration period is subject to change. If you do not download the report within 60 seconds, you can send a new request to generate a new URL.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Timestamp for when the most recent successful report export was completed.\"}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/scheduled_jobs/insights_report_exports/{id}\":{\"get\":{\"summary\":\"Get Scheduled Report Export\",\"description\":\"Returns details for a single scheduled export of a classic Insights report.\",\"operationId\":\"get-scheduled-report-export\",\"tags\":[\"Insights Report Exports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"The object has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of a scheduled report export.\"},\"title\":{\"type\":\"string\",\"description\":\"The name of a scheduled report export.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of a scheduled report export, if provided.\"},\"external_report_object_identifier\":{\"type\":\"string\",\"description\":\"The unique identifier of the report you want to export on a schedule. Each report has one.\"},\"recurrence\":{\"type\":\"object\",\"description\":\"The schedule for when you would like the report export to repeat, defined by the `cadence` and `start_time`.\",\"properties\":{\"cadence\":{\"type\":\"string\",\"description\":\"How often a scheduled export runs, defined as either `hourly` or `daily`.\"},\"start_time\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The timestamp for when a schedule begins. Daily scheduled exports recur at this time everyday. This property is only applicable to non-hourly schedules.\"}}},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The timestamp for when an export of a report was completed.\"},\"latest_success\":{\"type\":\"object\",\"description\":\"Download the most recent successfully exported report.\",\"properties\":{\"url\":{\"type\":\"string\",\"description\":\"The URL to the most recent successful report export. Download the exported report within 60 seconds. The URL expiration period is subject to change. If you do not download the report within 60 seconds, you can send a new request to generate a new URL.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Timestamp for when the most recent successful report export was completed.\"}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Update a Scheduled Report Export\",\"description\":\"Make changes to an existing scheduled job.\",\"operationId\":\"update-scheduled-report-export\",\"tags\":[\"Insights Report Exports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"insights_report_export\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"Give a name for the scheduled report export.\"},\"description\":{\"type\":\"string\",\"description\":\"Give a description for the scheduled report export.\"},\"external_report_object_identifier\":{\"type\":\"string\",\"description\":\"Enter the unique identifier of the classic Insights report you want to export on a schedule. Each report has one. Use the Insights Report endpoint to get the identifier for the report you want to export.\"},\"recurrence\":{\"type\":\"object\",\"description\":\"A schedule for when you would like the report export to repeat, consisting of the `cadence` and `start_time` that you define.\",\"properties\":{\"cadence\":{\"type\":\"string\",\"description\":\"Define how often a scheduled export runs. Valid values: `hourly`, `daily`.\"},\"start_time\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Define the date and time a schedule begins in ISO 8601 format. Daily scheduled exports will recur at this time everyday. This parameter is required for all non-hourly schedules. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}},\"required\":[\"cadence\"]}}}}}}},\"required\":true},\"responses\":{\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Delete an existing Scheduled Report Export\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-scheduled-report-export\",\"tags\":[\"Insights Report Exports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"object has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/scheduled_jobs/insights_report_exports/{insights_report_export_id}/results/latest\":{\"get\":{\"summary\":\"Get Latest Export\",\"description\":\"Returns the most recent classic Insights report that has been successfully and completely exported by a scheduled job. The response contains a URL to download the report, as well as a timestamp for when the data in the report was last updated, so you may determine if the report reflects current data.\\n\\nIn order to keep exported data secure, the URL returned in the response expires in 60 seconds. The URL expiration period is subject to change. If you do not initiate a download of the report before the link expires, you can send a new request to generate a new URL.\\n\\nExporting a report can take from seconds to 20 minutes, depending on the report size. Because export time varies, please send requests until the latest data is returned. If there are no previously exported reports yet, the response code and message will indicate this.\\n\\nBecause exported reports can be up to 10 GB, reports are downloaded in a compressed format (.gz) and must be decompressed in order to access the CSV file.\",\"operationId\":\"get-latest-scheduled-report-export\",\"tags\":[\"Insights Report Exports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"insights_report_export_id\",\"required\":true,\"description\":\"The ID of the Insights report export.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"latest_success\":{\"type\":\"object\",\"description\":\"Download the most recent successfully exported report.\",\"properties\":{\"url\":{\"type\":\"string\",\"description\":\"The URL to the most recent successful report export. Download the exported report within 60 seconds. The URL expiration period is subject to change. If you do not download the report within 60 seconds, you can send a new request to generate a new URL.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Timestamp for when the most recent successful report export was completed.\"}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/skill_categories\":{\"get\":{\"summary\":\"Fetching a list of Skill Categories\",\"description\":\"This endpoint returns structured Skill Category objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skill_categories` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-skill-categories\",\"tags\":[\"Skill Categories\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `skills` (Skill) - The skills associated with each skill category.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Skill category names that are like the specified name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc` and `alphabetical:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"alphabetical:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Skill Categories have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skill_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillCategory\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/skill_memberships\":{\"get\":{\"summary\":\"Fetching a list of Skill Memberships\",\"description\":\"Returns a list of viewable skill memberships.\\n\\nThis endpoint returns structured Skill Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skill_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-skill-memberships\",\"tags\":[\"Skill Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"active_account_members_only\",\"description\":\"Only skill memberships for only active users on the account.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"by_skill_id\",\"description\":\"Only includes associated skill, by the skill ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_skill_ids\",\"description\":\"Only includes associated skills. Input is a comma separated list of ids or an array.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_skill_name\",\"description\":\"Only includes associated skills, by the name of the skill.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_user_name\",\"description\":\"Only includes skill memberships assigned to a user, by their full name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - References the user who has created the skill association.\\n- `skill` (Skill) - References the skill assigned to the object.\\n- `user` (User) - References the user who has been assigned the skill.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `full_name`, `skill_name:asc`, and `skill_name:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_ids\",\"description\":\"Only includes skill memberships assigned to a user, by user ID.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter for participants of a specific project.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Skill Memberships have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Skill Membership\",\"description\":\"This endpoint returns structured Skill Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skill_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-skill-membership\",\"tags\":[\"Skill Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - References the user who has created the skill association.\\n- `skill` (Skill) - References the skill assigned to the object.\\n- `user` (User) - References the user who has been assigned the skill.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"skill_membership\":{\"type\":\"object\",\"properties\":{\"skill_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the skill.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user.\"},\"level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user's proficiency level in the skill (1-5). This defaults to 0 if it is not specified.\\nNote: Not all skills have levels.\"}},\"required\":[\"skill_id\",\"user_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Skill Membership has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/skill_memberships/{id}\":{\"get\":{\"summary\":\"Fetching a single Skill Membership\",\"description\":\"Returns a list of viewable skill memberships.\\n\\nThis endpoint returns structured Skill Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skill_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-skill-membership\",\"tags\":[\"Skill Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - References the user who has created the skill association.\\n- `skill` (Skill) - References the skill assigned to the object.\\n- `user` (User) - References the user who has been assigned the skill.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Skill Membership has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Skill Membership\",\"description\":\"This endpoint returns structured Skill Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skill_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-skill-membership\",\"tags\":[\"Skill Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - References the user who has created the skill association.\\n- `skill` (Skill) - References the skill assigned to the object.\\n- `user` (User) - References the user who has been assigned the skill.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"skill_membership\":{\"type\":\"object\",\"properties\":{\"level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user's proficiency level in the skill (1-5). This defaults to 0 if it is not specified.\\nNote: Not all skills have levels.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Skill Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Skill Membership\",\"description\":\"Returns a list of viewable skill memberships.\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-skill-membership\",\"tags\":[\"Skill Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Skill Membership has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/skills\":{\"get\":{\"summary\":\"Fetching a list of Skills\",\"description\":\"The Skills endpoint provides a list of every Skill that belongs to the Account of the User making the request.\\nThe response will contain an array of Skill objects, sorted alphabetically by the `name` attribute.\\n\\n**NOTE:** You cannot create more than 3000 skills per account.\\n\\n\\nThis endpoint returns structured Skill objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skills` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-skills\",\"tags\":[\"Skills\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"except\",\"description\":\"Includes the skills that are not in the passed in set of skill ids. For example, '10,15'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"for_users\",\"description\":\"Includes skills that are not already associated with these users. For example, '10,15'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `skill_category` (SkillCategory) - The Skill Category under which the Skill is grouped.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Includes skills with a name that matches the search string.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc` and `alphabetical:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"alphabetical:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"skill_category_ids\",\"description\":\"Includes skills that are associated with these skill categories. For example, '2,25'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"unassigned_skills_for_estimate_scenario_resource\",\"description\":\"Includes the skills that an estimate scenario resource has not been assigned.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"unassigned_skills_for_project_template_assignment\",\"description\":\"Includes the skills that a project template assignment has not been assigned.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"unassigned_skills_for_user\",\"description\":\"Includes the skills that a user has not been assigned.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"unassigned_skills_for_workspace_resource\",\"description\":\"Includes the skills that a workspace resource has not been assigned.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Skills have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"skill_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillCategory\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Skill\",\"description\":\"**NOTE:** You cannot create more than 3000 skills per account.\\n\\n\\nThis endpoint returns structured Skill objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skills` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-skill\",\"tags\":[\"Skills\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `skill_category` (SkillCategory) - The Skill Category under which the Skill is grouped.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"skill\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the skill to be created.\"},\"max_level\":{\"type\":\"string\",\"description\":\"The max number of levels allowed for the skill and must be either 1 or 5.\"},\"skill_category_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the skill category associated with this skill.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the skill.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"name\",\"max_level\",\"skill_category_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Skill has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"skill_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillCategory\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/skills/{id}\":{\"get\":{\"summary\":\"Fetching a single Skill\",\"description\":\"This endpoint returns structured Skill objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skills` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-skill\",\"tags\":[\"Skills\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `skill_category` (SkillCategory) - The Skill Category under which the Skill is grouped.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Skill has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"skill_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillCategory\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Skill\",\"description\":\"This endpoint returns structured Skill objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `skills` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-skill\",\"tags\":[\"Skills\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `skill_category` (SkillCategory) - The Skill Category under which the Skill is grouped.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"skill\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the skill to be created.\"},\"max_level\":{\"type\":\"string\",\"description\":\"The max number of levels allowed for the skill and must be either 1 or 5.\"},\"skill_category_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the skill category associated with this skill.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the skill.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Skill has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"skill_categories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillCategory\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Skill\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-skill\",\"tags\":[\"Skills\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Skill has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/status_reports\":{\"get\":{\"summary\":\"Fetching a list of Status Reports\",\"description\":\"This endpoint returns structured Status Report objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `status_reports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-status-reports\",\"tags\":[\"Status Reports\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created the status report.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User) - The user who last updated the status report.\\n- `workspace` (Workspace) - The workspace associated with the status report.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"required\":false,\"description\":\"Return only status reports for the given workspace_id.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Status Reports have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Status Report\",\"description\":\"This endpoint returns structured Status Report objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `status_reports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-status-report\",\"tags\":[\"Status Reports\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created the status report.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User) - The user who last updated the status report.\\n- `workspace` (Workspace) - The workspace associated with the status report.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"status_report\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"string\",\"description\":\"The ID of the project to create the status report for.\"},\"color\":{\"type\":\"string\",\"description\":\"The status color of the overall report. Valid values: green, yellow, red.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the overall status of the project.\"},\"details\":{\"type\":\"array\",\"description\":\"An array of optional category statuses to report on specific aspects of a project.\",\"items\":{\"type\":\"object\",\"properties\":{\"category\":{\"type\":\"string\",\"description\":\"The category for which this detail applies. Valid values: Scope, Budget, Schedule, Client.\"},\"color\":{\"type\":\"string\",\"description\":\"The status color for the specified category. Valid values: green, yellow, red.\"},\"description\":{\"type\":\"string\",\"description\":\"A description of the status of the specified category.\"}},\"required\":[\"category\",\"color\"]}},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\"]}},\"required\":[\"workspace_id\",\"color\",\"description\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Status Report has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/status_reports/{id}\":{\"get\":{\"summary\":\"Fetching a single Status Report\",\"description\":\"This endpoint returns structured Status Report objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `status_reports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-status-report\",\"tags\":[\"Status Reports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created the status report.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User) - The user who last updated the status report.\\n- `workspace` (Workspace) - The workspace associated with the status report.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Status Report has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Status Report\",\"description\":\"This endpoint returns structured Status Report objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `status_reports` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-status-report\",\"tags\":[\"Status Reports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created the status report.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User) - The user who last updated the status report.\\n- `workspace` (Workspace) - The workspace associated with the status report.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"status_report\":{\"type\":\"object\",\"properties\":{\"color\":{\"type\":\"string\",\"description\":\"The status color for for the report overall. One of green, yellow, red.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the overall status of the project.\"},\"details\":{\"type\":\"array\",\"description\":\"An array of optional category statuses to report on specific aspects of a project. Any\\ncategories not provided when updating will be deleted if they were previously present.\",\"items\":{\"type\":\"object\",\"properties\":{\"category\":{\"type\":\"string\",\"description\":\"The category for which this detail applies. One of Scope, Budget, Schedule, Client.\"},\"color\":{\"type\":\"string\",\"description\":\"The status color for the specified category. One of green, yellow, red.\"},\"description\":{\"type\":\"string\",\"description\":\"A description of the status of the specified category.\"}},\"required\":[\"category\",\"color\"]}},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Status Report has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Status Report\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-status-report\",\"tags\":[\"Status Reports\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Status Report has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/stories\":{\"get\":{\"summary\":\"Fetching a list of Stories\",\"description\":\"This endpoint returns structured Story objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `stories` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-stories\",\"tags\":[\"Stories\"],\"parameters\":[{\"in\":\"query\",\"name\":\"active_between\",\"description\":\"Filter for tasks that have a start or due date that is within a specified date range. Specify the date range with\\n        a pair of colon-separated dates, in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format. For example, `2013-06-01:2013-08-01`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"all_on_account\",\"required\":false,\"description\":\"If you are a reports viewer or administrator, you can retrieve all stories on an account.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"archived\",\"description\":\"Include, filter for, _or_ exclude archived tasks (e.g. `GET https://api.mavenlink.com/api/v1/stories?archived=exclude`).\\n        Valid values: `include`, `only`, `exclude`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"assigned_to_current_user\",\"description\":\"If set to `true`, includes tasks that are assigned to the user making the request.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"by_any_tag\",\"description\":\"Include tasks with at least 1 of the specified [tags](https://mavenlink.zendesk.com/hc/en-us/articles/360052128794-New-Task-Tracker#Task-Rows).\\n        Give multiple tags in a comma-separated list (e.g. `GET /api/v1/stories.json?by_tag_name=design,product management,writing`).\\n        Tags (and therefore valid values for tags) are defined by users.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_choice_value\",\"description\":\"Filter by a custom field choice value, represented as a string with the custom field ID, followed by a\\ncolon, and then comma-separated custom field choice value IDs. The custom field choice value can also be\\nthe word `blank`. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\n\\nThe following formats are supported:\\n\\n- `custom_field_ID:choice_value_ID`\\n- `custom_field_ID:choice_value_1_ID,choice_value_2_ID`\\n- `custom_field_ID:blank`\\n- `(custom_field_1_ID:choice_value_1_ID,choice_value_2_ID):(custom_field_2_ID:choice_value_3_ID)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_currency_value\",\"description\":\"Filter by a custom field currency value, represented as a string with the custom field ID, followed by a\\ncolon, and then the currency value. Optionally, the currency [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473) can be supplied as well, separated\\nfrom the currency value by another colon. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200.2:USD):(2:100)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_date_field\",\"description\":\"Filter for tasks with custom fields that have a date value within a specified range.\\nSpecify the custom field ID and date range in a colon-separated string, with dates in a YYYY-MM-DD format.\\nFor example, `GET /api/v1/stories.json?by_custom_date_field=18290:2018-05-02:2018-06-01`.\\n\\nGive multiple custom fields with date values in a semicolon-separated list\\n(e.g. `GET /api/v1/stories.json?by_custom_date_field=18290:2018-05-02:2018-06-01;18291:2018-06-15:2018-08-15`).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_date_value\",\"description\":\"Filter by a custom field date value, represented as a string with the custom field ID, followed by a\\ncolon, the starting date, another colon, and then the ending date. You can provide both a starting date\\nand ending date, or provide just one. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:2014-12-05:2014-12-25):(2:2014-12-05)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_number_value\",\"description\":\"Filter by a custom field number value, represented as a string with the custom field ID, followed by a\\ncolon, and then the number value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200):(2:101)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_text_value\",\"description\":\"Filter by a custom field text value, represented as a string with the custom field ID, followed by a\\ncolon, and then the text value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:something):(2:else)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_status\",\"description\":\"Filter for tasks that are in projects with the specified statuses.\\n        Valid values are just the [names of project statuses](https://mavenlink.zendesk.com/hc/en-us/articles/115005042433-Project-Status-List).\\n        Give multiple statuses in a comma-separated list\\n        (e.g. `GET /api/v1/stories.json?by_status=Bid Stage,In Planning,In Setup,Not Started`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_subtask_count\",\"description\":\"Filters for parent tasks with the specified number of subtasks.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_tag_name\",\"description\":\"Include tasks with the exact [tags](https://mavenlink.zendesk.com/hc/en-us/articles/360052128794-New-Task-Tracker#Task-Rows) specified.\\n        Give multiple tags in a comma-separated list (e.g. `GET /api/v1/stories.json?by_tag_name=development,data analysis`).\\n        Tags (and therefore valid values for tags) are defined by users.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_workspace_group\",\"description\":\"Filter for tasks in projects that belong to a [Project Group](/tag/Workspace-Groups) (ID).\\n        Give multiple project group IDs in a comma-separated list.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"creators\",\"description\":\"Filter for tasks created by the specified user (ID).\\n        Give multiple user IDs in a comma-separated list (e.g. `GET https://api.mavenlink.com/api/v1/stories?creators=1,2,3`).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"due_after\",\"description\":\"Filter for tasks that are due after the specified date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"due_before\",\"description\":\"Filter for tasks that are due before the specified date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"due_between\",\"description\":\"Filter for tasks with a due date that is within a specified date range. Specify the date range with\\n        a pair of colon-separated dates, in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format. For example, `2013-06-01:2013-08-01`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"due_on\",\"description\":\"Filter for tasks that are due on the specified date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"exclude_workspace_title_from_search\",\"description\":\"If set to `true`, excludes tasks in projects with a title that matches searched text.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"has_value_for_custom_field_ids\",\"description\":\"Filter by the presence of a custom field value for the specified comma-separated custom field ID(s).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `ancestors` (Story) - Retrieves all of the tasks that the task is nested under (parents and top-level tasks). The response will include `ancestor_ids`, which references the data in the `stories` top-level key.\\n- `assigned_role` (Role) - Retrieves the authenticated user’s assigned role for the task. The response will include `assigned_role_id`, which references the data in the `roles` top-level key.\\n- `assignees` (User) - Retrieves all users assigned to the task, excluding unnamed resources. The response will include `assignee_ids`, which references the data in the `users` top-level key.\\n- `attachments` (Attachments::PostAttachment) - Retrieves all attachments in the task's posts. The response will include `attachment_ids`, which references the data in the `attachments` top-level key.  Must be used with the `only` parameter.\\n- `creator` (User) - Retrieves the user who created the task. The response will include `creator_id`, which references the data in the `users` top-level key.\\n- `current_assignments` (Assignment) - Retrieves all assignments for the task. The response will include `current_assignment_ids`, which references the data in the `assignments` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the task’s custom field values. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `descendants` (Story) - Retrieves all of the subtasks nested under this top-level task. The response will include `descendant_ids`, which references the data in the `stories` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `followers` (User) - Retrieves all users following the task. The response will include `follower_ids`, which references the data in the `users` top-level key.\\n- `google_documents` (GoogleDocument) - Retrieves all Google documents for the task. The response will include `google_document_ids`, which references the data in the `google_documents` top-level key.  Must be used with the `only` parameter.\\n- `parent` (Story) - Retrieves the parent task that this subtask is nested directly under. The response will include `parent_id`, which references the data in the `stories` top-level key.\\n- `potential_workspace_resources` (WorkspaceResource) - Retrieves the project's named resources who are not assigned to the task. The response will include `potential_workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.  Must be used with the `only` parameter.\\n- `potential_workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves all of the project's resources (named and unnamed) who are not assigned to the task. The response will include `potential_workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.  Must be used with the `only` parameter.\\n- `proofs` (Proof) - Retrieves all proofs for the task. The response will include `proof_ids`, which references the data in the `proofs` top-level key. **Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this option will be unavailable.\\n- `replies` (Post) - Retrieves all task posts, except for the first one. The response will include `reply_ids`, which references the data in the `posts` top-level key.  Must be used with the `only` parameter.\\n- `root` (Story) - Retrieves the top-level task that this subtask is nested under. The response will include `root_id`, which references the data in the `stories` top-level key.\\n- `source_dependencies` (StoryDependency) - Retrieves all tasks that this task is dependent on. The response will include `source_dependency_ids`, which references the data in the `story_dependencies` top-level key.\\n- `story_state_changes` (StoryStateChange) - Retrieves all status changes the task has gone through. The response will include `story_state_change_ids`, which references the data in the `story_state_changes` top-level key.  Must be used with the `only` parameter.\\n- `story_tasks` (StoryTask) - Retrieves all checklist items for the task. The response will include `story_task_ids`, which references the data in the `story_tasks` top-level key.\\n- `sub_stories` (Story) - Retrieves all direct subtasks of the task. This does not include the subtasks of its direct subtasks. The response will include `sub_story_ids`, which references the data in the `stories` top-level key.\\n- `tags` (ActsAsTaggableOn::Tag) - Retrieves all tags for the task. The response will include `tag_ids`, which references the data in the `tags` top-level key.\\n- `target_dependencies` (StoryDependency) - Retrieves all tasks that are dependent on this task. The response will include `target_dependency_ids`, which references the data in the `story_dependencies` top-level key.\\n- `workspace` (Workspace) - Retrieves the project the task is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources who are assigned to the task. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves all of the resources (named and unnamed) assigned to the task. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"not_assigned_to_resource\",\"description\":\"Filter for tasks not assigned to the specified resource (ID).\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"not_assigned_to_user\",\"description\":\"Filter for tasks not assigned to the specified user (ID).\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_archived\",\"description\":\"If set to `true`, filters for archived tasks.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only_deleted\",\"description\":\"If set to `true`, filters for deleted tasks.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only_todos\",\"description\":\"If set to `true`, filters for only To Dos.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"read_only\",\"can_edit\",\"can_post\",\"archived_editable\",\"is_time_trackable_type\",\"has_out_of_bounds_sads\",\"can_align_time\",\"formatted_description\",\"parsed_description\",\"render_description_markdown\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `due_date:asc`, `due_date:desc`, `importance`, `parent_and_position`, `position`, `priority_level:asc`, `priority_level:desc`, `start_date:asc`, `start_date:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"parents_only\",\"description\":\"Filter for top-level tasks. This does not include subtasks that have other subtasks nested under them.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"priority\",\"description\":\"Filter for tasks with the specified priorities. Give multiple priorities in a comma-separated list\\n        (`GET https://api.mavenlink.com/api/v1/stories?priority=critical,high`).\\n        Valid values: `critical`, `high`, `normal`, `low`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"search\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"show_archived\",\"description\":\"If set to `true`, includes archived tasks in the response.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"show_deleted\",\"description\":\"If set to `true`, includes deleted tasks.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"show_from_archived_workspaces\",\"description\":\"If set to `true`, filters for tasks in archived projects.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"show_todos\",\"description\":\"If set to `true`, includes To Dos in the response.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"starting_between\",\"description\":\"Filter for tasks with a start date that is within a specified date range. Specify the date range with\\n        a pair of colon-separated dates, in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format. For example, `2013-06-01:2013-08-01`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"story_type\",\"description\":\"Include tasks of the specified type. Valid values: `task`, `milestone`, `deliverable`, `issue`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"story_types\",\"description\":\"Filter for tasks of the specified type(s). Give multiple task types in a comma-separated list.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"time_trackable_on_workspace_id\",\"description\":\"Filter for tasks that [time can be tracked against](https://mavenlink.zendesk.com/hc/en-us/articles/360008143214)\\n        in the specified project (ID).\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"uncompleted\",\"description\":\"If set to `true`, filters for incomplete tasks.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_ancestry_depth\",\"description\":\"Include [subtasks](https://mavenlink.zendesk.com/hc/en-us/articles/205221350)\\n        that are nested at the specified level from the top-level task (e.g. `GET /api/v1/stories.json?with_ancestry_depth=3`).\\n        The top-level task is considered to be at the 0 level. Subtasks can be nested up to 4 levels from the top-level task.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"with_assignees\",\"description\":\"Filter for tasks assigned to the specified users. Give multiple user IDs in a comma-separated list\\n(e.g. `GET https://api.mavenlink.com/api/v1/stories?with_assignees=1,2,3`).\\n\\nIn addition to user IDs, you can also pass `unassigned` and `unnamed`.\\nThese can be included in a comma-separated list\\n(e.g. `GET https://api.mavenlink.com/api/v1/stories?with_assignees=1,2,3,unassigned,unnamed`).\\n`unassigned` returns tasks that are not assigned to any users.\\n`unnamed` returns tasks assigned to unnamed resources.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"with_followers\",\"description\":\"Filter for tasks with the specified followers. Give multiple user IDs in a comma-separated list.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"with_parent_id\",\"description\":\"Filter for [subtasks](https://mavenlink.zendesk.com/hc/en-us/articles/205221350) that are directly nested under\\n        the specified task (ID).\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"with_projects\",\"description\":\"Include tasks in the specified projects. Give multiple project IDs in a comma-separated list.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"with_root_id\",\"description\":\"Filter for [subtasks](https://mavenlink.zendesk.com/hc/en-us/articles/205221350)\\n        that are nested at any level under the specified task (ID).\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"with_start_or_due_date\",\"description\":\"Filter for tasks with start or due dates.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_past_completed\",\"description\":\"If set to `true`, filters for tasks that haven't previously been marked as completed.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter for tasks from the specified project (ID).\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Stories have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"story_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryTask\"}},\"tags\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ActsAsTaggableOn_Tag\"}},\"story_state_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryStateChange\"}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_PostAttachment\"}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"story_dependencies\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryDependency\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Story\",\"description\":\"The maximum number of stories that can be created in a single request is 300.\\n\\n\\nThis endpoint returns structured Story objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `stories` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-story\",\"tags\":[\"Stories\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `ancestors` (Story) - Retrieves all of the tasks that the task is nested under (parents and top-level tasks). The response will include `ancestor_ids`, which references the data in the `stories` top-level key.\\n- `assigned_role` (Role) - Retrieves the authenticated user’s assigned role for the task. The response will include `assigned_role_id`, which references the data in the `roles` top-level key.\\n- `assignees` (User) - Retrieves all users assigned to the task, excluding unnamed resources. The response will include `assignee_ids`, which references the data in the `users` top-level key.\\n- `attachments` (Attachments::PostAttachment) - Retrieves all attachments in the task's posts. The response will include `attachment_ids`, which references the data in the `attachments` top-level key.  Must be used with the `only` parameter.\\n- `creator` (User) - Retrieves the user who created the task. The response will include `creator_id`, which references the data in the `users` top-level key.\\n- `current_assignments` (Assignment) - Retrieves all assignments for the task. The response will include `current_assignment_ids`, which references the data in the `assignments` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the task’s custom field values. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `descendants` (Story) - Retrieves all of the subtasks nested under this top-level task. The response will include `descendant_ids`, which references the data in the `stories` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `followers` (User) - Retrieves all users following the task. The response will include `follower_ids`, which references the data in the `users` top-level key.\\n- `google_documents` (GoogleDocument) - Retrieves all Google documents for the task. The response will include `google_document_ids`, which references the data in the `google_documents` top-level key.  Must be used with the `only` parameter.\\n- `parent` (Story) - Retrieves the parent task that this subtask is nested directly under. The response will include `parent_id`, which references the data in the `stories` top-level key.\\n- `potential_workspace_resources` (WorkspaceResource) - Retrieves the project's named resources who are not assigned to the task. The response will include `potential_workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.  Must be used with the `only` parameter.\\n- `potential_workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves all of the project's resources (named and unnamed) who are not assigned to the task. The response will include `potential_workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.  Must be used with the `only` parameter.\\n- `proofs` (Proof) - Retrieves all proofs for the task. The response will include `proof_ids`, which references the data in the `proofs` top-level key. **Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this option will be unavailable.\\n- `replies` (Post) - Retrieves all task posts, except for the first one. The response will include `reply_ids`, which references the data in the `posts` top-level key.  Must be used with the `only` parameter.\\n- `root` (Story) - Retrieves the top-level task that this subtask is nested under. The response will include `root_id`, which references the data in the `stories` top-level key.\\n- `source_dependencies` (StoryDependency) - Retrieves all tasks that this task is dependent on. The response will include `source_dependency_ids`, which references the data in the `story_dependencies` top-level key.\\n- `story_state_changes` (StoryStateChange) - Retrieves all status changes the task has gone through. The response will include `story_state_change_ids`, which references the data in the `story_state_changes` top-level key.  Must be used with the `only` parameter.\\n- `story_tasks` (StoryTask) - Retrieves all checklist items for the task. The response will include `story_task_ids`, which references the data in the `story_tasks` top-level key.\\n- `sub_stories` (Story) - Retrieves all direct subtasks of the task. This does not include the subtasks of its direct subtasks. The response will include `sub_story_ids`, which references the data in the `stories` top-level key.\\n- `tags` (ActsAsTaggableOn::Tag) - Retrieves all tags for the task. The response will include `tag_ids`, which references the data in the `tags` top-level key.\\n- `target_dependencies` (StoryDependency) - Retrieves all tasks that are dependent on this task. The response will include `target_dependency_ids`, which references the data in the `story_dependencies` top-level key.\\n- `workspace` (Workspace) - Retrieves the project the task is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources who are assigned to the task. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves all of the resources (named and unnamed) assigned to the task. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"read_only\",\"can_edit\",\"can_post\",\"archived_editable\",\"is_time_trackable_type\",\"has_out_of_bounds_sads\",\"can_align_time\",\"formatted_description\",\"parsed_description\",\"render_description_markdown\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"story\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The workspace ID where this story should be created.\"},\"title\":{\"type\":\"string\"},\"story_type\":{\"type\":\"string\",\"description\":\"Must be one of: 'task', 'deliverable', 'milestone', or 'issue'. Defaults to: 'task'.\",\"enum\":[\"task\",\"deliverable\",\"milestone\",\"issue\"]},\"description\":{\"type\":\"string\",\"description\":\"Must be less than 1000 characters.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Projected start date of the project. Format should look like YYYY-MM-DD. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Projected end date of the project. Format should look like YYYY-MM-DD. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"state\":{\"type\":\"string\",\"description\":\"The current state of the story, state options are based on the story_type:\\n  - States for task, deliverable and milestones are not started, started, and completed.\\n  - States for issues are new, reopened, in progress, blocked, fixed, duplicate, can't repro,\\n    resolved, and won't fix.\",\"enum\":[\"not started\",\"started\",\"completed\",\"new\",\"reopened\",\"in progress\",\"blocked\",\"fixed\",\"duplicate\",\"can't repro\"]},\"checklist\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"An array of checklist items.\"},\"parent_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Represents the parent of this story, making this a substory.\"},\"archived\":{\"type\":\"boolean\",\"description\":\"Boolean representing whether or not this story is archived.\"},\"assignee_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of user IDs.\"},\"assignments\":{\"type\":\"object\",\"properties\":{\"role_id\":{\"type\":\"integer\",\"format\":\"int32\"},\"assignee_id\":{\"type\":\"integer\",\"format\":\"int32\"},\"workspace_resource_id\":{\"type\":\"integer\",\"format\":\"int32\"},\"estimated_minutes\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"budget_estimate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Can only be set if the workspace is budgeted and the user has budget permissions.\"},\"time_estimate_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Can only be set if the workspace is budgeted and the user has budget permissions.\"},\"tag_list\":{\"type\":\"string\",\"description\":\"A comma separated.\"},\"percentage_complete\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Between 0 and 100. Setting above 0 starts the story and setting to 100 completes the story..\"},\"fixed_fee\":{\"type\":\"boolean\",\"description\":\"Representing whether the story is fixed fee or not. Can only be set if the workspace is budgeted and the user has budget permissions.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"Representing whether the story is billable or not. Can only be set if the workspace is budgeted and the user has budget permissions.\"},\"weight\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Representing the weight of the story. Can only be set on a parent-level milestone by a consultant with at least budget permissions.\"},\"priority\":{\"type\":\"string\",\"description\":\"The current priority (importance) of the story (low, normal, high, critical). The default is normal..\",\"enum\":[\"low\",\"normal\",\"high\",\"critical\"]},\"time_trackable\":{\"type\":\"boolean\",\"description\":\"Representing whether the story can have time logged against it.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]},\"custom_fields\":{\"type\":\"array\",\"description\":\"Determines the custom field values for the task.\",\"items\":{\"type\":\"object\",\"properties\":{\"custom_field_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the custom field.\"},\"value\":{\"type\":\"string\",\"description\":\"The value for the corresponding custom field. The value formats for different types are:\\n\\n* `string` - `<text_string>`, eg. `'foo'`\\n* `date` - `<ISO_8601 Date Format>` eg. `'2014-02-25'` `(accepted range: '1900-01-01' to '2015-12-31')`\\n* `number` - `<integer_value>` eg. `'13'`\\n* `currency` - `[<int_value_in_cents>, <currency_code>]` eg. `'[998, USD]'`\\n* `single` and `multi` - `[<choice_ids>]` eg. `'[1, 2, 4]'`.\"}}}},\"attachment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The attachment ids for the files to be associated with the project after its created.\"},\"project_plan\":{\"type\":\"boolean\",\"description\":\"Whether the story is a project task (`true`) or is a To Do (`false`).\"}},\"required\":[\"workspace_id\",\"title\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Story has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"story_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryTask\"}},\"tags\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ActsAsTaggableOn_Tag\"}},\"story_state_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryStateChange\"}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_PostAttachment\"}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"story_dependencies\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryDependency\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/stories/{id}\":{\"get\":{\"summary\":\"Fetching a single Story\",\"description\":\"This endpoint returns structured Story objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `stories` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story\",\"tags\":[\"Stories\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `ancestors` (Story) - Retrieves all of the tasks that the task is nested under (parents and top-level tasks). The response will include `ancestor_ids`, which references the data in the `stories` top-level key.\\n- `assigned_role` (Role) - Retrieves the authenticated user’s assigned role for the task. The response will include `assigned_role_id`, which references the data in the `roles` top-level key.\\n- `assignees` (User) - Retrieves all users assigned to the task, excluding unnamed resources. The response will include `assignee_ids`, which references the data in the `users` top-level key.\\n- `attachments` (Attachments::PostAttachment) - Retrieves all attachments in the task's posts. The response will include `attachment_ids`, which references the data in the `attachments` top-level key.  Must be used with the `only` parameter.\\n- `creator` (User) - Retrieves the user who created the task. The response will include `creator_id`, which references the data in the `users` top-level key.\\n- `current_assignments` (Assignment) - Retrieves all assignments for the task. The response will include `current_assignment_ids`, which references the data in the `assignments` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the task’s custom field values. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `descendants` (Story) - Retrieves all of the subtasks nested under this top-level task. The response will include `descendant_ids`, which references the data in the `stories` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `followers` (User) - Retrieves all users following the task. The response will include `follower_ids`, which references the data in the `users` top-level key.\\n- `google_documents` (GoogleDocument) - Retrieves all Google documents for the task. The response will include `google_document_ids`, which references the data in the `google_documents` top-level key.  Must be used with the `only` parameter.\\n- `parent` (Story) - Retrieves the parent task that this subtask is nested directly under. The response will include `parent_id`, which references the data in the `stories` top-level key.\\n- `potential_workspace_resources` (WorkspaceResource) - Retrieves the project's named resources who are not assigned to the task. The response will include `potential_workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.  Must be used with the `only` parameter.\\n- `potential_workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves all of the project's resources (named and unnamed) who are not assigned to the task. The response will include `potential_workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.  Must be used with the `only` parameter.\\n- `proofs` (Proof) - Retrieves all proofs for the task. The response will include `proof_ids`, which references the data in the `proofs` top-level key. **Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this option will be unavailable.\\n- `replies` (Post) - Retrieves all task posts, except for the first one. The response will include `reply_ids`, which references the data in the `posts` top-level key.  Must be used with the `only` parameter.\\n- `root` (Story) - Retrieves the top-level task that this subtask is nested under. The response will include `root_id`, which references the data in the `stories` top-level key.\\n- `source_dependencies` (StoryDependency) - Retrieves all tasks that this task is dependent on. The response will include `source_dependency_ids`, which references the data in the `story_dependencies` top-level key.\\n- `story_state_changes` (StoryStateChange) - Retrieves all status changes the task has gone through. The response will include `story_state_change_ids`, which references the data in the `story_state_changes` top-level key.  Must be used with the `only` parameter.\\n- `story_tasks` (StoryTask) - Retrieves all checklist items for the task. The response will include `story_task_ids`, which references the data in the `story_tasks` top-level key.\\n- `sub_stories` (Story) - Retrieves all direct subtasks of the task. This does not include the subtasks of its direct subtasks. The response will include `sub_story_ids`, which references the data in the `stories` top-level key.\\n- `tags` (ActsAsTaggableOn::Tag) - Retrieves all tags for the task. The response will include `tag_ids`, which references the data in the `tags` top-level key.\\n- `target_dependencies` (StoryDependency) - Retrieves all tasks that are dependent on this task. The response will include `target_dependency_ids`, which references the data in the `story_dependencies` top-level key.\\n- `workspace` (Workspace) - Retrieves the project the task is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources who are assigned to the task. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves all of the resources (named and unnamed) assigned to the task. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"read_only\",\"can_edit\",\"can_post\",\"archived_editable\",\"is_time_trackable_type\",\"has_out_of_bounds_sads\",\"can_align_time\",\"formatted_description\",\"parsed_description\",\"render_description_markdown\"]}}},{\"in\":\"query\",\"name\":\"show_deleted\",\"required\":false,\"description\":\"Returns a deleted story when set to true.\",\"schema\":{\"type\":\"boolean\",\"default\":false}}],\"responses\":{\"200\":{\"description\":\"The Story has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"story_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryTask\"}},\"tags\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ActsAsTaggableOn_Tag\"}},\"story_state_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryStateChange\"}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_PostAttachment\"}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"story_dependencies\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryDependency\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Story\",\"description\":\"This endpoint returns structured Story objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `stories` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-story\",\"tags\":[\"Stories\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `ancestors` (Story) - Retrieves all of the tasks that the task is nested under (parents and top-level tasks). The response will include `ancestor_ids`, which references the data in the `stories` top-level key.\\n- `assigned_role` (Role) - Retrieves the authenticated user’s assigned role for the task. The response will include `assigned_role_id`, which references the data in the `roles` top-level key.\\n- `assignees` (User) - Retrieves all users assigned to the task, excluding unnamed resources. The response will include `assignee_ids`, which references the data in the `users` top-level key.\\n- `attachments` (Attachments::PostAttachment) - Retrieves all attachments in the task's posts. The response will include `attachment_ids`, which references the data in the `attachments` top-level key.  Must be used with the `only` parameter.\\n- `creator` (User) - Retrieves the user who created the task. The response will include `creator_id`, which references the data in the `users` top-level key.\\n- `current_assignments` (Assignment) - Retrieves all assignments for the task. The response will include `current_assignment_ids`, which references the data in the `assignments` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the task’s custom field values. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `descendants` (Story) - Retrieves all of the subtasks nested under this top-level task. The response will include `descendant_ids`, which references the data in the `stories` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `followers` (User) - Retrieves all users following the task. The response will include `follower_ids`, which references the data in the `users` top-level key.\\n- `google_documents` (GoogleDocument) - Retrieves all Google documents for the task. The response will include `google_document_ids`, which references the data in the `google_documents` top-level key.  Must be used with the `only` parameter.\\n- `parent` (Story) - Retrieves the parent task that this subtask is nested directly under. The response will include `parent_id`, which references the data in the `stories` top-level key.\\n- `potential_workspace_resources` (WorkspaceResource) - Retrieves the project's named resources who are not assigned to the task. The response will include `potential_workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.  Must be used with the `only` parameter.\\n- `potential_workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves all of the project's resources (named and unnamed) who are not assigned to the task. The response will include `potential_workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.  Must be used with the `only` parameter.\\n- `proofs` (Proof) - Retrieves all proofs for the task. The response will include `proof_ids`, which references the data in the `proofs` top-level key. **Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this option will be unavailable.\\n- `replies` (Post) - Retrieves all task posts, except for the first one. The response will include `reply_ids`, which references the data in the `posts` top-level key.  Must be used with the `only` parameter.\\n- `root` (Story) - Retrieves the top-level task that this subtask is nested under. The response will include `root_id`, which references the data in the `stories` top-level key.\\n- `source_dependencies` (StoryDependency) - Retrieves all tasks that this task is dependent on. The response will include `source_dependency_ids`, which references the data in the `story_dependencies` top-level key.\\n- `story_state_changes` (StoryStateChange) - Retrieves all status changes the task has gone through. The response will include `story_state_change_ids`, which references the data in the `story_state_changes` top-level key.  Must be used with the `only` parameter.\\n- `story_tasks` (StoryTask) - Retrieves all checklist items for the task. The response will include `story_task_ids`, which references the data in the `story_tasks` top-level key.\\n- `sub_stories` (Story) - Retrieves all direct subtasks of the task. This does not include the subtasks of its direct subtasks. The response will include `sub_story_ids`, which references the data in the `stories` top-level key.\\n- `tags` (ActsAsTaggableOn::Tag) - Retrieves all tags for the task. The response will include `tag_ids`, which references the data in the `tags` top-level key.\\n- `target_dependencies` (StoryDependency) - Retrieves all tasks that are dependent on this task. The response will include `target_dependency_ids`, which references the data in the `story_dependencies` top-level key.\\n- `workspace` (Workspace) - Retrieves the project the task is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources who are assigned to the task. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves all of the resources (named and unnamed) assigned to the task. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"read_only\",\"can_edit\",\"can_post\",\"archived_editable\",\"is_time_trackable_type\",\"has_out_of_bounds_sads\",\"can_align_time\",\"formatted_description\",\"parsed_description\",\"render_description_markdown\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"story\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title cannot be made blank.\"},\"story_type\":{\"type\":\"string\",\"description\":\"Must be 'task', 'deliverable', 'milestone', or 'issue'.\"},\"description\":{\"type\":\"string\",\"description\":\"Must be less than 1000 characters.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Projected start date of the project. Format should look like YYYY-MM-DD. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Projected end date of the project. Format should look like YYYY-MM-DD. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"state\":{\"type\":\"string\",\"description\":\"The current state of the story, state options are based on the story_type:\\n  - States for task, deliverable and milestones are not started, started, and completed.\\n  - States for issues are new, reopened, in progress, blocked, fixed, duplicate, can't repro,\\n    resolved, and won't fix.\"},\"follower_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"Array of user IDs who are following the story.\"},\"parent_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Represents the parent of this story, making this a substory.\"},\"archived\":{\"type\":\"boolean\",\"description\":\"Boolean representing whether or not this story is archived.\"},\"assignee_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of user IDs.\"},\"assignments\":{\"type\":\"object\",\"properties\":{\"role_id\":{\"type\":\"integer\",\"format\":\"int32\"},\"assignee_id\":{\"type\":\"integer\",\"format\":\"int32\"},\"workspace_resource_id\":{\"type\":\"integer\",\"format\":\"int32\"},\"estimated_minutes\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"budget_estimate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Can only be set if the workspace is budgeted and the user has budget permissions.\"},\"time_estimate_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Can only be set if the workspace is budgeted and the user has budget permissions.\"},\"tag_list\":{\"type\":\"string\",\"description\":\"A comma separated.\"},\"percentage_complete\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Between 0 and 100. Setting above 0 starts the story and setting to 100 completes the story..\"},\"fixed_fee\":{\"type\":\"boolean\",\"description\":\"Representing whether the story is fixed fee or not. Can only be set if the workspace is budgeted and the user has budget permissions.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"Representing whether the story is billable or not. Can only be set if the workspace is budgeted and the user has budget permissions.\"},\"weight\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Representing the weight of the story. Can only be set on a parent-level milestone by a consultant with at least budget permissions.\"},\"priority\":{\"type\":\"string\",\"description\":\"The current priority (importance) of the story (low, normal, high, critical). The default is normal..\"},\"time_trackable\":{\"type\":\"boolean\",\"description\":\"Representing whether the story can have time logged against it.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]},\"custom_fields\":{\"type\":\"array\",\"description\":\"Determines the custom field values for the task.\",\"items\":{\"type\":\"object\",\"properties\":{\"custom_field_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the custom field.\"},\"value\":{\"type\":\"string\",\"description\":\"The value for the corresponding custom field. The value formats for different types are:\\n\\n* `string` - `<text_string>`, eg. `'foo'`\\n* `date` - `<ISO_8601 Date Format>` eg. `'2014-02-25'` `(accepted range: '1900-01-01' to '2015-12-31')`\\n* `number` - `<integer_value>` eg. `'13'`\\n* `currency` - `[<int_value_in_cents>, <currency_code>]` eg. `'[998, USD]'`\\n* `single` and `multi` - `[<choice_ids>]` eg. `'[1, 2, 4]'`.\"}}}}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Story has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"story_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryTask\"}},\"tags\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ActsAsTaggableOn_Tag\"}},\"story_state_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryStateChange\"}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"attachments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Attachments_PostAttachment\"}},\"proofs\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Proof\"}},\"story_dependencies\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryDependency\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Story\",\"description\":\"Soft deletes a task (by setting a value for `deleted_at`). You can view soft deleted tasks by fetching a\\nlist of tasks with the `only_deleted` filter set to `true`.\\n\\nNote: Tasks are only permanently deleted when the project is deleted.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-story\",\"tags\":[\"Stories\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Story has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_allocation_days\":{\"get\":{\"summary\":\"Fetching a list of Daily Scheduled Hours (Story Allocation Days)\",\"description\":\"Returns all Daily Scheduled Hours that are visible to the requester,\\nbased on permissions. Filter results by specific projects, users, tasks, and more.\\n\\n**NOTES**:\\n- The response includes Daily Scheduled Hours that are part of inactive Assignments, by default.\\nTo filter these out, use the `current` parameter.\\n- If you are an Account Administrator, you can use the `only_my_account` parameter to filter for\\nDaily Scheduled Hours from only your account. This optimizes performance of the endpoint.\\n\\nThe returned Daily Scheduled Hours are sorted by when they were last updated.\\n\\n\\nThis endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_allocation_days` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story-allocation-days\",\"tags\":[\"Daily Scheduled Hours (Story Allocation Days)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"assignee_id\",\"description\":\"Returns Daily Scheduled Hours that are assigned to the User of the specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"assignment_id\",\"description\":\"Returns Daily Scheduled Hours that belong to the Assignment of the specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"current\",\"description\":\"Returns Daily Scheduled Hours that belong to active Assignments.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"date_between\",\"description\":\"Requires a colon separated pair of dates in YYYY-MM-DD format. Results are inclusive of the endpoints. If a date is not passed in, it is interpreted as negative or positive infinity.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"in_unarchived_stories\",\"description\":\"Returns Daily Scheduled Hours that belong to active (not archived) Stories.\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"in_unarchived_workspaces\",\"description\":\"Returns Daily Scheduled Hours that belong to active (not archived) Workspaces.\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `assignment` (Assignment) - Reference the Assignment of the Story Allocation Day.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `story` (Story) - Reference the Story of the Story Allocation Day.\\n- `workspace` (Workspace) - Reference the Workspace of the Story Allocation Day.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include_unnamed\",\"required\":false,\"description\":\"Includes Daily Scheduled Hours from Assignments with\\n[unnamed resources](https://mavenlink.zendesk.com/hc/en-us/articles/115004696493#Unnamed).\\nThink of unnamed resources as placeholders; it indicates the need for a certain role,\\nbefore knowing who will fill it.\\n\\nSet to `False` by default.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_my_account\",\"required\":false,\"description\":\"If you are an Account Administrator, you can set this to `True` in order to filter\\nfor Daily Scheduled Hours from only your account.\\n\\nEnabling this filter optimizes performance of the endpoint.\\nThe filter is set to `False` by default.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `date:asc`, `date:desc`, `id:asc`, `id:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"story_id\",\"description\":\"Returns Daily Scheduled Hours that belong to the Story of the specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"uncurrent\",\"description\":\"Returns Daily Scheduled Hours that belong to inactive Assignments.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_at_between\",\"description\":\"Requires a colon separated pair of timestamps. Timestamps are in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) with colons removed. Results are inclusive of the endpoints. If a timestamp is not passed in, it is interpreted as negative or positive infinity.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Returns Daily Scheduled Hours that belong to the Workspace of the specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Daily Scheduled Hours (Story Allocation Day)s have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Daily Scheduled Hours (Story Allocation Day)\",\"description\":\"This endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_allocation_days` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-story-allocation-day\",\"tags\":[\"Daily Scheduled Hours (Story Allocation Days)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `assignment` (Assignment) - Reference the Assignment of the Story Allocation Day.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `story` (Story) - Reference the Story of the Story Allocation Day.\\n- `workspace` (Workspace) - Reference the Workspace of the Story Allocation Day.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"story_allocation_day\":{\"type\":\"object\",\"properties\":{\"assignment_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Assignment the Daily Scheduled Hours are part of.\"},\"date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date of the scheduled hours (e.g. 2014-12-31). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount of time scheduled for the day, in minutes\\n              (e.g. `120` for 120 minutes, which is 2 hours).\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"assignment_id\",\"date\",\"minutes\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Daily Scheduled Hours (Story Allocation Day) has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Delete multiple Daily Scheduled Hours (Story Allocation Days)\",\"description\":\"The IDs of the Daily Scheduled Hours to delete can be provided in the `ids` query parameter or\\nvia the request body. Only daily scheduled hours on your account can be deleted.\\nRequest body example:\\n```{\\n  \\\"ids\\\": \\\"1,2,3\\\"\\n}```\\nIf any specified Daily Scheduled Hours cannot be deleted, the entire request will fail and an error message\\nwill be returned that specifies which ones could not be deleted and why.\\n\\n\\nThis endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_allocation_days` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"delete-story-allocation-days\",\"tags\":[\"Daily Scheduled Hours (Story Allocation Days)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"ids\",\"required\":false,\"description\":\"A comma-separated list of IDs of Daily Scheduled Hours. You can provide up to 100 IDs. The IDs can be\\nprovided in this query parameter or via the request body.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"204\":{\"description\":\"Daily Scheduled Hours (Story Allocation Day) has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_allocation_days/{id}\":{\"get\":{\"summary\":\"Fetching a single Daily Scheduled Hours (Story Allocation Day)\",\"description\":\"This endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_allocation_days` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story-allocation-day\",\"tags\":[\"Daily Scheduled Hours (Story Allocation Days)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `assignment` (Assignment) - Reference the Assignment of the Story Allocation Day.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `story` (Story) - Reference the Story of the Story Allocation Day.\\n- `workspace` (Workspace) - Reference the Workspace of the Story Allocation Day.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Daily Scheduled Hours (Story Allocation Day) has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Daily Scheduled Hours (Story Allocation Day)\",\"description\":\"This endpoint returns structured Daily Scheduled Hours (Story Allocation Day) objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_allocation_days` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-story-allocation-day\",\"tags\":[\"Daily Scheduled Hours (Story Allocation Days)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `assignment` (Assignment) - Reference the Assignment of the Story Allocation Day.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `story` (Story) - Reference the Story of the Story Allocation Day.\\n- `workspace` (Workspace) - Reference the Workspace of the Story Allocation Day.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"story_allocation_day\":{\"type\":\"object\",\"properties\":{\"minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount of time scheduled for the day, in minutes\\n              (e.g. `120` for 120 minutes, which is 2 hours).\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"minutes\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Daily Scheduled Hours (Story Allocation Day) has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_allocation_days\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryAllocationDay\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"assignments\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Assignment\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Daily Scheduled Hours (Story Allocation Day)\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-story-allocation-day\",\"tags\":[\"Daily Scheduled Hours (Story Allocation Days)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Daily Scheduled Hours (Story Allocation Day) has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_dependencies\":{\"get\":{\"summary\":\"Fetching a list of Story Dependencies\",\"description\":\"This endpoint returns structured Story Dependency objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_dependencies` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story-dependencies\",\"tags\":[\"Story Dependencies\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `source` (Story) - The tasks that are predecessor tasks.\\n- `target` (Story) - The tasks that are successor tasks.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `updated_at:asc` and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"show_archived\",\"description\":\"If set to `true`, includes in the response dependencies where the target is an archived task.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"show_deleted\",\"description\":\"If set to `true`, includes in the response dependencies where the target is an deleted task.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"show_from_archived_workspaces\",\"description\":\"If set to `true`, includes in the response dependencies where the tasks belong to archived projects.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"source_id\",\"description\":\"Filter for dependencies where this task is the predecessor, i.e. the task that controls the start or end date for all related successor tasks.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"target_id\",\"description\":\"Filter for dependencies where this task is the successor, i.e. the task whose start or end date is controlled by a predecessor.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter for dependencies where the tasks belong to a specific project.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Story Dependencies have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_dependencies\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryDependency\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_dependencies/{id}\":{\"get\":{\"summary\":\"Fetching a single Story Dependency\",\"description\":\"This endpoint returns structured Story Dependency objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_dependencies` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story-dependency\",\"tags\":[\"Story Dependencies\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `source` (Story) - The tasks that are predecessor tasks.\\n- `target` (Story) - The tasks that are successor tasks.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Story Dependency has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_dependencies\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryDependency\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_follows\":{\"get\":{\"summary\":\"Fetching a list of Story Follows\",\"description\":\"By default, you will get all story follows that you are permitted to see. If you are an Administrator,\\nyou will see every story follow on your account. Otherwise you will see every story follow in projects\\nin which you are participating.\",\"operationId\":\"get-story-follows\",\"tags\":[\"Followers\"],\"responses\":{\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Following a story\",\"operationId\":\"create-story-follow\",\"tags\":[\"Followers\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"story_follow\":{\"type\":\"object\",\"properties\":{\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated task (story).\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated user.\"}},\"required\":[\"story_id\",\"user_id\"]}}}}},\"required\":true},\"responses\":{\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_follows/{id}\":{\"get\":{\"summary\":\"Retrieving a single Story Follow\",\"operationId\":\"get-story-follow\",\"tags\":[\"Followers\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Unfollowing a story\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-story-follow\",\"tags\":[\"Followers\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"object has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_state_changes\":{\"get\":{\"summary\":\"Fetching a list of Story State Changes\",\"description\":\"The story state changes endpoint provides a list of state changes for a specified story. story_id is a\\nrequired parameter to retrieve story state changes for a specified story.\\n\\n\\nThis endpoint returns structured Story State Change objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_state_changes` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story-state-changes\",\"tags\":[\"Story State Changes\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `story` (Story) - Will reference the Story for which the story state change belongs.\\n- `user` (User) - Will reference the User for which the story state change belongs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Story State Changes have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_state_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryStateChange\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_state_changes/{id}\":{\"get\":{\"summary\":\"Fetching a single Story State Change\",\"description\":\"This endpoint returns structured Story State Change objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_state_changes` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story-state-change\",\"tags\":[\"Story State Changes\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `story` (Story) - Will reference the Story for which the story state change belongs.\\n- `user` (User) - Will reference the User for which the story state change belongs.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Story State Change has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_state_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryStateChange\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_tasks\":{\"get\":{\"summary\":\"Fetching a list of Story Tasks\",\"description\":\"Returns all story tasks belonging to stories in projects that the user is partcipating in.\\n\\n\\nThis endpoint returns structured Story Task objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_tasks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story-tasks\",\"tags\":[\"Story Tasks\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `completed_by` (User) - The User who completed this Story task, if any.\\n- `story` (Story) - The Story on which this Story Task exists.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `position:asc` and `position:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"position:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"show_archived\",\"description\":\"Include Story Tasks on archived Stories.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"show_deleted\",\"description\":\"Include Story Tasks on deleted Stories.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"show_from_archived_workspaces\",\"description\":\"Include Story Tasks on Stories in archived Workspaces.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"story_id\",\"description\":\"Only return the Story Task associated with the specified story_id.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Story Tasks have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryTask\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Story Task\",\"description\":\"This endpoint returns structured Story Task objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_tasks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-story-task\",\"tags\":[\"Story Tasks\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `completed_by` (User) - The User who completed this Story task, if any.\\n- `story` (Story) - The Story on which this Story Task exists.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"story_task\":{\"type\":\"object\",\"properties\":{\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated Story.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the story task.\"},\"completed\":{\"type\":\"boolean\",\"description\":\"Represents the completion of the story task.\"},\"position\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The Story Task's position in the list of story tasks.\"}},\"required\":[\"story_id\",\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Story Task has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryTask\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/story_tasks/{id}\":{\"get\":{\"summary\":\"Fetching a single Story Task\",\"description\":\"This endpoint returns structured Story Task objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_tasks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-story-task\",\"tags\":[\"Story Tasks\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `completed_by` (User) - The User who completed this Story task, if any.\\n- `story` (Story) - The Story on which this Story Task exists.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Story Task has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryTask\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Story Task\",\"description\":\"This endpoint returns structured Story Task objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `story_tasks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-story-task\",\"tags\":[\"Story Tasks\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `completed_by` (User) - The User who completed this Story task, if any.\\n- `story` (Story) - The Story on which this Story Task exists.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"story_task\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the story task.\"},\"completed\":{\"type\":\"boolean\",\"description\":\"Represents the completion of the story task.\"},\"position\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The Story Task's position in the list of story tasks.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Story Task has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"story_tasks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StoryTask\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Story Task\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-story-task\",\"tags\":[\"Story Tasks\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Story Task has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/subscribed_events\":{\"get\":{\"summary\":\"Fetching a list of Subscribed Events\",\"description\":\"Returns up to 9 days of records for all [event types](https://mavenlink.zendesk.com/hc/en-us/articles/4407962435227),\\nunless filter parameters have been applied.\\n\\nOnly records associated with the requester's Kantata OX account are returned.\\n\\n\\nThis endpoint returns structured Subscribed Event objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `subscribed_events` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-subscribed-events\",\"tags\":[\"Events\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"required\":false,\"description\":\"Filter for events created after a specified datetime. Events may be generated out of order or the\\n`subject_changed_at` and `created_at` times of an event can differ due to the lag between event\\noccurrence and generation. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"required\":false,\"description\":\"Filter for events created before a specified datetime. Events may be generated out of order or the\\n`subject_changed_at` and `created_at` times of an event can differ due to the lag between event\\noccurrence and generation. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"event_types\",\"required\":false,\"description\":\"Filter for records of specified [event types](https://mavenlink.zendesk.com/hc/en-us/articles/4407962435227).\\nSpecify multiple event types in a comma-separated list, like\\n`GET /api/v1/subscribed_events?event_types=time_entry:created,time_entry:updated,time_entry:deleted`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `subject` (polymorphic) - When included, each event object will include a `subject_ref` that references the subject the event belongs to. The `subject_ref` is a JSON object with an `id` and `key`, where the `key` is the subject type.\\n\\nFor example, a `workspace:updated` event will have a `subject_ref` referencing the workspace, and the `key` will be `workspaces`.\\n\\nIf the subject is not available, `subject_ref` will be null. A subject may be unavailable if it was deleted or was transferred to another account.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"most_recent\",\"required\":false,\"description\":\"If true, only the most recent event will be returned for each subject\\n(i.e. the most recent change that occurred for each subject). This filter cannot be used\\nin combination with `most_recent_by_event_type`.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"most_recent_by_event_type\",\"required\":false,\"description\":\"If true, only the most recent event of each event type will be returned for each subject.\\n\\nFor example, if a workspace was created, updated 3 times, and deleted, the following events will be\\ngenerated: 1 `workspace:created` event, 3 `workspace:updated` events, and 1 `workspace:deleted` event.\\nIf `most_recent_by_event_type` is true, the `workspace:created` event, the most recent `workspace:updated`\\nevent, and the `workspace:deleted` event will be returned. This filter cannot be used in combination with\\n`most_recent`.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"previous_payload\",\"current_payload\",\"payload_changes\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"subject_id\",\"required\":false,\"description\":\"Filter for events belonging to a specific subject (e.g. a user, a project, etc). When using this filter,\\nyou must also provide a `subject_type`. Multiple IDs can be provided in a comma-separated list\\n(e.g. `GET /api/v1/subscribed_events?subject_type=TimeEntry&subject_id=27,28,29`).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"subject_type\",\"required\":false,\"description\":\"Filter for events by a specific subject type. You can pass in only one subject type for this parameter.\\n  Supported subject types: \\\"AccountColor\\\", \\\"AccountLocation\\\", \\\"AccountMembership\\\", \\\"Assignment\\\", \\\"BudgetChangeOrder\\\",\\n  \\\"CostRate\\\", \\\"CustomField\\\", \\\"CustomFieldSet\\\", \\\"DefaultStatusSet\\\", \\\"EmailAddress\\\", \\\"Estimate\\\", \\\"EstimateScenario\\\",\\n  \\\"EstimateScenarioResource\\\", \\\"Expense\\\", \\\"ExpenseReportSubmission\\\", \\\"Invoice\\\", \\\"LineItemLock\\\", \\\"Organization\\\",\\n  \\\"OrganizationMembership\\\", \\\"Participation\\\", \\\"ProjectAccessControl\\\", \\\"Role\\\", \\\"ScheduleChangeOrder\\\", \\\"Skill\\\",\\n  \\\"SkillMembership\\\", \\\"StatusSet\\\", \\\"StatusSetOption\\\", \\\"Story\\\", \\\"StoryAllocationDay\\\", \\\"TimeEntry\\\",\\n  \\\"TimeOffEntry\\\", \\\"TimesheetSubmission\\\", \\\"User\\\", \\\"Vendor\\\", \\\"Workspace\\\", \\\"WorkspaceAllocation\\\", \\\"WorkspaceApprover\\\",\\n  \\\"WorkspaceGroup\\\", \\\"WorkspaceInvitation\\\", \\\"WorkspaceResource\\\", \\\"WorkspaceStatusSet\\\", \\\"Workweek\\\", \\\"WorkweekMembership\\\".\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Subscribed Events have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"subscribed_events\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SubscribedEvents_Models_SubscribedEvent\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/subscribed_events/event_types\":{\"get\":{\"summary\":\"Fetching a list of Subscribed Event Types\",\"description\":\"Returns a list of all [Event Types](https://mavenlink.zendesk.com/hc/en-us/articles/4407962435227)\\ntracked by Subscribed Events.\\n\\nThe event type schema, accessible using the `subscribed_event_type_schemas` key, is metadata that shows\\nthe structure of all events. The event types schema includes documentation for the events and fields.\\nYou can reference the event types schema as you build your application that processes subscribed events.\",\"operationId\":\"get-subscribed-event-types\",\"tags\":[\"Event Types\"],\"responses\":{\"200\":{\"description\":\"A list of objects have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"subscribed_event_types\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"A complete list of Subscribed Event Types.\"},\"subscribed_event_type_schemas\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\",\"description\":\"Provides a reference of all event types and the properties that the Subscribed Events\\nendpoint returns for each event type in the payload fields (`previous_payload`, `current_payload`,\\nand `payload_changes`).\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the event type.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the event type.\"},\"fields\":{\"type\":\"object\",\"description\":\"The properties that the Subscribed Events endpoint returns in the payload fields\\n(`previous_payload`, `current_payload`, and `payload_changes`) for an event type.\",\"additionalProperties\":{\"type\":\"object\",\"description\":\"The attribute key for the property.\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the property.\"},\"type\":{\"type\":\"string\",\"description\":\"The data type of the property value.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the property.\"},\"fields\":{\"type\":\"object\",\"description\":\"Nested attributes of the property if any.\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the nested property.\"},\"type\":{\"type\":\"string\",\"description\":\"The data type of the nested property value.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the nested property.\"}}}}}}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/survey_answers\":{\"get\":{\"summary\":\"Fetching a list of Survey Answers\",\"description\":\"This endpoint returns structured Survey Answer objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_answers` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-survey-answers\",\"tags\":[\"Survey Answers (Legacy)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (SurveyQuestionChoice) - The selected choices associated with an answer. Only populated on single or multi choice answers.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `survey_question` (SurveyQuestion) - The question that the answer is directed at.\\n- `survey_response` (SurveyResponse) - The response that the answer is tied to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"survey_response_id\",\"description\":\"Filter results by answers for a particular response.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Survey Answers have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_answers\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyAnswer\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Survey Answer\",\"description\":\"This endpoint returns structured Survey Answer objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_answers` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-survey-answer\",\"tags\":[\"Survey Answers (Legacy)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (SurveyQuestionChoice) - The selected choices associated with an answer. Only populated on single or multi choice answers.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `survey_question` (SurveyQuestion) - The question that the answer is directed at.\\n- `survey_response` (SurveyResponse) - The response that the answer is tied to.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"survey_answer\":{\"type\":\"object\",\"properties\":{\"survey_response_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Survey Response associated with the answer.\"},\"survey_question_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Survey Question that is being answered.\"},\"date_value\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date value for the answer. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"string_value\":{\"type\":\"string\",\"description\":\"The string value for the answer.\"},\"integer_value\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The integer value for the answer.\"},\"decimal_value\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The decimal value for the answer.\"},\"choice_values\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"An array of choice values for the answer.\"},\"choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of choice ids for the answer.\"}},\"required\":[\"survey_response_id\",\"survey_question_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Survey Answer has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_answers\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyAnswer\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/survey_answers/{id}\":{\"put\":{\"summary\":\"Updating an existing Survey Answer\",\"description\":\"This endpoint returns structured Survey Answer objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_answers` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-survey-answer\",\"tags\":[\"Survey Answers (Legacy)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (SurveyQuestionChoice) - The selected choices associated with an answer. Only populated on single or multi choice answers.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `survey_question` (SurveyQuestion) - The question that the answer is directed at.\\n- `survey_response` (SurveyResponse) - The response that the answer is tied to.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"survey_answer\":{\"type\":\"object\",\"properties\":{\"date_value\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date value for the answer. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"string_value\":{\"type\":\"string\",\"description\":\"The string value for the answer.\"},\"integer_value\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The integer value for the answer.\"},\"decimal_value\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The decimal value for the answer.\"},\"choice_values\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"An array of choice values for the answer.\"},\"choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of choice ids for the answer.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Survey Answer has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_answers\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyAnswer\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Survey Answer\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-survey-answer\",\"tags\":[\"Survey Answers (Legacy)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Survey Answer has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/survey_questions\":{\"get\":{\"summary\":\"Fetching a list of Survey Questions\",\"description\":\"This endpoint returns structured Survey Question objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_questions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-survey-questions\",\"tags\":[\"Survey Questions (Legacy)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (SurveyQuestionChoice) - The available choices associated with a question. Only populated on single or multi choice questions.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"included_on_template\",\"description\":\"Filter results for questions included on a particular template.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Survey Questions have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Survey Question\",\"description\":\"This endpoint returns structured Survey Question objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_questions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-survey-question\",\"tags\":[\"Survey Questions (Legacy)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (SurveyQuestionChoice) - The available choices associated with a question. Only populated on single or multi choice questions.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"survey_question\":{\"type\":\"object\",\"properties\":{\"text\":{\"type\":\"string\",\"description\":\"The text of the question.\"},\"question_type\":{\"type\":\"string\",\"description\":\"The type of the question. Valid values: single, multi, date, string, integer, decimal.\"},\"choices\":{\"type\":\"array\",\"description\":\"List of possible choices for the question. Only valid with single and multiple question type.\",\"items\":{\"type\":\"object\",\"properties\":{\"label\":{\"type\":\"string\",\"description\":\"Display label for the question choice.\"}}}}},\"required\":[\"text\",\"question_type\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Survey Question has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/survey_questions/{id}\":{\"put\":{\"summary\":\"Updating an existing Survey Question\",\"description\":\"This endpoint returns structured Survey Question objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_questions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-survey-question\",\"tags\":[\"Survey Questions (Legacy)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `choices` (SurveyQuestionChoice) - The available choices associated with a question. Only populated on single or multi choice questions.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"survey_question\":{\"type\":\"object\",\"properties\":{\"text\":{\"type\":\"string\",\"description\":\"The text of the question.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Survey Question has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Survey Question\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-survey-question\",\"tags\":[\"Survey Questions (Legacy)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Survey Question has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/survey_responses\":{\"get\":{\"summary\":\"Fetching a list of Survey Responses\",\"description\":\"This endpoint returns structured Survey Response objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_responses` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-survey-responses\",\"tags\":[\"Surveys Responses (Legacy)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `owner` (User) - The user who owns the survey response.\\n- `respondent` (User) - The user assigned to complete the survey response.\\n- `subject` (polymorphic) - The subject of the survey.\\n- `survey_answers` (SurveyAnswer) - The survey answers associated with the response.\\n- `survey_template` (SurveyTemplate) - The template that the survey response is based on.\\n- `workspace` (Workspace) - The workspace the survey is related to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"owner_id\",\"description\":\"Filter results by responses with a particular owner.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"respondent_id\",\"description\":\"Filter results by responses with a particular respondent.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"status\",\"description\":\"Filter results by responses with a particular status.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"subject_id\",\"description\":\"Filter results by responses with a particular subject id. Note: This should always be combined with the subject_type filter.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"subject_type\",\"description\":\"Filter results by responses with a particular subject type.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"survey_template_id\",\"description\":\"Filter results by responses that were created from a particular survey template.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter results by responses for a particular workspace.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Survey Responses have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyTemplate\"}},\"survey_answers\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyAnswer\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Survey Response\",\"description\":\"This endpoint returns structured Survey Response objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_responses` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-survey-response\",\"tags\":[\"Surveys Responses (Legacy)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `owner` (User) - The user who owns the survey response.\\n- `respondent` (User) - The user assigned to complete the survey response.\\n- `subject` (polymorphic) - The subject of the survey.\\n- `survey_answers` (SurveyAnswer) - The survey answers associated with the response.\\n- `survey_template` (SurveyTemplate) - The template that the survey response is based on.\\n- `workspace` (Workspace) - The workspace the survey is related to.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"survey_response\":{\"type\":\"object\",\"properties\":{\"survey_template_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The template that the survey response is based on.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the survey.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the survey.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the survey response.\"},\"subject_type\":{\"type\":\"string\",\"description\":\"The subject type of the survey. Valid values: User, Story, Workspace.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The Id of the survey subject.\"},\"owner_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user who owns the survey response.\"},\"respondent_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user assigned to complete the survey response.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The workspace the survey is related to.\"},\"open_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The open date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"close_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The close date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The due date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}},\"required\":[\"survey_template_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Survey Response has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyTemplate\"}},\"survey_answers\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyAnswer\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/survey_responses/{id}\":{\"put\":{\"summary\":\"Updating an existing Survey Response\",\"description\":\"This endpoint returns structured Survey Response objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_responses` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-survey-response\",\"tags\":[\"Surveys Responses (Legacy)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `owner` (User) - The user who owns the survey response.\\n- `respondent` (User) - The user assigned to complete the survey response.\\n- `subject` (polymorphic) - The subject of the survey.\\n- `survey_answers` (SurveyAnswer) - The survey answers associated with the response.\\n- `survey_template` (SurveyTemplate) - The template that the survey response is based on.\\n- `workspace` (Workspace) - The workspace the survey is related to.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"survey_response\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title of the survey.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the survey.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the survey response.\"},\"owner_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user who owns the survey response.\"},\"open_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The open date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"close_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The close date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The due date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Survey Response has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyTemplate\"}},\"survey_answers\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyAnswer\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Survey Response\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-survey-response\",\"tags\":[\"Surveys Responses (Legacy)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Survey Response has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/survey_templates\":{\"get\":{\"summary\":\"Fetching a list of Survey Templates\",\"description\":\"This endpoint returns structured Survey Template objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_templates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-survey-templates\",\"tags\":[\"Survey Templates (Legacy)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `owner` (User) - The user who owns all surveys based on this template.\\n- `respondent` (User) - The user assigned to respond to surveys based on this template.\\n- `subject` (polymorphic) - The subject of the survey (e.g. the user being reviewed).\\n- `survey_questions` (SurveyQuestion) - Includes survey questions associated with the survey template.\\n- `survey_responses` (SurveyResponse) - Includes the survey responses associated with the survey template.\\n- `workspace` (Workspace) - The workspace to be used as context for surveys based on this template.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"owner_id\",\"description\":\"Filter results for templates with a particular owner.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"respondent_id\",\"description\":\"Filter results for templates with a particular respondent.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"subject_id\",\"description\":\"Filter results for templates with a particular subject. Note: This should always be combined with the subject_type filter.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"subject_type\",\"description\":\"Filter results for templates with a particular subject type.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter results for templates with a particular workspace.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Survey Templates have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyTemplate\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Survey Template\",\"description\":\"This endpoint returns structured Survey Template objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_templates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-survey-template\",\"tags\":[\"Survey Templates (Legacy)\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `owner` (User) - The user who owns all surveys based on this template.\\n- `respondent` (User) - The user assigned to respond to surveys based on this template.\\n- `subject` (polymorphic) - The subject of the survey (e.g. the user being reviewed).\\n- `survey_questions` (SurveyQuestion) - Includes survey questions associated with the survey template.\\n- `survey_responses` (SurveyResponse) - Includes the survey responses associated with the survey template.\\n- `workspace` (Workspace) - The workspace to be used as context for surveys based on this template.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"survey_template\":{\"type\":\"object\",\"properties\":{\"survey_question_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"Survey Questions to associate with this template.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the survey.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the survey.\"},\"subject_type\":{\"type\":\"string\",\"description\":\"The subject type of the survey. Valid values: User, Story, Workspace.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The Id of the survey subject.\"},\"owner_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user who owns all surveys based on this template.\"},\"respondent_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user assigned to respond to surveys based on this template.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The workspace to be used as context for surveys based on this template.\"},\"open_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The open date to be used for surveys based on this template. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"close_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The close date to be used for surveys based on this template. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The due date to be used for surveys based on this template. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}},\"required\":[\"survey_question_ids\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Survey Template has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyTemplate\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/survey_templates/{id}\":{\"put\":{\"summary\":\"Updating an existing Survey Template\",\"description\":\"This endpoint returns structured Survey Template objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `survey_templates` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-survey-template\",\"tags\":[\"Survey Templates (Legacy)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `owner` (User) - The user who owns all surveys based on this template.\\n- `respondent` (User) - The user assigned to respond to surveys based on this template.\\n- `subject` (polymorphic) - The subject of the survey (e.g. the user being reviewed).\\n- `survey_questions` (SurveyQuestion) - Includes survey questions associated with the survey template.\\n- `survey_responses` (SurveyResponse) - Includes the survey responses associated with the survey template.\\n- `workspace` (Workspace) - The workspace to be used as context for surveys based on this template.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"survey_template\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title of the survey.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the survey.\"},\"owner_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user who owns all surveys based on this template.\"},\"open_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The open date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"close_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The close date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The due date for this survey. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Survey Template has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"survey_templates\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyTemplate\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"survey_questions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyQuestion\"}},\"survey_responses\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SurveyResponse\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Survey Template\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-survey-template\",\"tags\":[\"Survey Templates (Legacy)\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Survey Template has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/time_entries\":{\"get\":{\"summary\":\"Fetching a list of Time Entries\",\"description\":\"Returns all time entries visible to the requesting user, unless filter parameters\\nhave been applied.\\n\\n\\nThis endpoint returns structured Time Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-time-entries\",\"tags\":[\"Time Entries\"],\"parameters\":[{\"in\":\"query\",\"name\":\"approved\",\"description\":\"Filter for time entries that are on approved timesheets, or on a workspace that does not require approvals.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_by\",\"description\":\"Filter for time entries created by the specified user.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"date_performed_between\",\"description\":\"Filter for time entries with work performed between 2 dates in a colon-separated YYYY-MM-DD format.\\n        For example, `2013-06-01:2013-08-01`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"from_archived_workspaces\",\"description\":\"If `true`, includes time entries from archived projects.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"in_active_invoice_id\",\"description\":\"Limit results to time entries current in the specified active invoice.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"in_active_submission\",\"description\":\"If true, filters for time entries that are part of active timesheet submissions (`active_submissions`).\\n             If false, filters for time entries that are not part of an active submission.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_submission` (TimesheetSubmission) - Retrieves the active timesheet (i.e. approved or pending) the time entry was submitted on, if any. The response will include `active_submission_id`, which references the data in the `timesheet_submissions` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `invoice` (Invoice) - Retrieves the invoice the time entry was added to, if any. The response will include `invoice_id`, which references the data in the `invoices` top-level key.\\n- `recent_submission` (TimesheetSubmission) - Retrieves the most recent timesheet the time entry was submitted on, if any, including any rejected or cancelled timesheets. The response will include `recent_submission_id`, which references the data in the `timesheet_submissions` top-level key.\\n- `role` (Role) - Retrieves the project role of the user who performed the work for the time entry, if any. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `story` (Story) - Retrieves the task the time entry is tracked to, if any. The response will include `story_id`, which references the data in the `stories` top-level key.\\n- `user` (User) - Retrieves the user the time entry belongs to. The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace` (Workspace) - Retrieves the project the time entry is tracked to. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"invoiced\",\"description\":\"Filter for time entries that have been invoiced. When included in your request, this filter is always processed as `true`; the actual value you provide is ignored. To get uninvoiced time entries instead, use the `uninvoiced` filter.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"on_my_account\",\"description\":\"Only include time entries that are on internal projects. On my account false will include internal and external time entries.\",\"schema\":{\"type\":\"boolean\",\"default\":true}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"location_id\",\"user_can_edit\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `date_performed:asc`, `date_performed:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"date_performed:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"uninvoiced\",\"description\":\"Filter for time entries that have not been invoiced. When included in your request, this filter is always processed as `true`; the actual value you provide is ignored. To get invoiced time entries instead, use the `invoiced` filter.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_recent_timesheet_ids\",\"description\":\"Filter for time entries from the specified [`TimesheetSubmission`](/tag/Timesheet-Submissions) IDs, including from canceled and rejected reports.\\n        Give multiple report IDs in a comma separated list.\\n\\n        **Note**: Time entries are only associated with the most recent TimesheetSubmission (see `recent_submission`).\\n        If you re-submit time from a canceled or rejected timesheet, a new `TimesheetSubmission` object is created,\\n        and the time entries will only be returned in association with the new `TimesheetSubmission` from then on,\\n        instead of with the canceled or rejected `TimesheetSubmission`.\\n\\n        Also note that there can only be 1 project per TimesheetSubmission. When a timesheet is submitted through the application frontend with\\n        time entries for multiple projects, separate TimesheetSubmission objects are created for each project in the backend.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"with_timesheet_id\",\"description\":\"Filter for time entries from a specified [`TimesheetSubmission`](/tag/Timesheet-Submissions) ID.\\n      If the timesheet was canceled or rejected, no result is returned.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"with_user_ids\",\"description\":\"Filter for time entries associated with the specified user IDs.\\n      Give multiple user IDs in a comma separated list. For example, '1,2,3'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter for time entries from the specified project.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"workspace_ids\",\"description\":\"Filter for time entries associated with the specified project IDs.\\n             Give multiple project IDs in a comma separated list. For example, '1,2,3'.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Time Entries have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Time Entry\",\"description\":\"This endpoint returns structured Time Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-time-entry\",\"tags\":[\"Time Entries\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_submission` (TimesheetSubmission) - Retrieves the active timesheet (i.e. approved or pending) the time entry was submitted on, if any. The response will include `active_submission_id`, which references the data in the `timesheet_submissions` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `invoice` (Invoice) - Retrieves the invoice the time entry was added to, if any. The response will include `invoice_id`, which references the data in the `invoices` top-level key.\\n- `recent_submission` (TimesheetSubmission) - Retrieves the most recent timesheet the time entry was submitted on, if any, including any rejected or cancelled timesheets. The response will include `recent_submission_id`, which references the data in the `timesheet_submissions` top-level key.\\n- `role` (Role) - Retrieves the project role of the user who performed the work for the time entry, if any. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `story` (Story) - Retrieves the task the time entry is tracked to, if any. The response will include `story_id`, which references the data in the `stories` top-level key.\\n- `user` (User) - Retrieves the user the time entry belongs to. The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace` (Workspace) - Retrieves the project the time entry is tracked to. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"location_id\",\"user_can_edit\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"time_entry\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project the time entry is logging work in.\"},\"date_performed\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the activity for which the time is being entered was performed, format: YYYY-MM-DD. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"time_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount of time in minutes that the activity was worked on.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"Whether this Time Entry is billable time. If you don't provide this parameter, `billable` will be defaulted to the\\nvalue of the `billable` flag of its associated `Story` if any, otherwise to true.\"},\"rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The hourly rate for the time entry in cents.\"},\"notes\":{\"type\":\"string\",\"description\":\"Any notes added to the time entry.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the default Role or user assigned Role for the time entry.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the task (story) this time entry is associated with.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"This is set to the current_user ID by default. This parameter is ignored unless the authorizing\\nuser has financial access in the project and is on the consultants team (or if the authorizing\\nuser is an account administrator and has proxy permissions via an account member with\\nthose permissions).\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]},\"location\":{\"type\":\"string\",\"description\":\"The location of the time entry. Must match the name of an existing account location.\"}},\"required\":[\"workspace_id\",\"date_performed\",\"time_in_minutes\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Time Entry has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Delete multiple time entries\",\"description\":\"The IDs of the time entries to delete can be provided in the `ids` query parameter or via the request body.\\n\\nRequest body example:\\n```{\\n  \\\"ids\\\": \\\"1,2,3\\\"\\n}```\\n\\nIf any specified time entries cannot be deleted, the entire request will fail and an error message\\nwill be returned that specifies which ones could not be deleted and why.\\n\\n\\nThis endpoint returns structured Time Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"delete-time-entries\",\"tags\":[\"Time Entries\"],\"parameters\":[{\"in\":\"query\",\"name\":\"ids\",\"required\":false,\"description\":\"A comma-separated list of IDs of time entries. You can provide up to 100 IDs. The IDs can be\\nprovided in this query parameter or via the request body.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"204\":{\"description\":\"Time Entry has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/time_entries/{id}\":{\"get\":{\"summary\":\"Fetching a single Time Entry\",\"description\":\"This endpoint returns structured Time Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-time-entry\",\"tags\":[\"Time Entries\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_submission` (TimesheetSubmission) - Retrieves the active timesheet (i.e. approved or pending) the time entry was submitted on, if any. The response will include `active_submission_id`, which references the data in the `timesheet_submissions` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `invoice` (Invoice) - Retrieves the invoice the time entry was added to, if any. The response will include `invoice_id`, which references the data in the `invoices` top-level key.\\n- `recent_submission` (TimesheetSubmission) - Retrieves the most recent timesheet the time entry was submitted on, if any, including any rejected or cancelled timesheets. The response will include `recent_submission_id`, which references the data in the `timesheet_submissions` top-level key.\\n- `role` (Role) - Retrieves the project role of the user who performed the work for the time entry, if any. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `story` (Story) - Retrieves the task the time entry is tracked to, if any. The response will include `story_id`, which references the data in the `stories` top-level key.\\n- `user` (User) - Retrieves the user the time entry belongs to. The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace` (Workspace) - Retrieves the project the time entry is tracked to. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"location_id\",\"user_can_edit\"]}}}],\"responses\":{\"200\":{\"description\":\"The Time Entry has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Time Entry\",\"description\":\"This endpoint returns structured Time Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-time-entry\",\"tags\":[\"Time Entries\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `active_submission` (TimesheetSubmission) - Retrieves the active timesheet (i.e. approved or pending) the time entry was submitted on, if any. The response will include `active_submission_id`, which references the data in the `timesheet_submissions` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `invoice` (Invoice) - Retrieves the invoice the time entry was added to, if any. The response will include `invoice_id`, which references the data in the `invoices` top-level key.\\n- `recent_submission` (TimesheetSubmission) - Retrieves the most recent timesheet the time entry was submitted on, if any, including any rejected or cancelled timesheets. The response will include `recent_submission_id`, which references the data in the `timesheet_submissions` top-level key.\\n- `role` (Role) - Retrieves the project role of the user who performed the work for the time entry, if any. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `story` (Story) - Retrieves the task the time entry is tracked to, if any. The response will include `story_id`, which references the data in the `stories` top-level key.\\n- `user` (User) - Retrieves the user the time entry belongs to. The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace` (Workspace) - Retrieves the project the time entry is tracked to. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"location_id\",\"user_can_edit\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"time_entry\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project (workspace) the time entry is logging work in.\\nThis can be updated by administrators on the account or users who can edit the time entry\\nin the current project and the new project.\"},\"date_performed\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the activity for which the time is being entered was performed, format: YYYY-MM-DD. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"time_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount of time in minutes that the activity was worked on.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"Whether this Time Entry is billable time. If you don't provide this parameter, `billable` will be defaulted to the\\nvalue of the `billable` flag of its associated `Story` if any, otherwise to true.\"},\"rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The hourly rate for the time entry in cents.\"},\"notes\":{\"type\":\"string\",\"description\":\"Any notes added to the time entry.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the default Role or user assigned Role for the time entry.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the task (story) this time entry is associated with.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"This sets the entry user for a specified ID. This parameter is ignored unless the authorizing\\nuser has financial access in the project and is on the provider team (or if the authorizing\\nuser is an account administrator and has proxy permissions via an account member with\\nthose permissions).\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]},\"location\":{\"type\":\"string\",\"description\":\"The location of the time entry. Must match the name of an existing account location.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Time Entry has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"invoices\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Invoice\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Time Entry\",\"description\":\"Deletes the time entry if it is deletable. A time entry cannot be destroyed if:\\n  - the time is locked before a certain date,\\n  - the time has been invoiced, or\\n  - a time adjustment is linked with it.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-time-entry\",\"tags\":[\"Time Entries\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Time Entry has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/time_off_entries\":{\"get\":{\"summary\":\"Fetching a list of Time Off Entries\",\"description\":\"Returns time off entries which are visible to the user. Items are visible to a user if\\nthey are on the same account.\\n\\n\\nThis endpoint returns structured Time Off Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_off_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-time-off-entries\",\"tags\":[\"Time Off Entries\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"end_date\",\"description\":\"Include only time off entries prior to the specified date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `user` (User) - Reference the user associated to the time off entry.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"start_date\",\"description\":\"Include only time off entries after the specified date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_id\",\"description\":\"Include only time off entries for the specified User ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"user_ids\",\"description\":\"Include only time off entries for the specified users. Provide a comma-separated list of user IDs.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Filter for participants of a specific project.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Time Off Entries have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"time_off_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeOffEntry\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating one or many Time Off Entries\",\"description\":\"Creates a single or multiple time off entries for a user. Multiple time off entries can be created for\\nthe same day, in a single request or separate requests. Entries for the same day are combined into one\\ntime off entry. Time off hours cannot exceed the user's possible workday hours for that day.\\n\\n\\nThis endpoint returns structured Time Off Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_off_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-time-off-entry\",\"tags\":[\"Time Off Entries\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `user` (User) - Reference the user associated to the time off entry.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"time_off_entry\":{\"type\":\"object\",\"properties\":{\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user who has requested time off.\"},\"hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The number of hours of time off requested for the day (quarter hour increments recommended).\"},\"requested_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date for which time off is requested. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"user_id\",\"hours\",\"requested_date\"]},\"time_off_entries\":{\"type\":\"array\",\"description\":\"Multiple time off entries and their attributes in an array.\",\"items\":{\"type\":\"object\",\"properties\":{\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user who has requested time off.\"},\"hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The number of hours of time off requested for the day (quarter hour increments recommended).\"},\"requested_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date for which time off is requested. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"user_id\",\"hours\",\"requested_date\"]}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Time Off Entry has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"time_off_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeOffEntry\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Delete multiple time off entries\",\"description\":\"The IDs of the time off entries to delete can be provided in the `ids` query parameter or via the request body.\\n\\nRequest body example:\\n```{\\n  \\\"ids\\\": \\\"1,2,3\\\"\\n}```\\n\\nIf any specified time off entries cannot be deleted, the entire request will fail and an error message\\nwill be returned that specifies which ones could not be deleted and why.\\n\\n\\nThis endpoint returns structured Time Off Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_off_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"delete-time-off-entries\",\"tags\":[\"Time Off Entries\"],\"parameters\":[{\"in\":\"query\",\"name\":\"ids\",\"required\":false,\"description\":\"A comma-separated list of IDs of time off entries. You can provide up to 100 IDs. The IDs can be\\nprovided in this query parameter or via the request body.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"204\":{\"description\":\"Time Off Entry has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/time_off_entries/{id}\":{\"put\":{\"summary\":\"Updating an existing Time Off Entry\",\"description\":\"Update a Time Off Entry. Only the hours and external references can be modified. Time off hours cannot\\nexceed the user's possible workday hours for that day.\\n\\n\\nThis endpoint returns structured Time Off Entry objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `time_off_entries` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-time-off-entry\",\"tags\":[\"Time Off Entries\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `user` (User) - Reference the user associated to the time off entry.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"time_off_entry\":{\"type\":\"object\",\"properties\":{\"hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The number of hours of time off requested for the day (quarter hour increments recommended).\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"hours\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Time Off Entry has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"time_off_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeOffEntry\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Time Off Entry\",\"description\":\"This will delete the time off entry.\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-time-off-entry\",\"tags\":[\"Time Off Entries\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Time Off Entry has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/timesheet_approvals\":{\"post\":{\"summary\":\"Approve Timesheet Submissions\",\"description\":\"Approves all the requested pending Timesheet Submissions.\\n\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"approve-timesheet-submissions\",\"tags\":[\"Timesheet Approvals\"],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-timesheet-submissionsBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"resolutions\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resolution.\"},\"type\":{\"type\":\"string\",\"description\":\"The resolution type, either `approval`, `rejection`, or `cancellation`.\"},\"description\":{\"type\":\"string\",\"description\":\"Additional resolution details.\"},\"target_type\":{\"type\":\"string\",\"description\":\"Whether the resolution is for a timesheet submission or an expense report submission.\"},\"target_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated submission.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user who created the resolution.\"},\"current\":{\"type\":\"boolean\",\"description\":\"Indicates if the resolution is outdated or not.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/timesheet_cancellations\":{\"post\":{\"summary\":\"Cancel Timesheet Submissions\",\"description\":\"Cancels all the requested pending Timesheet Submissions.\\n\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"cancel-timesheet-submissions\",\"tags\":[\"Timesheet Cancellations\"],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-timesheet-submissionsBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"resolutions\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resolution.\"},\"type\":{\"type\":\"string\",\"description\":\"The resolution type, either `approval`, `rejection`, or `cancellation`.\"},\"description\":{\"type\":\"string\",\"description\":\"Additional resolution details.\"},\"target_type\":{\"type\":\"string\",\"description\":\"Whether the resolution is for a timesheet submission or an expense report submission.\"},\"target_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated submission.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user who created the resolution.\"},\"current\":{\"type\":\"boolean\",\"description\":\"Indicates if the resolution is outdated or not.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/timesheet_rejections\":{\"post\":{\"summary\":\"Reject Timesheet Submissions\",\"description\":\"Rejects all the requested pending Timesheet Submissions.\\n\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"reject-timesheet-submissions\",\"tags\":[\"Timesheet Rejections\"],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-timesheet-submissionsBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"resolutions\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resolution.\"},\"type\":{\"type\":\"string\",\"description\":\"The resolution type, either `approval`, `rejection`, or `cancellation`.\"},\"description\":{\"type\":\"string\",\"description\":\"Additional resolution details.\"},\"target_type\":{\"type\":\"string\",\"description\":\"Whether the resolution is for a timesheet submission or an expense report submission.\"},\"target_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated submission.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user who created the resolution.\"},\"current\":{\"type\":\"boolean\",\"description\":\"Indicates if the resolution is outdated or not.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/timesheet_submissions\":{\"get\":{\"summary\":\"Fetching a list of Timesheet Submissions\",\"description\":\"This endpoint returns structured Timesheet Submission objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `timesheet_submissions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-timesheet-submissions\",\"tags\":[\"Timesheet Submissions\"],\"parameters\":[{\"in\":\"query\",\"name\":\"active\",\"description\":\"Returns only active submissions.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"end_date\",\"description\":\"Limit Timesheet Submissions to the week ending with this date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `time_entries` (TimeEntry) - Reference the Time Entries that belong to the Timesheet Submissions.\\n- `user` (User) - Includes user who owns the line items on the submission.\\n- `workspace` (Workspace) - Includes workspace to which the submission belongs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"not_cancelled\",\"description\":\"Returns only submissions that are not cancelled.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `date:asc` and `date:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"date:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"start_date\",\"description\":\"Limit Timesheet Submissions to the week starting with this date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"start_date_after\",\"description\":\"Filter for Timesheet Submissions that start on OR after a specified datetime. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"statuses\",\"description\":\"Returns submissions with the statuses specified. Multiple statuses can be supplied in a comma separated list.\\nValid values: ‘new’, ‘cancelled’, ‘rejected’, and ‘approved’.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_ids\",\"description\":\"Only includes submissions associated with the specified user ids.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Ordered by the submission's workspace id.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"workspace_ids\",\"description\":\"Only includes submissions associated with the specified workspace ids.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Timesheet Submissions have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Create a Timesheet Submission\",\"description\":\"Create a new TimesheetSubmission.\\n\\n**Note**: Only 1 TimesheetSubmission can be created per project.\\\"\\n\\n\\nThis endpoint returns structured Timesheet Submission objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `timesheet_submissions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-timesheet-submission\",\"tags\":[\"Timesheet Submissions\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `time_entries` (TimeEntry) - Reference the Time Entries that belong to the Timesheet Submissions.\\n- `user` (User) - Includes user who owns the line items on the submission.\\n- `workspace` (Workspace) - Includes workspace to which the submission belongs.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"timesheet_submission\":{\"type\":\"object\",\"properties\":{\"line_item_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of time entry IDs of the time entries that will be included in the TimesheetSubmission.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"This can be included when the TimesheetSubmission is being submitted on behalf of another user.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the TimesheetSubmission.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project that will own the TimesheetSubmission and its time entries.\"},\"comment\":{\"type\":\"string\",\"description\":\"Additional notes on the TimesheetSubmission.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"line_item_ids\",\"title\",\"workspace_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Timesheet Submission has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/timesheet_submissions/{id}\":{\"get\":{\"summary\":\"Fetching a single Timesheet Submission\",\"description\":\"This endpoint returns structured Timesheet Submission objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `timesheet_submissions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-timesheet-submission\",\"tags\":[\"Timesheet Submissions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `time_entries` (TimeEntry) - Reference the Time Entries that belong to the Timesheet Submissions.\\n- `user` (User) - Includes user who owns the line items on the submission.\\n- `workspace` (Workspace) - Includes workspace to which the submission belongs.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Timesheet Submission has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"time_entries\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimeEntry\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/timesheet_submissions/{id}/approve\":{\"put\":{\"summary\":\"Approve a Timesheet Submission\",\"description\":\"Approve a TimesheetSubmission. You must have\\n[Time Approval permissions](https://mavenlink.zendesk.com/hc/en-us/articles/203740920).\\n\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"approve-timesheet-submission\",\"tags\":[\"Timesheet Submissions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-expense-report-submissionBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/timesheet_submissions/{id}/cancel\":{\"put\":{\"summary\":\"Cancel a Timesheet Submission\",\"description\":\"You can cancel a TimesheetSubmission by accessing the cancel endpoint\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"cancel-timesheet-submission\",\"tags\":[\"Timesheet Submissions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-expense-report-submissionBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/timesheet_submissions/{id}/reject\":{\"put\":{\"summary\":\"Reject a Timesheet Submission\",\"description\":\"You can reject a TimesheetSubmission by accessing the reject endpoint\\n\\nThis endpoint returns structured Resolution objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `resolutions` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"reject-timesheet-submission\",\"tags\":[\"Timesheet Submissions\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/approve-expense-report-submissionBody\"},\"responses\":{\"200\":{\"description\":\"Resolution has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"resolutions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Resolution\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/user_file_associations\":{\"get\":{\"summary\":\"Fetching a list of User File Associations\",\"description\":\"This endpoint returns structured User File Association objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `user_file_associations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-user-file-associations\",\"tags\":[\"User File Associations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"filename\",\"description\":\"Only includes file associations with matching filenames.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `asset_object` (polymorphic) - When included, the polymorphic `asset_object_ref` struct will reference the attachment or\\nGoogle document for which the user file association belongs. This will be a a two-key JSON\\nobject with \\\"ID\\\" and \\\"key\\\", where the \\\"key\\\" will be \\\"attachments\\\" or \\\"google_documents\\\".\\n- `post` (Post) - The post to which the user file association belongs.\\n- `workspace` (Workspace) - References the project to which the user file association belongs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"workspace_id\",\"description\":\"Only includes file associations from the specified project.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of User File Associations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"user_file_associations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/UserFileAssociation\"}},\"posts\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Post\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/user_group_memberships\":{\"get\":{\"summary\":\"Fetching a list of User Group Memberships\",\"description\":\"This endpoint returns structured User Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `user_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-user-group-memberships\",\"tags\":[\"User Group Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"group_ids\",\"description\":\"Return only memberships associated with the specified Workspace Group IDs. Provide a comma-separated list of Workspace Group IDs or an array of IDs. For example, `10,20`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - Retrieves the associated user. The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace_group` (WorkspaceGroup) - Retrieves the associated Workspace Group. The response will include `workspace_group_id`, which references the data in the `workspace_groups` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"user_ids\",\"description\":\"Return only memberships associated with the specified user IDs. Provide a comma-separated list of user IDs or an array of IDs. For example, `10,20`.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of User Group Memberships have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"user_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/UserWorkspaceGroup\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new User Group Membership\",\"description\":\"Adds a user to a Workspace Group. Up to 100 User Group Memberships can be created at once.\\n\\n\\nThis endpoint returns structured User Group Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `user_group_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-user-group-memberships\",\"tags\":[\"User Group Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - Retrieves the associated user. The response will include `user_id`, which references the data in the `users` top-level key.\\n- `workspace_group` (WorkspaceGroup) - Retrieves the associated Workspace Group. The response will include `workspace_group_id`, which references the data in the `workspace_groups` top-level key.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"user_group_membership\":{\"type\":\"object\",\"properties\":{\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user to add to the Workspace Group.\"},\"workspace_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Workspace Group to add the user to.\"}},\"required\":[\"user_id\",\"workspace_group_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"User Group Membership has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"user_group_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/UserWorkspaceGroup\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/user_group_memberships/{id}\":{\"delete\":{\"summary\":\"Deleting an existing User Group Membership\",\"description\":\"Removes a user from a Workspace Group.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-user-group-membership\",\"tags\":[\"User Group Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"User Group Membership has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/users\":{\"get\":{\"summary\":\"Fetching visible users\",\"description\":\"This endpoint allows you to access all visible users based on the permission level of the requester.\\n\\n> **Note**: This endpoint relies on project participation and will not return a member of your account\\nwho is not in a project. To see all users on the account, use the `on_my_account` option.\\n\\nIf the requester is an Account Administrator, the request will return all users who are participating in a project on the requester's account.\\nIn addition, it will return users not on the requester's account if they are participating in any project with an account member (either on the requester's account or their own account).\\n\\nIf the requester is not an Account Administrator, the request will only return users who are participating in a project with the requester.\\n\\n\\nThis endpoint returns structured User objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `users` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-users\",\"tags\":[\"Users\"],\"parameters\":[{\"in\":\"query\",\"name\":\"account_id\",\"description\":\"Only includes users on the specified account. This filter is not available in conjunction with the `on_my_account` option.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"account_role_ids\",\"description\":\"Only includes users with a specified role ID. (Format: 'role_id,role_id').\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"all_contacts\",\"required\":false,\"description\":\"Returns all users in the requester's contact list.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"assignable_to_resource\",\"description\":\"Only includes users who can be assigned to a project resource with a specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"belonging_to_orgs\",\"description\":\"Only includes users that belong to the specified geographies or departments (Format: 'geo_id,geo_id;dept_id,dept_id').\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_choice_value\",\"description\":\"Filter by a custom field choice value, represented as a string with the custom field ID, followed by a\\ncolon, and then comma-separated custom field choice value IDs. The custom field choice value can also be\\nthe word `blank`. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\n\\nThe following formats are supported:\\n\\n- `custom_field_ID:choice_value_ID`\\n- `custom_field_ID:choice_value_1_ID,choice_value_2_ID`\\n- `custom_field_ID:blank`\\n- `(custom_field_1_ID:choice_value_1_ID,choice_value_2_ID):(custom_field_2_ID:choice_value_3_ID)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_currency_value\",\"description\":\"Filter by a custom field currency value, represented as a string with the custom field ID, followed by a\\ncolon, and then the currency value. Optionally, the currency [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473) can be supplied as well, separated\\nfrom the currency value by another colon. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200.2:USD):(2:100)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_date_value\",\"description\":\"Filter by a custom field date value, represented as a string with the custom field ID, followed by a\\ncolon, the starting date, another colon, and then the ending date. You can provide both a starting date\\nand ending date, or provide just one. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:2014-12-05:2014-12-25):(2:2014-12-05)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_number_value\",\"description\":\"Filter by a custom field number value, represented as a string with the custom field ID, followed by a\\ncolon, and then the number value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200):(2:101)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_text_value\",\"description\":\"Filter by a custom field text value, represented as a string with the custom field ID, followed by a\\ncolon, and then the text value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:something):(2:else)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_email_address\",\"description\":\"Only includes users whose email address exactly matches the specified address.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_email_addresses\",\"description\":\"Return only users whose email addresses exactly match the specified email addresses.\\nYou can provide a list of comma-separated email addresses as a query parameter in the request URL or\\nprovide an array of email addresses in the request body. You can specify up to 200 email addresses.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_full_name\",\"description\":\"Only includes users with all or part of the specified full name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_full_name_or_account_role\",\"description\":\"Only includes users with a matching full_name or default_role specified a search term.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"can_be_approver_in_workspace\",\"description\":\"Only includes users that are providers and have financial access in a project with a specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"can_view_reports\",\"description\":\"Only include users who have account level permission of reports viewer or above.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"clients_only\",\"description\":\"Only includes users that are in at least one project as a client.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"consultants_only\",\"description\":\"Only includes users that are in at least one project as a provider.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"contacts_on_different_account\",\"required\":false,\"description\":\"Returns all the users that are in the requester's contact list, but on seperate accounts.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"has_value_for_custom_field_ids\",\"description\":\"Filter by the presence of a custom field value for the specified comma-separated custom field ID(s).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - Retrieves the account membership of the user, which represents the relationship of a user to an account. The response will include `account_membership_id`, which references the data in the `account_memberships` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the user's custom field values that are viewable for the current user. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `manager` (User) - Retrieves the user's manager. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `role` (Role) - Retrieves the user's account role. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships of the user, which represent skills that have been assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key. The `skill_memberships` data will include the user's proficiency level (for skills which can be assigned proficiency levels).\\n- `skills` (Skill) - Retrieves the user's skills. The response will include `skill_ids`, which references the data in the `skills` top-level key. The `skills` data will include the skill description and category ID.\\n- `work_samples` (WorkSample) - Retrieves the user's portfolio items. The response will include `work_sample_ids`, which references the data in the `work_samples` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"is_project_lead\",\"description\":\"Only include users who have account level permission of project lead or above.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"managers\",\"description\":\"Only include users who are managers.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"matching\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"not_assigned_to\",\"description\":\"Only includes users who are not assigned to a task with specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"not_following\",\"description\":\"Only includes users who are not following a task with the specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"not_on_calendars\",\"description\":\"Only includes users who are not added to the specified holiday calendars (Format: 'calendar_id,calendar_id,calendar_id'.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"not_participant_in\",\"description\":\"Only includes users not participating in a project with a specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"on_my_account\",\"required\":false,\"description\":\"Returns all users on the requester's account.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"on_my_account_or_participant_in_workspace\",\"required\":false,\"description\":\"Returns all the users that are on the account, as well as all users participating in the provided workspace ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_possible_managees\",\"description\":\"Only includes possible managees on the account.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only_possible_managers\",\"description\":\"Only includes possible managers on the account.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"bio\",\"website\",\"city\",\"state\",\"country\",\"abbreviated_timezone\",\"last_site_activity\",\"classification\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc` and `alphabetical:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"alphabetical:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"participant_in\",\"description\":\"Only includes users participating in a project with a specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"potential_followers_for_story\",\"description\":\"Only includes users who are able to follow a task with the specified ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"provider_leads_on_account_projects\",\"description\":\"Only includes users who are providers and leads in projects on the requester's account.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"search\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"show_disabled\",\"description\":\"Includes users with an inactive account membership and users who have been disabled by the Kantata team.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"show_users_in_insights_groups\",\"description\":\"Only includes users who have access to insights.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"with_created_estimates\",\"description\":\"Only include users who have created an estimate.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"with_skills\",\"description\":\"Only includes users with a set of skills at the specified levels (Format: '{'skill_id':[level,level],'skill_id':[level],'operation':'<or/and>'}').\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"with_users\",\"description\":\"Include only users for the provided IDs (Format: 'id,id,id').\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_skills\",\"description\":\"Only includes users without the specified set of skills (Format: 'id,id,id').\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_timesheet_submission\",\"description\":\"Only include users who have not submitted a timesheet in a project between the specified start and end dates. (Format: 'workspace_id:start_date:end_date').\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_users\",\"description\":\"Exclude users for the provided IDs (Format: 'id,id,id').\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}},{\"in\":\"query\",\"name\":\"write_access_in\",\"description\":\"Only includes users who are participating in a project with a specified ID, and are not read-only in the project.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Users have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"work_samples\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkSample\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/users/me\":{\"get\":{\"summary\":\"Fetch your own data\",\"description\":\"This endpoint allows you to fetch your own data.\\n\\n\\nThis endpoint returns structured User objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `users` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-my-user-data\",\"tags\":[\"Users\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - Retrieves the account membership of the user, which represents the relationship of a user to an account. The response will include `account_membership_id`, which references the data in the `account_memberships` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the user's custom field values that are viewable for the current user. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `manager` (User) - Retrieves the user's manager. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `role` (Role) - Retrieves the user's account role. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships of the user, which represent skills that have been assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key. The `skill_memberships` data will include the user's proficiency level (for skills which can be assigned proficiency levels).\\n- `skills` (Skill) - Retrieves the user's skills. The response will include `skill_ids`, which references the data in the `skills` top-level key. The `skills` data will include the skill description and category ID.\\n- `work_samples` (WorkSample) - Retrieves the user's portfolio items. The response will include `work_sample_ids`, which references the data in the `work_samples` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"bio\",\"website\",\"city\",\"state\",\"country\",\"abbreviated_timezone\",\"last_site_activity\",\"classification\"]}}}],\"responses\":{\"200\":{\"description\":\"A list of Users have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"work_samples\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkSample\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/users/{id}\":{\"get\":{\"summary\":\"Fetching a single User\",\"description\":\"This endpoint returns structured User objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `users` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-user\",\"tags\":[\"Users\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - Retrieves the account membership of the user, which represents the relationship of a user to an account. The response will include `account_membership_id`, which references the data in the `account_memberships` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the user's custom field values that are viewable for the current user. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `manager` (User) - Retrieves the user's manager. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `role` (Role) - Retrieves the user's account role. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships of the user, which represent skills that have been assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key. The `skill_memberships` data will include the user's proficiency level (for skills which can be assigned proficiency levels).\\n- `skills` (Skill) - Retrieves the user's skills. The response will include `skill_ids`, which references the data in the `skills` top-level key. The `skills` data will include the skill description and category ID.\\n- `work_samples` (WorkSample) - Retrieves the user's portfolio items. The response will include `work_sample_ids`, which references the data in the `work_samples` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"bio\",\"website\",\"city\",\"state\",\"country\",\"abbreviated_timezone\",\"last_site_activity\",\"classification\"]}}}],\"responses\":{\"200\":{\"description\":\"The User has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"work_samples\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkSample\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing User\",\"description\":\"This endpoint returns structured User objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `users` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-user\",\"tags\":[\"Users\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - Retrieves the account membership of the user, which represents the relationship of a user to an account. The response will include `account_membership_id`, which references the data in the `account_memberships` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the user's custom field values that are viewable for the current user. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `manager` (User) - Retrieves the user's manager. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `role` (Role) - Retrieves the user's account role. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships of the user, which represent skills that have been assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key. The `skill_memberships` data will include the user's proficiency level (for skills which can be assigned proficiency levels).\\n- `skills` (Skill) - Retrieves the user's skills. The response will include `skill_ids`, which references the data in the `skills` top-level key. The `skills` data will include the skill description and category ID.\\n- `work_samples` (WorkSample) - Retrieves the user's portfolio items. The response will include `work_sample_ids`, which references the data in the `work_samples` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"bio\",\"website\",\"city\",\"state\",\"country\",\"abbreviated_timezone\",\"last_site_activity\",\"classification\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"user\":{\"type\":\"object\",\"properties\":{\"full_name\":{\"type\":\"string\",\"description\":\"The full name of the user.\"},\"headline\":{\"type\":\"string\",\"description\":\"A short description of the user.\"},\"email_address\":{\"type\":\"string\",\"description\":\"The email address for the user. If this value is different than the user's existing email_address it will require a new verification.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"User has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"work_samples\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkSample\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/users/{id}/capacity\":{\"get\":{\"summary\":\"Fetch My Work Capacity\",\"description\":\"This endpoint returns a summary of a user's work capacity for a provided range of dates.\\n\\n\\nThis endpoint returns structured User objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `users` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-my-work-capacity\",\"tags\":[\"Users\"],\"parameters\":[{\"in\":\"query\",\"name\":\"end_date\",\"required\":true,\"description\":\"The end date for calculating my work capacity in YYYY-MM-DD format (e.g. 2016-01-01). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"start_date\",\"required\":true,\"description\":\"The start date for calculating my work capacity in YYYY-MM-DD format (e.g. 2015-12-16). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - Retrieves the account membership of the user, which represents the relationship of a user to an account. The response will include `account_membership_id`, which references the data in the `account_memberships` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the user's custom field values that are viewable for the current user. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `manager` (User) - Retrieves the user's manager. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `role` (Role) - Retrieves the user's account role. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships of the user, which represent skills that have been assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key. The `skill_memberships` data will include the user's proficiency level (for skills which can be assigned proficiency levels).\\n- `skills` (Skill) - Retrieves the user's skills. The response will include `skill_ids`, which references the data in the `skills` top-level key. The `skills` data will include the skill description and category ID.\\n- `work_samples` (WorkSample) - Retrieves the user's portfolio items. The response will include `work_sample_ids`, which references the data in the `work_samples` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"bio\",\"website\",\"city\",\"state\",\"country\",\"abbreviated_timezone\",\"last_site_activity\",\"classification\"]}}}],\"responses\":{\"200\":{\"description\":\"A list of Users have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date for calculating my work capacity in YYYY-MM-DD format (e.g. 2012-09-27).\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The end date for calculating my work capacity in YYYY-MM-DD format (e.g. 2012-09-27).\"},\"hours\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The key is the date, and the value is my work capacity on that date.\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/users/{id}/profile_photo\":{\"delete\":{\"summary\":\"Reset Profile Photo\",\"description\":\"Delete the profile photo for the specified user.\\n\\n\\nThis endpoint returns structured User objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `users` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"reset-user-profile-photo\",\"tags\":[\"Users\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"User has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Update Profile Photo\",\"description\":\"Update the profile photo for the specified user.\\n\\n\\nThis endpoint returns structured User objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `users` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-user-profile-photo\",\"tags\":[\"Users\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_membership` (AccountMembership) - Retrieves the account membership of the user, which represents the relationship of a user to an account. The response will include `account_membership_id`, which references the data in the `account_memberships` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the user's custom field values that are viewable for the current user. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `manager` (User) - Retrieves the user's manager. The response will include `manager_id`, which references the data in the `users` top-level key.\\n- `role` (Role) - Retrieves the user's account role. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `skill_memberships` (SkillMembership) - Retrieves the skill memberships of the user, which represent skills that have been assigned to a user. The response will include `skill_membership_ids`, which references the data in the `skill_memberships` top-level key. The `skill_memberships` data will include the user's proficiency level (for skills which can be assigned proficiency levels).\\n- `skills` (Skill) - Retrieves the user's skills. The response will include `skill_ids`, which references the data in the `skills` top-level key. The `skills` data will include the skill description and category ID.\\n- `work_samples` (WorkSample) - Retrieves the user's portfolio items. The response will include `work_sample_ids`, which references the data in the `work_samples` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"bio\",\"website\",\"city\",\"state\",\"country\",\"abbreviated_timezone\",\"last_site_activity\",\"classification\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"user\":{\"type\":\"object\",\"properties\":{\"profile_photo_attachment_file\":{\"type\":\"string\",\"description\":\"The multipart/form-data encoded file contents. This is similar to the `data` attribute\\nof the [Attachment](/tag/Attachments#operation/create-attachment) field.\"}},\"required\":[\"profile_photo_attachment_file\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"User has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"skill_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/SkillMembership\"}},\"account_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountMembership\"}},\"work_samples\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkSample\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/vendors\":{\"get\":{\"summary\":\"Fetching a list of Vendors\",\"description\":\"This endpoint returns structured Vendor objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `vendors` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-vendors\",\"tags\":[\"Vendors\"],\"parameters\":[{\"in\":\"query\",\"name\":\"archived\",\"description\":\"If *True*, returns all archived vendors and false returns all active vendors.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical:asc` and `alphabetical:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"alphabetical:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Vendors have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Vendor\",\"description\":\"This endpoint returns structured Vendor objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `vendors` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-vendor\",\"tags\":[\"Vendors\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"vendor\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the vendor.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\"]}},\"required\":[\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Vendor has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/vendors/{id}\":{\"put\":{\"summary\":\"Updating an existing Vendor\",\"description\":\"This endpoint returns structured Vendor objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `vendors` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-vendor\",\"tags\":[\"Vendors\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"vendor\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the vendor.\"},\"archived\":{\"type\":\"boolean\",\"description\":\"When set to true, archives the vendor.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Vendor has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"vendors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Vendor\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Vendor\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-vendor\",\"tags\":[\"Vendors\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Vendor has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_allocations\":{\"get\":{\"summary\":\"Fetching a list of Workspace Allocations\",\"description\":\"This endpoint returns structured Workspace Allocation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_allocations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-allocations\",\"tags\":[\"Workspace Allocations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User)\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User)\\n- `workspace` (Workspace) - The workspace that the resource is allocated in.\\n- `workspace_resource` (WorkspaceResource).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"named_resources_only\",\"description\":\"Limit to allocations associated with only named resources.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `updated_at:asc` and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"overlaps_with_date_range\",\"description\":\"Limit to allocations of that overlap with a specified date range. Accepts two dates separated by a colon.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"type\",\"description\":\"Limit to allocations of a specific type. Valid values: `hard` and `soft`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"unnamed_resources_only\",\"description\":\"Limit to allocations associated with only unnamed resources.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_ids\",\"description\":\"Limit to allocations associated with the workspace resource user's IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_ids\",\"description\":\"Limit to allocations associated with the workspace IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_resource_ids\",\"description\":\"Limit to allocations associated with the workspace resource IDs.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Workspace Allocations have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceAllocation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workspace Allocation\",\"description\":\"This endpoint returns structured Workspace Allocation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_allocations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-allocation\",\"tags\":[\"Workspace Allocations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User)\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User)\\n- `workspace` (Workspace) - The workspace that the resource is allocated in.\\n- `workspace_resource` (WorkspaceResource).\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_allocation\":{\"type\":\"object\",\"properties\":{\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the workspace resource that the allocation will be associated with.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the allocation starts on. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the allocation ends on. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Total minutes the resource is allocated over the date range.\"},\"hard\":{\"type\":\"boolean\",\"description\":\"Indicates if the allocation is a Hard Allocation (“true”) or Soft (“false”).\"},\"notes\":{\"type\":\"string\",\"description\":\"User entered notes about the allocation.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"resource_id\",\"start_date\",\"end_date\",\"minutes\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Allocation has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceAllocation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_allocations/split\":{\"put\":{\"summary\":\"Splitting an Allocation\",\"description\":\"Split an existing allocation into two on the specified date.\\n\\nThis endpoint returns structured Workspace Allocation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_allocations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"split-workspace-allocation-by-date\",\"tags\":[\"Workspace Allocations\"],\"parameters\":[{\"in\":\"query\",\"name\":\"split_date\",\"required\":true,\"description\":\"The date on which the allocation splits, in YYYY-MM-DD format. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"workspace_allocation_id\",\"required\":true,\"description\":\"The ID of the allocation. This can be found via the [Fetch Workspace Allocations endpoint](/tag/Workspace-Allocations#operation/get-workspace-allocations).\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User)\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User)\\n- `workspace` (Workspace) - The workspace that the resource is allocated in.\\n- `workspace_resource` (WorkspaceResource).\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"Workspace Allocation has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceAllocation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_allocations/{id}\":{\"get\":{\"summary\":\"Fetching a single Workspace Allocation\",\"description\":\"This endpoint returns structured Workspace Allocation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_allocations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-allocation\",\"tags\":[\"Workspace Allocations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User)\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User)\\n- `workspace` (Workspace) - The workspace that the resource is allocated in.\\n- `workspace_resource` (WorkspaceResource).\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Workspace Allocation has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceAllocation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workspace Allocation\",\"description\":\"This endpoint returns structured Workspace Allocation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_allocations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace-allocation\",\"tags\":[\"Workspace Allocations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User)\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `updater` (User)\\n- `workspace` (Workspace) - The workspace that the resource is allocated in.\\n- `workspace_resource` (WorkspaceResource).\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_allocation\":{\"type\":\"object\",\"properties\":{\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the allocation starts on. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the allocation ends on. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Total minutes the resource is allocated over the date range.\"},\"hard\":{\"type\":\"boolean\",\"description\":\"Indicates if the allocation is a Hard Allocation (“true”) or Soft (“false”).\"},\"notes\":{\"type\":\"string\",\"description\":\"User entered notes about the allocation.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Allocation has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_allocations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceAllocation\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Workspace Allocation\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-workspace-allocation\",\"tags\":[\"Workspace Allocations\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Workspace Allocation has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_baselines\":{\"get\":{\"summary\":\"Fetching a list of Workspace Baselines\",\"description\":\"Returns a list of Gantt workspace baselines associated with workspaces (projects) that are visible to the authenticated user.\\nVisibility restrictions on projects are detailed in the [Workspaces API documentation](/tag/Workspaces)\\n\\n\\nThis endpoint returns structured Workspace Baseline objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_baselines` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-baselines\",\"tags\":[\"Workspace Baselines\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created this workspace baseline.\\n- `payload` (BaselinePayload) - The baseline payload associated with this workspace baseline.\\n- `workspace` (Workspace) - The workspace represented in this workspace baseline.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}}],\"responses\":{\"200\":{\"description\":\"A list of Workspace Baselines have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_baselines\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceBaseline\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"baseline_payloads\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BaselinePayload\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workspace Baseline\",\"description\":\"Creates a Gantt workspace baseline for a specified workspace (project). The baseline will contain aggregate statistics and certain data about each story (task).\\n\\n\\nThis endpoint returns structured Workspace Baseline objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_baselines` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-baseline\",\"tags\":[\"Workspace Baselines\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created this workspace baseline.\\n- `payload` (BaselinePayload) - The baseline payload associated with this workspace baseline.\\n- `workspace` (Workspace) - The workspace represented in this workspace baseline.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/create-workspace-baselineBody\"},\"responses\":{\"200\":{\"description\":\"Workspace Baseline has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_baselines\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceBaseline\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"baseline_payloads\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BaselinePayload\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_baselines/{id}\":{\"get\":{\"summary\":\"Fetching a single Workspace Baseline\",\"description\":\"Returns a specified Gantt workspace baseline.\\n\\n\\nThis endpoint returns structured Workspace Baseline objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_baselines` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-baseline\",\"tags\":[\"Workspace Baselines\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created this workspace baseline.\\n- `payload` (BaselinePayload) - The baseline payload associated with this workspace baseline.\\n- `workspace` (Workspace) - The workspace represented in this workspace baseline.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Workspace Baseline has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_baselines\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceBaseline\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"baseline_payloads\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BaselinePayload\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workspace Baseline\",\"description\":\"Updates a specified Gantt workspace baseline.\\n\\n\\nThis endpoint returns structured Workspace Baseline objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_baselines` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace-baseline\",\"tags\":[\"Workspace Baselines\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - The user who created this workspace baseline.\\n- `payload` (BaselinePayload) - The baseline payload associated with this workspace baseline.\\n- `workspace` (Workspace) - The workspace represented in this workspace baseline.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/create-workspace-baselineBody\"},\"responses\":{\"200\":{\"description\":\"Workspace Baseline has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_baselines\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceBaseline\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"baseline_payloads\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/BaselinePayload\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Workspace Baseline\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-workspace-baseline\",\"tags\":[\"Workspace Baselines\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Workspace Baseline has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_groups\":{\"get\":{\"summary\":\"Fetching a list of Workspace Groups\",\"description\":\"This endpoint returns structured Workspace Group objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_groups` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-groups\",\"tags\":[\"Workspace Groups\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_custom_choice_value\",\"description\":\"Filter by a custom field choice value, represented as a string with the custom field ID, followed by a\\ncolon, and then comma-separated custom field choice value IDs. The custom field choice value can also be\\nthe word `blank`. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\n\\nThe following formats are supported:\\n\\n- `custom_field_ID:choice_value_ID`\\n- `custom_field_ID:choice_value_1_ID,choice_value_2_ID`\\n- `custom_field_ID:blank`\\n- `(custom_field_1_ID:choice_value_1_ID,choice_value_2_ID):(custom_field_2_ID:choice_value_3_ID)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_currency_value\",\"description\":\"Filter by a custom field currency value, represented as a string with the custom field ID, followed by a\\ncolon, and then the currency value. Optionally, the currency [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473) can be supplied as well, separated\\nfrom the currency value by another colon. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200.2:USD):(2:100)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_date_value\",\"description\":\"Filter by a custom field date value, represented as a string with the custom field ID, followed by a\\ncolon, the starting date, another colon, and then the ending date. You can provide both a starting date\\nand ending date, or provide just one. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:2014-12-05:2014-12-25):(2:2014-12-05)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_number_value\",\"description\":\"Filter by a custom field number value, represented as a string with the custom field ID, followed by a\\ncolon, and then the number value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200):(2:101)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_text_value\",\"description\":\"Filter by a custom field text value, represented as a string with the custom field ID, followed by a\\ncolon, and then the text value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:something):(2:else)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"companies_only\",\"description\":\"Filter by groups that represent a company.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"has_value_for_custom_field_ids\",\"description\":\"Filter by the presence of a custom field value for the specified comma-separated custom field ID(s).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card_sets` (RateCardSet) - Rate Card Sets associated with the group.\\n- `workspaces` (Workspace) - Workspaces associated with the group.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Filter by groups that have a name similar to the supplied string.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `name:asc`, `name:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"name:ASC\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Workspace Groups have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workspace Group\",\"description\":\"This endpoint returns structured Workspace Group objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_groups` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-group\",\"tags\":[\"Workspace Groups\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card_sets` (RateCardSet) - Rate Card Sets associated with the group.\\n- `workspaces` (Workspace) - Workspaces associated with the group.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_group\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the new workspace group. Names must be unique and are not case sensitive. (ie: an account cannot both have a workspace group named \\\"Kantata\\\" and another named \\\"kantata\\\").\"},\"add_workspace_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of the workspaces to add to this group. The authorizing user must have access to all specified workspaces.\"},\"notes\":{\"type\":\"string\",\"description\":\"Notes on the group.\"},\"company\":{\"type\":\"boolean\",\"description\":\"Whether the group represents a company.\"},\"contact_name\":{\"type\":\"string\",\"description\":\"The name of the company contact.\"},\"email\":{\"type\":\"string\",\"description\":\"The email of the company contact.\"},\"phone_number\":{\"type\":\"string\",\"description\":\"The phone number of the company contact.\"},\"address\":{\"type\":\"string\",\"description\":\"The address of the company contact.\"},\"website\":{\"type\":\"string\",\"description\":\"The website of the company contact.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Group has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_groups/{id}\":{\"get\":{\"summary\":\"Fetching a single Workspace Group\",\"description\":\"This endpoint returns structured Workspace Group objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_groups` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-group\",\"tags\":[\"Workspace Groups\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card_sets` (RateCardSet) - Rate Card Sets associated with the group.\\n- `workspaces` (Workspace) - Workspaces associated with the group.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Workspace Group has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workspace Group\",\"description\":\"This endpoint returns structured Workspace Group objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_groups` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace-group\",\"tags\":[\"Workspace Groups\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `rate_card_sets` (RateCardSet) - Rate Card Sets associated with the group.\\n- `workspaces` (Workspace) - Workspaces associated with the group.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_group\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the group.\"},\"add_workspace_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of the workspaces to add to this group. Workspaces already associated with the workspace group will retain association. The authorizing user must have access to all the specified workspaces.\"},\"remove_workspace_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of the workspaces to remove from this group. The authorizing user must have access to all specified workspaces.\"},\"notes\":{\"type\":\"string\",\"description\":\"Notes on the group.\"},\"company\":{\"type\":\"boolean\",\"description\":\"Whether the group represents a company.\"},\"contact_name\":{\"type\":\"string\",\"description\":\"The name of the company contact.\"},\"email\":{\"type\":\"string\",\"description\":\"The email of the company contact.\"},\"phone_number\":{\"type\":\"string\",\"description\":\"The phone number of the company contact.\"},\"address\":{\"type\":\"string\",\"description\":\"The address of the company contact.\"},\"website\":{\"type\":\"string\",\"description\":\"The website of the company contact.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"name\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Group has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"rate_card_sets\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/RateCardSet\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Workspace Group\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-workspace-group\",\"tags\":[\"Workspace Groups\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Workspace Group has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_invoice_preferences\":{\"post\":{\"summary\":\"Creating a new Workspace Invoice Preference\",\"description\":\"This endpoint returns structured Workspace Invoice Preference objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_invoice_preferences` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-invoice-preferences\",\"tags\":[\"Workspace Invoice Preferences\"],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_invoice_preference\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project for which the invoice preferences will apply.\"},\"purchase_order\":{\"type\":\"string\",\"description\":\"The invoice purchase order (defined by the user).\"},\"project_code\":{\"type\":\"string\",\"description\":\"The invoice project code (defined by the user).\"},\"client_invoice_name\":{\"type\":\"string\",\"description\":\"The name of the client being invoiced.\"},\"client_invoice_address\":{\"type\":\"string\",\"description\":\"The address of the client being invoiced.\"},\"consultant_invoice_name\":{\"type\":\"string\",\"description\":\"The name of the provider who is sending the invoice.\"},\"consultant_invoice_address\":{\"type\":\"string\",\"description\":\"The address of the provider who is sending the invoice.\"}},\"required\":[\"workspace_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Invoice Preference has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_invoice_preferences\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceInvoicePreference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_invoice_preferences/{id}\":{\"get\":{\"summary\":\"Fetching a single Workspace Invoice Preference\",\"description\":\"This endpoint returns structured Workspace Invoice Preference objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_invoice_preferences` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-invoice-preferences\",\"tags\":[\"Workspace Invoice Preferences\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"200\":{\"description\":\"The Workspace Invoice Preference has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_invoice_preferences\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceInvoicePreference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workspace Invoice Preference\",\"description\":\"This endpoint returns structured Workspace Invoice Preference objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_invoice_preferences` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace-invoice-preferences\",\"tags\":[\"Workspace Invoice Preferences\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_invoice_preference\":{\"type\":\"object\",\"properties\":{\"purchase_order\":{\"type\":\"string\",\"description\":\"The invoice purchase order (defined by the user).\"},\"project_code\":{\"type\":\"string\",\"description\":\"The invoice project code (defined by the user).\"},\"client_invoice_name\":{\"type\":\"string\",\"description\":\"The name of the client being invoiced.\"},\"client_invoice_address\":{\"type\":\"string\",\"description\":\"The address of the client being invoiced.\"},\"consultant_invoice_name\":{\"type\":\"string\",\"description\":\"The name of the provider who is sending the invoice.\"},\"consultant_invoice_address\":{\"type\":\"string\",\"description\":\"The address of the provider who is sending the invoice.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Invoice Preference has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_invoice_preferences\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceInvoicePreference\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_resource_skills\":{\"get\":{\"summary\":\"Fetching a list of Workspace Resource Skills\",\"description\":\"Returns a list of Workspace Resource Skills that represent the skills associated with workspace\\nresources visible to the logged in user.\\n\\n\\nThis endpoint returns structured Workspace Resource Skill objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resource_skills` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-resource-skills\",\"tags\":[\"Workspace Resource Skills\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_skill_id\",\"description\":\"Only includes associated skill, by the skill ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"by_skill_ids\",\"description\":\"Only includes associated skills. Input is a comma separated list of ids or an array.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_skill_name\",\"description\":\"Only includes associated skills, by the name of the skill.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - References the user who has created the skill association.\\n- `skill` (Skill) - References the skill assigned to the object.\\n- `workspace_resource` (WorkspaceResource) - References the workspace resource who has been assigned the skill.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `skill_name:asc`, and `skill_name:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"workspace_resource_ids\",\"description\":\"Only includes workspace resource skills assigned to a workspace resource, by workspace resource ID.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}}],\"responses\":{\"200\":{\"description\":\"A list of Workspace Resource Skills have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_resource_skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResourceSkill\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workspace Resource Skill\",\"description\":\"This endpoint returns structured Workspace Resource Skill objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resource_skills` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-resource-skill\",\"tags\":[\"Workspace Resource Skills\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - References the user who has created the skill association.\\n- `skill` (Skill) - References the skill assigned to the object.\\n- `workspace_resource` (WorkspaceResource) - References the workspace resource who has been assigned the skill.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_resource_skill\":{\"type\":\"object\",\"properties\":{\"skill_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the skill.\"},\"workspace_resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the workspace resource.\"},\"level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The workspace resource's proficiency level in the skill (1-5). This defaults to 1 if it is not specified.\\nNote: Not all skills have levels.\"}},\"required\":[\"skill_id\",\"workspace_resource_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Resource Skill has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_resource_skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResourceSkill\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_resource_skills/{id}\":{\"get\":{\"summary\":\"Fetching a single Workspace Resource Skill\",\"description\":\"This endpoint returns structured Workspace Resource Skill objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resource_skills` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-resource-skill\",\"tags\":[\"Workspace Resource Skills\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - References the user who has created the skill association.\\n- `skill` (Skill) - References the skill assigned to the object.\\n- `workspace_resource` (WorkspaceResource) - References the workspace resource who has been assigned the skill.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Workspace Resource Skill has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_resource_skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResourceSkill\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workspace Resource Skill\",\"description\":\"This endpoint returns structured Workspace Resource Skill objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resource_skills` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace-resource-skill\",\"tags\":[\"Workspace Resource Skills\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `creator` (User) - References the user who has created the skill association.\\n- `skill` (Skill) - References the skill assigned to the object.\\n- `workspace_resource` (WorkspaceResource) - References the workspace resource who has been assigned the skill.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_resource_skill\":{\"type\":\"object\",\"properties\":{\"level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The workspace resource's proficiency level in the skill (1-5). This defaults to 0 if it is not specified.\\nNote: Not all skills have levels.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Resource Skill has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_resource_skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResourceSkill\"}},\"skills\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Skill\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Workspace Resource Skill\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-workspace-resource-skill\",\"tags\":[\"Workspace Resource Skills\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Workspace Resource Skill has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_resources\":{\"get\":{\"summary\":\"Fetching a list of Workspace Resources\",\"description\":\"This endpoint returns structured Workspace Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-resources\",\"tags\":[\"Workspace Resources\"],\"parameters\":[{\"in\":\"query\",\"name\":\"by_custom_choice_value\",\"description\":\"Filter by a custom field choice value, represented as a string with the custom field ID, followed by a\\ncolon, and then comma-separated custom field choice value IDs. The custom field choice value can also be\\nthe word `blank`. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\n\\nThe following formats are supported:\\n\\n- `custom_field_ID:choice_value_ID`\\n- `custom_field_ID:choice_value_1_ID,choice_value_2_ID`\\n- `custom_field_ID:blank`\\n- `(custom_field_1_ID:choice_value_1_ID,choice_value_2_ID):(custom_field_2_ID:choice_value_3_ID)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_currency_value\",\"description\":\"Filter by a custom field currency value, represented as a string with the custom field ID, followed by a\\ncolon, and then the currency value. Optionally, the currency [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473) can be supplied as well, separated\\nfrom the currency value by another colon. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200.2:USD):(2:100)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_date_value\",\"description\":\"Filter by a custom field date value, represented as a string with the custom field ID, followed by a\\ncolon, the starting date, another colon, and then the ending date. You can provide both a starting date\\nand ending date, or provide just one. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:2014-12-05:2014-12-25):(2:2014-12-05)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_number_value\",\"description\":\"Filter by a custom field number value, represented as a string with the custom field ID, followed by a\\ncolon, and then the number value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200):(2:101)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_text_value\",\"description\":\"Filter by a custom field text value, represented as a string with the custom field ID, followed by a\\ncolon, and then the text value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:something):(2:else)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"has_value_for_custom_field_ids\",\"description\":\"Filter by the presence of a custom field value for the specified comma-separated custom field ID(s).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the custom field values for the resource. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `participation` (Participation) - Retrieves the participation associated with the resource. The response will include `participation_id`, which references the data in the `participations` top-level key.\\n- `role` (Role) - Retrieves the role for this resource. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user associated with the resource. The response will include `user_id`, which references the data in the `users` top-level key. For unnamed resources, the `user_id` will be `null`.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the resource is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include_unnamed\",\"required\":false,\"description\":\"Returns Unnamed Resources in addition to Named Resources.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Show Resources associated with a User that matches the specified parameter or has a Role that matches the specified parameter.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_unnamed\",\"required\":false,\"description\":\"Returns only Unnamed Resources.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"resource_bill_rate\",\"resource_cost_rate\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `alphabetical`, `alphabetically:asc`, `alphabetically:desc`, `created_at:asc`, `created_at:desc`, `updated_at:asc`, and `updated_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"potential_workspace_resource_for_story_with_unnamed_resources\",\"description\":\"Takes a Reference to a Story Id. Show only Resources that are available to assign for specified Story.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"potential_workspace_resources_for_reassignment\",\"description\":\"Takes an Assignment Id. Shows only Resources that can be reassigned to the specified assignment.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"potential_workspace_resources_for_story\",\"description\":\"Takes a Reference to a Story Id Show only Resources that have an user assigned, and are available to assign for specified Story.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"providers\",\"description\":\"Show only Resources that have an user assigned, and are consultants in the workspace.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"providers_with_unnamed\",\"description\":\"Show only Resources that have consultant users or no users at all.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"role_id\",\"required\":false,\"description\":\"Returns workspace resources for a specified role in a workspace. Returns workspace resources for a specified role when only the role is provided.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_id\",\"required\":false,\"description\":\"Returns workspace resources for a specified user in a workspace. Returns workspace resources for a specified user when only the user is provided.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_id\",\"required\":false,\"description\":\"Id for a specified workspace you wish to retrieve.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}}],\"responses\":{\"200\":{\"description\":\"A list of Workspace Resources have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workspace Resource\",\"description\":\"This endpoint returns structured Workspace Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-resource\",\"tags\":[\"Workspace Resources\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the custom field values for the resource. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `participation` (Participation) - Retrieves the participation associated with the resource. The response will include `participation_id`, which references the data in the `participations` top-level key.\\n- `role` (Role) - Retrieves the role for this resource. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user associated with the resource. The response will include `user_id`, which references the data in the `users` top-level key. For unnamed resources, the `user_id` will be `null`.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the resource is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"resource_bill_rate\",\"resource_cost_rate\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_resource\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The workspace ID associated with this resource.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user ID associated with this resource. A null value indicates that this is an unnamed resource.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The role ID associated with this resource. The role ID is a required attribute to create unnamed\\nresources. This defaults to the user's primary project role if the user is specified.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}},\"required\":[\"workspace_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Resource has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_resources/allocations_matching_scheduled_hours\":{\"post\":{\"summary\":\"Creating Allocations from Scheduled Hours for Resources\",\"description\":\"This will create allocations for workspace resources based on their scheduled hours.\\nThis endpoint is only usable for Account Administrators and users with `Users can edit\\nallocations for unnamed resources` or `Users can edit allocations for named resources`\\naccess in the `Edit Allocations` section of the `Resource Management` Access Group Set.\\n\\n\\nThis endpoint returns structured Workspace Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-resource-allocations-from-scheduled-hours\",\"tags\":[\"Workspace Resources\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the custom field values for the resource. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `participation` (Participation) - Retrieves the participation associated with the resource. The response will include `participation_id`, which references the data in the `participations` top-level key.\\n- `role` (Role) - Retrieves the role for this resource. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user associated with the resource. The response will include `user_id`, which references the data in the `users` top-level key. For unnamed resources, the `user_id` will be `null`.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the resource is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"resource_bill_rate\",\"resource_cost_rate\"]}}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/create-workspace-resource-allocations-from-scheduled-hoursBody\"},\"responses\":{\"200\":{\"description\":\"Workspace Resource has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"success\":{\"type\":\"boolean\",\"description\":\"Indicates if workspace allocations were created.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_resources/{id}\":{\"get\":{\"summary\":\"Fetching a single Workspace Resource\",\"description\":\"This endpoint returns structured Workspace Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-resource\",\"tags\":[\"Workspace Resources\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the custom field values for the resource. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `participation` (Participation) - Retrieves the participation associated with the resource. The response will include `participation_id`, which references the data in the `participations` top-level key.\\n- `role` (Role) - Retrieves the role for this resource. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user associated with the resource. The response will include `user_id`, which references the data in the `users` top-level key. For unnamed resources, the `user_id` will be `null`.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the resource is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"resource_bill_rate\",\"resource_cost_rate\"]}}}],\"responses\":{\"200\":{\"description\":\"The Workspace Resource has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workspace Resource\",\"description\":\"This endpoint returns structured Workspace Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace-resource\",\"tags\":[\"Workspace Resources\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the custom field values for the resource. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `participation` (Participation) - Retrieves the participation associated with the resource. The response will include `participation_id`, which references the data in the `participations` top-level key.\\n- `role` (Role) - Retrieves the role for this resource. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user associated with the resource. The response will include `user_id`, which references the data in the `users` top-level key. For unnamed resources, the `user_id` will be `null`.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the resource is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"resource_bill_rate\",\"resource_cost_rate\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_resource\":{\"type\":\"object\",\"properties\":{\"label\":{\"type\":\"string\",\"description\":\"A unique label that is automatically generated for a resource when it is created. Default resource labels in Kantata OX are based on role name and numerical order, but can be renamed by you.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user ID associated with this resource.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The role ID associated with this resource. The role ID is a required attribute for unnamed resources.\"},\"auto_update_label\":{\"type\":\"boolean\",\"description\":\"If true, automatically updates resource labels to match roles associated with updated role IDs when labels are not provided. When a label is provided, that overrides this setting.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Resource has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"roles\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Role\"}},\"organization_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/OrganizationMembership\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Workspace Resource\",\"description\":\"This will delete a workspace resource and their assignments if the resource is deletable.\\nA workspace resource is not deletable if it is the last resource for a user's primary\\nrole within a workspace.\\n\\n\\nThe response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-workspace-resource\",\"tags\":[\"Workspace Resources\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Workspace Resource has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_resources/{id}/allocations_matching_scheduled_hours\":{\"post\":{\"summary\":\"Creating Allocations from Scheduled Hours for Resources\",\"description\":\"This will create allocations for workspace resources based on their scheduled hours.\\nThis endpoint is only usable for Account Administrators and users with `Users can edit\\nallocations for unnamed resources` or `Users can edit allocations for named resources`\\naccess in the `Edit Allocations` section of the `Resource Management` Access Group Set.\\n\\n\\nThis endpoint returns structured Workspace Resource objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_resources` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-resource-allocations-from-scheduled-hours-by-id\",\"tags\":[\"Workspace Resources\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `custom_field_values` (CustomFieldValue) - Retrieves the custom field values for the resource. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `organization_membership` (OrganizationMembership) - Retrieves the organization memberships for the resource. The response will include `organization_membership_id`, which references the data in the `organization_memberships` top-level key.\\n- `participation` (Participation) - Retrieves the participation associated with the resource. The response will include `participation_id`, which references the data in the `participations` top-level key.\\n- `role` (Role) - Retrieves the role for this resource. The response will include `role_id`, which references the data in the `roles` top-level key.\\n- `user` (User) - Retrieves the user associated with the resource. The response will include `user_id`, which references the data in the `users` top-level key. For unnamed resources, the `user_id` will be `null`.\\n- `workspace` (Workspace) - Retrieves the workspace (project) the resource is in. The response will include `workspace_id`, which references the data in the `workspaces` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"resource_bill_rate\",\"resource_cost_rate\"]}}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/create-workspace-resource-allocations-from-scheduled-hoursBody\"},\"responses\":{\"200\":{\"description\":\"Workspace Resource has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"success\":{\"type\":\"boolean\",\"description\":\"Indicates if workspace allocations were created.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_status_changes\":{\"get\":{\"summary\":\"Fetching a list of Workspace Status Changes\",\"description\":\"Returns all project status changes that are visible to the user for the passed project ID.\\n\\n\\nThis endpoint returns structured Workspace Status Change objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_status_changes` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-status-changes\",\"tags\":[\"Workspace Status Changes\"],\"parameters\":[{\"in\":\"query\",\"name\":\"workspace_id\",\"required\":true,\"description\":\"Required parameter for retrieving status changes for a specified project.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the user who made the change.\\n- `workspace` (Workspace) - References the project for which the status changed.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc` and `created_at:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"created_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Workspace Status Changes have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_status_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceStatusChange\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workspace Status Change\",\"description\":\"This endpoint returns structured Workspace Status Change objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_status_changes` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-status-change\",\"tags\":[\"Workspace Status Changes\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the user who made the change.\\n- `workspace` (Workspace) - References the project for which the status changed.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_status_change\":{\"type\":\"object\",\"properties\":{\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project that contains the project status change.\"},\"to_status_key\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The status key for the new project status. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/115005042433#Project-Status-List) for a list of project status IDs. Note that setting a project's status to its current status will result in an error. To avoid this, you can use the [update workspace](/tag/Workspaces#operation/update-workspace) endpoint and its `status_key` parameter instead.\"}},\"required\":[\"workspace_id\",\"to_status_key\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Status Change has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_status_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceStatusChange\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspace_status_changes/{id}\":{\"get\":{\"summary\":\"Fetching a single Workspace Status Change\",\"description\":\"Return the status change for the passed project status change ID.\\n\\n\\nThis endpoint returns structured Workspace Status Change objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_status_changes` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace-status-change\",\"tags\":[\"Workspace Status Changes\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the user who made the change.\\n- `workspace` (Workspace) - References the project for which the status changed.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Workspace Status Change has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_status_changes\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceStatusChange\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspaces\":{\"get\":{\"summary\":\"Fetching a list of Workspaces\",\"description\":\"Gets a list of projects.\\n\\nThis endpoint has its own rate limit. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for more information.\\n\\n#### Archived Projects\\n\\nBy default, archived projects are not returned in the response. Use the `include_archived=true` filter\\nto retrieve archived projects.\\n\\n#### Search Filter\\n\\nThe `search` parameter filters for projects that match one or more keywords. By default, the following fields are searched:\\n- `workspace_id`\\n- `title`\\n- `description`\\n- `full_name` of the `primary_maven` (i.e. the Provider team lead)\\n- `full_name` of the `primary_counterpart` (i.e. the Client team lead)\\n- `name` of `workspace_groups`, including the `primary_workspace_group`\\n- `display_value` of `custom_field_values` (Excluding `currency` and `date` custom fields)\\n\\nYou can search on specific fields using the format `search=field_name:'keyword'`. For example, `search=description:'acme'`. This is supported for the following fields:\\n- `title`\\n- `description`\\n- `group` - Searches only the `name` field of `workspace_groups`. The keyword must match the entire name of the group (i.e. not a partial match).\\n- `custom_field_value` - Searches the `display_value` of `custom_field_values`. (Excluding `currency` and `date` custom fields.)\\n- `status` - Searches only the `message` field of the project `status`. The keyword must match the entire name of the project status (i.e. not a partial match).\\n\\nTo combine multiple field-specific search terms, separate them by a space. For example, `search=title:'acme' description:'website'`.\\n\\nYou can combine a field-specific search term with general search terms. For example, `search=description:'acme' design`.\\n\\n\\nThis endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspaces\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"query\",\"name\":\"account_color_ids\",\"description\":\"Filter by color ID. Provide a comma-separated list of color IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"archived\",\"description\":\"Filter for only archived projects, or include or exclude archived projects from the results. Options are `only`, `exclude`, and `include`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"budgeted\",\"description\":\"Return only budgeted projects (`true`) or only non-budgeted projects (`false`).\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"by_custom_choice_value\",\"description\":\"Filter by a custom field choice value, represented as a string with the custom field ID, followed by a\\ncolon, and then comma-separated custom field choice value IDs. The custom field choice value can also be\\nthe word `blank`. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\n\\nThe following formats are supported:\\n\\n- `custom_field_ID:choice_value_ID`\\n- `custom_field_ID:choice_value_1_ID,choice_value_2_ID`\\n- `custom_field_ID:blank`\\n- `(custom_field_1_ID:choice_value_1_ID,choice_value_2_ID):(custom_field_2_ID:choice_value_3_ID)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_currency_value\",\"description\":\"Filter by a custom field currency value, represented as a string with the custom field ID, followed by a\\ncolon, and then the currency value. Optionally, the currency [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473) can be supplied as well, separated\\nfrom the currency value by another colon. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200.2:USD):(2:100)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_date_value\",\"description\":\"Filter by a custom field date value, represented as a string with the custom field ID, followed by a\\ncolon, the starting date, another colon, and then the ending date. You can provide both a starting date\\nand ending date, or provide just one. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:2014-12-05:2014-12-25):(2:2014-12-05)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_number_value\",\"description\":\"Filter by a custom field number value, represented as a string with the custom field ID, followed by a\\ncolon, and then the number value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:200):(2:101)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"by_custom_text_value\",\"description\":\"Filter by a custom field text value, represented as a string with the custom field ID, followed by a\\ncolon, and then the text value. Multiple custom fields can be delimited by semicolons or by parentheses and colons.\\nThe following formats are supported:\\n\\n- `(1:something):(2:else)`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"can_create_line_items\",\"description\":\"Return only projects where the authenticated user can create expenses or time entries (`true`) or only projects where the user can't (`false`).\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_at\",\"description\":\"(Deprecated) Use the `created_before` and `created_after` filters instead.\\n\\nFilter for projects created between a specified date range. Format as `from_date;to_date`. Dates must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format. For example, `2014-12-05;2014-12-25`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"creator\",\"description\":\"Filter for projects created by a specific user(s). Provide a comma-separated list of user IDs. For example, `10,20`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"current_user_is_maven_participant\",\"description\":\"Filter for projects where the authenticated user is on the provider team. When included in your request, this filter is always processed as `true`; the actual value you provide is ignored.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"custom_date_range\",\"description\":\"Filter for projects with date custom field value(s) within a specified range. Format as `custom_field_id:from_date:to_date;custom_field_id:from_date:to_date`. Multiple custom fields can be delimited by semicolons. Dates must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format. For example, `1:2014-12-05:2014-12-25;2:2015-12-05:2015-12-25`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"custom_integer_ranges\",\"description\":\"Filter for projects with number custom field value(s) within a specified range. Format as `custom_field_id:min:max;custom_field_id:min:max`. Multiple custom fields can be delimited by semicolons. For example, `42:20:10;43:50:100`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"due_date_after\",\"description\":\"Filter for projects that are due after the specified date. Can be used with `due_date_before` to filter by a date range. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"due_date_before\",\"description\":\"Filter for projects that are due before the specified date. Can be used with `due_date_after` to filter by a date range. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"except\",\"description\":\"Filter out specific projects from the results. Provide a comma-separated list of workspace IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_message\",\"description\":\"Filter the objects based on the external message of their associated external references. This is an exact match.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_external_status\",\"description\":\"Filter by the status of the external object in the external system.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model\",\"description\":\"Filter by the type of the external object this external reference belongs to.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_ref\",\"description\":\"Filter by the id of the external object this external reference belongs to.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"external_reference_service_model_refs\",\"description\":\"Filter for objects that correlate to the specified external object IDs. Provide a comma-separated list of up to 200 external IDs.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_service_name\",\"description\":\"Filter by the name of the provider for integration.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"external_reference_status\",\"description\":\"Filter by the status of the integration, this can be successful or fail.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"financials_viewable_by_user\",\"description\":\"Return only projects that the authenticated user can view, has financial access in, and is on the provider team. If `false`, no filtering is applied.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"for_approver\",\"description\":\"Filter for projects where the user with the specified user ID can approve time.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"has_approvers\",\"description\":\"Return only projects that have an approver (`true`) or only projects that don't (`false`).\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"has_external_references\",\"description\":\"Filter by whether or not the object has external references.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"has_maven_participant\",\"description\":\"Filter for projects where the user with the specified user ID is on the provider team.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"has_participant\",\"description\":\"Filter for projects where the user with the specified user ID is a participant.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"has_participation\",\"description\":\"Filter for projects where the authenticated user is a participant.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"has_value_for_custom_field_ids\",\"description\":\"Filter by the presence of a custom field value for the specified comma-separated custom field ID(s).\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"include_archived\",\"description\":\"Include (`true`) or exclude (`false`) archived projects from the results.\",\"schema\":{\"type\":\"boolean\",\"default\":false}},{\"in\":\"query\",\"name\":\"matching\",\"description\":\"Filter for projects with a title that match the specified string. This filter is not case sensitive. This filter functions as a \\\"starts with\\\" filter for each word in project titles.\\n\\nAdditionally, the following common words (known as stop words) are ignored: `a`, `an`, `and`, `are`, `as`, `at`, `be`, `but`, `by`, `for`, `if`, `in`, `into`, `is`, `it`, `no`, `not`, `of`, `on`, `or`, `such`, `that`, `the`, `their`, `then`, `there`, `these`, `they`, `this`, `to`, `was`, `with`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"milestone_weight_percentage_complete\",\"description\":\"Filter for projects which have a milestone percent completion within the specified range. Provide two comma-separated numbers. For example, `15,30`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"on_account_by_orgs\",\"required\":false,\"description\":\"Filter for projects that are on the authenticated user’s account and within the organization hierarchy the authenticated user is a part of. Requires the Report Viewer account permission or above.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"on_my_account\",\"description\":\"Filter for projects that are on the same account as the authenticated user.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only_joinable\",\"required\":false,\"description\":\"Filter for projects which the authenticated user can join and are within the organization hierarchy the user is a part of.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only_participating_or_joinable\",\"required\":false,\"description\":\"Filter for projects which the authenticated user is participating in or can join.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"only_project_manager_in\",\"required\":false,\"description\":\"Filter for projects that are on the same account as the authenticated user, where the user is on the provider team, and where they have financial access or higher.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `amount_paid:asc`, `amount_paid:desc`, `color_name:asc`, `color_name:desc`, `created_at:asc`, `created_at:desc`, `custom_field:<custom_field_id>:asc`, `custom_field:<custom_field_id>:desc`, `due_date:asc`, `due_date:desc`, `last_viewed:asc`, `last_viewed:desc`, `percentage_complete:asc`, `percentage_complete:desc`, `price:asc`, `price:desc`, `provider_lead_name:asc`, `provider_lead_name:desc`, `search`, `start_date:asc`, `start_date:desc`, `status:asc`, `status:desc`, `title:asc`, `title:desc`, `updated_at:asc`, and `updated_at:desc`.\\n\\nNote: The `custom_field:<custom_field_id>:asc` and `custom_field:<custom_field_id>:desc` options do not support multi-choice custom fields.\",\"schema\":{\"type\":\"string\",\"default\":\"updated_at:desc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"participant_or_org_member_in\",\"required\":false,\"description\":\"Filter for projects that are on the same account as the authenticated user, that the user is participating in, and that are within the organization hierarchy the user is a part of.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"pending_timesheet_submissions\",\"description\":\"Filter for projects that have pending timesheet submissions within a specified date range. Format as `from_date;to_date`. Dates must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format. For example, `2014-12-05;2014-12-25`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"provider_lead\",\"description\":\"Filter for projects with the specified provider team leads. Provide a comma-separated list of user IDs. For example, `10,20`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"require_time_approvals\",\"description\":\"Return only projects that require time approvals (`true`) or only projects that don't (`false`).\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"requiring_expense_approval\",\"description\":\"Return only projects that require expense approvals (`true`) or only projects that don't (`false`).\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"search\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"selected_choices\",\"description\":\"Filter for projects that have a specific choice selected for a choice custom field. Format as `custom_field_id:choice_ids;custom_field_id:choice_ids`. Pass `none` to indicate no selection. Multiple custom fields can be delimited by semicolons. For example: `1:3,2;4:2,none`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"stage\",\"description\":\"Return only projects in the estimate stage or project stage. Options are `estimate` and `project`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"start_date_after\",\"description\":\"Filter for projects that start after the specified date. Can be used with `start_date_before` to filter by a date range. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"start_date_before\",\"description\":\"Filter for projects that start before the specified date. Can be used with `start_date_after` to filter by a date range. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_not_participating\",\"description\":\"Filter for projects where the user with the specified ID is not participating.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"viewable_for_time_administration\",\"description\":\"Return only projects where the authenticated user can approve time. Can be used in combination with the `include_archived` filter.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"without_external_reference_service_name\",\"description\":\"Exclude by the existence of an external reference with the specified service name.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"workspace_groups\",\"description\":\"Filter for projects that are associated with the specified [project groups](https://developer.kantata.com/tag/Workspace-Groups). Provide a comma-separated list of group IDs. For example, `10,20`.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"A list of Workspaces have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workspace\",\"description\":\"Creates a new workspace (project). \\n\\nThis endpoint has its own rate limit. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for more information.\\n\\n\\nThis endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace\":{\"type\":\"object\",\"properties\":{\"consultant_role_name\":{\"type\":\"string\",\"description\":\"The label for the consultant team (i.e. the team providing the service).\"},\"client_role_name\":{\"type\":\"string\",\"description\":\"The label for the client team (i.e. the team paying for the service).\"},\"budgeted\":{\"type\":\"boolean\",\"description\":\"Whether the project is budgeted.\\nDefaults to `true` for paid accounts.\\nDefaults to `false` for free accounts.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the project starts. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the project is due. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the project.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the project. \\nOnly applicable if `budgeted` is true. \\nSee the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/360041576473) for the list of currency codes. \\nDefaults to the account currency or `USD`. \\nIf a `rate_card_id` is provided, this field is ignored.\"},\"access_level\":{\"type\":\"string\",\"description\":\"Whether the project is open, and who can join the project.\",\"enum\":[\"invitation\",\"open\",\"admins\"]},\"rate_card_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the rate card for the project. The currency of the rate card must match the currency of the project.\"},\"exclude_archived_stories_percent_complete\":{\"type\":\"boolean\",\"description\":\"Whether archived tasks are excluded from the calculation of the project completion percentage.\"},\"tasks_default_non_billable\":{\"type\":\"boolean\",\"description\":\"Whether tasks in the project default to non-billable.\"},\"stories_are_fixed_fee_by_default\":{\"type\":\"boolean\",\"description\":\"Whether tasks in the project default to fixed fee (`true`) or time and materials (`false`).\"},\"expenses_in_burn_rate\":{\"type\":\"boolean\",\"description\":\"Sets whether both expenses and invoice additional items should be included in the actual fees calculation for the project. Note that setting this field sets the values of both `actual_fees_includes_expenses` and `actual_fees_includes_additional_line_items`. To set the values individually, set `actual_fees_includes_expenses` and `actual_fees_includes_additional_line_items` instead.\"},\"actual_fees_includes_expenses\":{\"type\":\"boolean\",\"description\":\"Sets whether expenses should be included in the actual fees calculation for the project.\"},\"actual_fees_includes_additional_line_items\":{\"type\":\"boolean\",\"description\":\"Sets whether invoice additional items should be included in the actual fees calculation for the project.\"},\"posts_require_privacy_decision\":{\"type\":\"boolean\",\"description\":\"Whether project posts are visible to everyone in the project (`false`) or are private (`true`) by default.\"},\"status_key\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The status of the project. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/115005042433-Project-Status#Project-Status-List) for a list of project status IDs.\"},\"invoice_preference\":{\"type\":\"object\",\"description\":\"Invoice customization preferences that will be automatically generated in each invoice for the project.\",\"properties\":{\"client_invoice_address\":{\"type\":\"string\",\"description\":\"The client address to automatically generate in each new invoice.\"},\"client_invoice_name\":{\"type\":\"string\",\"description\":\"The client name to automatically generate in each new invoice.\"},\"consultant_invoice_address\":{\"type\":\"string\",\"description\":\"The provider address to automatically generate in each new invoice.\"},\"consultant_invoice_name\":{\"type\":\"string\",\"description\":\"The provider name to automatically generate in each new invoice.\"},\"project_code\":{\"type\":\"string\",\"description\":\"The project code to automatically generate in each new invoice.\"},\"purchase_order\":{\"type\":\"string\",\"description\":\"The purchase order to automatically generate in each new invoice.\"}}},\"approver_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user ID of the designated time approver for the project.\"},\"workspace_group_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of the [groups](/tag/Workspace-Groups) the project belongs to.\"},\"project_template_start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When `project_tracker_template_id` is provided, this sets the start date that tasks will be based on when the template is applied. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"project_template_checklist_as_todos\":{\"type\":\"boolean\",\"description\":\"Whether checklist items are converted to To Dos when applying a template.\"},\"project_template_assignment_mappings\":{\"type\":\"array\",\"description\":\"When `project_tracker_template_id` is provided, this maps template resources to named or unnamed resources when the template is applied. If named resources are specified via the `user_id` field, the users should also be included in the `participations` field.\",\"items\":{\"type\":\"object\",\"properties\":{\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [project template assignment](/tag/Project-Template-Assignments) this mapping is for.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user to map the template resource to. If you pass a `user_id` and do not set `role_id`, the workspace resource's role will be the user's default account role or—if they have none—it will be blank.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account role to use as the workspace role for this template resource. If you pass a `role_id` but do not pass a `user_id`, an unnamed resource will be created.\"}}}},\"project_template_weekends_as_workdays\":{\"type\":\"boolean\",\"description\":\"When `project_tracker_template_id` is provided, this sets whether weekends count as work days when applying the template. If `true`, weekend days will be included in task durations.\"},\"project_template_create_unnamed_resources\":{\"type\":\"boolean\",\"description\":\"When `project_tracker_template_id` is provided, this maps all template resources and task assignments to unnamed resources, and ignores `project_template_assignment_mappings` for task assignments.\"},\"project_template_distribute_hours\":{\"type\":\"boolean\",\"description\":\"When `project_tracker_template_id` is provided, this sets whether task estimated hours in the template are automatically added as scheduled hours for all tasks when applying the template. The hours will be distributed evenly between the task start date and end date.\"},\"project_tracker_template_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the template to use to populate tasks and other information in the project.\"},\"primary_workspace_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [group](/tag/Workspace-Groups) that is the primary group for the project.\"},\"target_margin\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The desired profit, expressed as a percentage.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]},\"account_color_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [account color](/tag/Account-Colors) to apply to the project.\"},\"external_link\":{\"type\":\"object\",\"description\":\"A link to display within the project workspace. Requires the Project Button facilitated feature.\",\"properties\":{\"text\":{\"type\":\"string\",\"description\":\"The URL of the link.\"},\"url\":{\"type\":\"string\",\"description\":\"The button text.\"}}},\"account_insights_mapping_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of Insights dynamic dashboards to add to the project.\"},\"custom_fields\":{\"type\":\"array\",\"description\":\"Custom field values for the project.\",\"items\":{\"type\":\"object\",\"properties\":{\"custom_field_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the custom field.\"},\"value\":{\"type\":\"string\",\"description\":\"The value for the corresponding custom field. The value formats for different types are:\\n\\n* `string` - `<text_string>`, eg. `'foo'`\\n* `date` - `<ISO_8601 Date Format>` eg. `'2014-02-25'` `(accepted range: '1900-01-01' to '2015-12-31')`\\n* `number` - `<integer_value>` eg. `'13'`\\n* `currency` - `[<int_value_in_cents>, <currency_code>]` eg. `'[998, USD]'`\\n* `single` and `multi` - `[<choice_ids>]` eg. `'[1, 2, 4]'`.\"}}}},\"stage\":{\"type\":\"string\",\"description\":\"The stage of the project. Options are `estimate` and `project`.\",\"enum\":[\"estimate\",\"project\"]},\"time_trackable\":{\"type\":\"boolean\",\"description\":\"Sets whether tasks in the project can have time tracked to them. This field is only usable if allowed by [Time & Expense account settings](https://knowledge.kantata.com/hc/en-us/articles/360000317994-Time-Expense-Settings).\"},\"title\":{\"type\":\"string\"},\"creator_role\":{\"type\":\"string\",\"description\":\"Which team to add the project creator to. Options are `maven` / `consultant` (i.e. the provider team) and `buyer` / `client` (i.e. the client team). Defaults to `maven`.\",\"enum\":[\"client\",\"consultant\"]},\"price\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The starting budget of the project. This is required for budgeted projects.\"},\"change_orders_enabled\":{\"type\":\"boolean\",\"description\":\"Whether schedule and budget changes require approval.\\n\\nDefaults to `true` if the project is budgeted.\"},\"change_orders\":{\"type\":\"boolean\",\"description\":\"Whether schedule and budget changes require approval.\\n\\nDefaults to `true` if the project is budgeted.\"},\"organizations\":{\"type\":\"array\",\"description\":\"The [organizations](/tag/Organizations) to assign to the project.\",\"items\":{\"type\":\"object\",\"properties\":{\"department_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the department to assign to the project.\"},\"geography_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the geographic region to assign to the project.\"}}}},\"participations\":{\"type\":\"array\",\"description\":\"Users to add to the project on the provider team.\",\"items\":{\"type\":\"object\",\"properties\":{\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user ID of the user to add as a participant on the provider team.\"},\"access\":{\"type\":\"string\",\"description\":\"The project permission to assign to the project participant. Legacy options included `collaboration`, `time_logging`, `financial`.\",\"enum\":[\"edit_tasks\",\"view_tasks\",\"edit_time_and_expenses\",\"view_time_and_expenses\",\"edit_financials\",\"view_financials\",\"admin\"]}}}},\"primary_maven_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user to set as the team lead on the provider team.\"},\"require_expense_approvals\":{\"type\":\"boolean\",\"description\":\"Whether expenses logged to the project must be approved.\"},\"require_time_approvals\":{\"type\":\"boolean\",\"description\":\"Whether time tracked to the project must be approved.\"},\"estimate_scenario_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the estimate scenario to create this project from. Must also provide a `start_date`.\"},\"attachment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of file attachments to associate with the project after it is created.\"}},\"required\":[\"title\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspaces/{id}\":{\"get\":{\"summary\":\"Fetching a single Workspace\",\"description\":\"Gets a project by ID.\\n\\nBy default, you will receive a 404 status if you try to retrieve an archived project. Use the `include_archived:true`\\nfilter to retrieve an archived project.\\n\\nUsers with Project Lead (or lower) account permissions can retrieve projects they are not participating in if they have\\nthe `All projects` or `All projects accessible to their organization` (if Organizations are enabled) permission in the\\n`View Resource Center` section of the `Resource Management` Access Group set.\\n\\n\\nThis endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workspace\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}}],\"responses\":{\"200\":{\"description\":\"The Workspace has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workspace\",\"description\":\"This endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace\":{\"type\":\"object\",\"properties\":{\"consultant_role_name\":{\"type\":\"string\",\"description\":\"The label for the consultant team (i.e. the team providing the service).\"},\"client_role_name\":{\"type\":\"string\",\"description\":\"The label for the client team (i.e. the team paying for the service).\"},\"budgeted\":{\"type\":\"boolean\",\"description\":\"Whether the project is budgeted.\\nDefaults to `true` for paid accounts.\\nDefaults to `false` for free accounts.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the project starts. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the project is due. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the project.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the project. \\nOnly applicable if `budgeted` is true. \\nSee the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/360041576473) for the list of currency codes. \\nDefaults to the account currency or `USD`. \\nIf a `rate_card_id` is provided, this field is ignored.\"},\"access_level\":{\"type\":\"string\",\"description\":\"Whether the project is open, and who can join the project.\",\"enum\":[\"invitation\",\"open\",\"admins\"]},\"rate_card_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the rate card for the project. The currency of the rate card must match the currency of the project.\"},\"exclude_archived_stories_percent_complete\":{\"type\":\"boolean\",\"description\":\"Whether archived tasks are excluded from the calculation of the project completion percentage.\"},\"tasks_default_non_billable\":{\"type\":\"boolean\",\"description\":\"Whether tasks in the project default to non-billable.\"},\"stories_are_fixed_fee_by_default\":{\"type\":\"boolean\",\"description\":\"Whether tasks in the project default to fixed fee (`true`) or time and materials (`false`).\"},\"expenses_in_burn_rate\":{\"type\":\"boolean\",\"description\":\"Sets whether both expenses and invoice additional items should be included in the actual fees calculation for the project. Note that setting this field sets the values of both `actual_fees_includes_expenses` and `actual_fees_includes_additional_line_items`. To set the values individually, set `actual_fees_includes_expenses` and `actual_fees_includes_additional_line_items` instead.\"},\"actual_fees_includes_expenses\":{\"type\":\"boolean\",\"description\":\"Sets whether expenses should be included in the actual fees calculation for the project.\"},\"actual_fees_includes_additional_line_items\":{\"type\":\"boolean\",\"description\":\"Sets whether invoice additional items should be included in the actual fees calculation for the project.\"},\"posts_require_privacy_decision\":{\"type\":\"boolean\",\"description\":\"Whether project posts are visible to everyone in the project (`false`) or are private (`true`) by default.\"},\"status_key\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The status of the project. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/115005042433-Project-Status#Project-Status-List) for a list of project status IDs.\"},\"invoice_preference\":{\"type\":\"object\",\"description\":\"Invoice customization preferences that will be automatically generated in each invoice for the project.\",\"properties\":{\"client_invoice_address\":{\"type\":\"string\",\"description\":\"The client address to automatically generate in each new invoice.\"},\"client_invoice_name\":{\"type\":\"string\",\"description\":\"The client name to automatically generate in each new invoice.\"},\"consultant_invoice_address\":{\"type\":\"string\",\"description\":\"The provider address to automatically generate in each new invoice.\"},\"consultant_invoice_name\":{\"type\":\"string\",\"description\":\"The provider name to automatically generate in each new invoice.\"},\"project_code\":{\"type\":\"string\",\"description\":\"The project code to automatically generate in each new invoice.\"},\"purchase_order\":{\"type\":\"string\",\"description\":\"The purchase order to automatically generate in each new invoice.\"}}},\"approver_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user ID of the designated time approver for the project.\"},\"workspace_group_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of the [groups](/tag/Workspace-Groups) the project belongs to.\"},\"project_template_start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When `project_tracker_template_id` is provided, this sets the start date that tasks will be based on when the template is applied. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"project_template_checklist_as_todos\":{\"type\":\"boolean\",\"description\":\"Whether checklist items are converted to To Dos when applying a template.\"},\"project_template_assignment_mappings\":{\"type\":\"array\",\"description\":\"When `project_tracker_template_id` is provided, this maps template resources to named or unnamed resources when the template is applied. If named resources are specified via the `user_id` field, the users should also be included in the `participations` field.\",\"items\":{\"type\":\"object\",\"properties\":{\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [project template assignment](/tag/Project-Template-Assignments) this mapping is for.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user to map the template resource to. If you pass a `user_id` and do not set `role_id`, the workspace resource's role will be the user's default account role or—if they have none—it will be blank.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account role to use as the workspace role for this template resource. If you pass a `role_id` but do not pass a `user_id`, an unnamed resource will be created.\"}}}},\"project_template_weekends_as_workdays\":{\"type\":\"boolean\",\"description\":\"When `project_tracker_template_id` is provided, this sets whether weekends count as work days when applying the template. If `true`, weekend days will be included in task durations.\"},\"project_template_create_unnamed_resources\":{\"type\":\"boolean\",\"description\":\"When `project_tracker_template_id` is provided, this maps all template resources and task assignments to unnamed resources, and ignores `project_template_assignment_mappings` for task assignments.\"},\"project_template_distribute_hours\":{\"type\":\"boolean\",\"description\":\"When `project_tracker_template_id` is provided, this sets whether task estimated hours in the template are automatically added as scheduled hours for all tasks when applying the template. The hours will be distributed evenly between the task start date and end date.\"},\"project_tracker_template_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the template to use to populate tasks and other information in the project.\"},\"primary_workspace_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [group](/tag/Workspace-Groups) that is the primary group for the project.\"},\"target_margin\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The desired profit, expressed as a percentage.\"},\"external_reference\":{\"type\":\"object\",\"description\":\"Typically populated programmatically by a third party system via an integration, this is an optional\\nobject that holds data from an external system. It connects objects in an external system with objects in\\nKantata OX (for example, to connect a Jira issue to a Kantata OX Project).\",\"properties\":{\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of integration.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The object type of the External Object this external reference belongs to.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The object ID of the External Object this external reference belongs to.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration, this can be successful or fail.\"},\"external_message\":{\"type\":\"string\",\"description\":\"Message on the External Object.\"},\"external_link\":{\"type\":\"string\",\"description\":\"Link to the External Object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Indicates whether the subject should be locked.\"}},\"required\":[\"service_name\",\"service_model\",\"service_model_ref\",\"status\"]},\"account_color_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [account color](/tag/Account-Colors) to apply to the project.\"},\"external_link\":{\"type\":\"object\",\"description\":\"A link to display within the project workspace. Requires the Project Button facilitated feature.\",\"properties\":{\"text\":{\"type\":\"string\",\"description\":\"The URL of the link.\"},\"url\":{\"type\":\"string\",\"description\":\"The button text.\"}}},\"account_insights_mapping_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"The IDs of Insights dynamic dashboards to add to the project.\"},\"custom_fields\":{\"type\":\"array\",\"description\":\"Custom field values for the project.\",\"items\":{\"type\":\"object\",\"properties\":{\"custom_field_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the custom field.\"},\"value\":{\"type\":\"string\",\"description\":\"The value for the corresponding custom field. The value formats for different types are:\\n\\n* `string` - `<text_string>`, eg. `'foo'`\\n* `date` - `<ISO_8601 Date Format>` eg. `'2014-02-25'` `(accepted range: '1900-01-01' to '2015-12-31')`\\n* `number` - `<integer_value>` eg. `'13'`\\n* `currency` - `[<int_value_in_cents>, <currency_code>]` eg. `'[998, USD]'`\\n* `single` and `multi` - `[<choice_ids>]` eg. `'[1, 2, 4]'`.\"}}}},\"stage\":{\"type\":\"string\",\"description\":\"The stage of the project. Options are `estimate` and `project`.\",\"enum\":[\"estimate\",\"project\"]},\"time_trackable\":{\"type\":\"boolean\",\"description\":\"Sets whether tasks in the project can have time tracked to them. This field is only usable if allowed by [Time & Expense account settings](https://knowledge.kantata.com/hc/en-us/articles/360000317994-Time-Expense-Settings).\"},\"title\":{\"type\":\"string\"},\"archived\":{\"type\":\"boolean\",\"description\":\"Set to `true` to archive the project or to `false` to unarchive the project.\"},\"price\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The project budget, in base units of the currency (e.g. dollars for `USD` ).\"},\"project_template_before_story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"When `project_tracker_template_id` is provided, the template tasks are inserted after the provided task ID. The provided task ID must belong to an existing and top-level task.\"},\"change_orders_enabled\":{\"type\":\"boolean\",\"description\":\"Whether approval is required for schedule and budget change orders.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Workspace\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-workspace\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Workspace has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspaces/{id}/apply_template\":{\"put\":{\"summary\":\"Apply a Project Template to an existing Workspace\",\"description\":\"Applies a template to an existing project.\\n\\n\\nThis endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"apply-project-template-to-workspace\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"edit_stories\",\"required\":false,\"description\":\"If `true`, the project participants and unnamed resources specified in the request body\\nwill be added to the project, but the template tasks will not actually be created in the\\nproject. Instead, `template_stories_json` will be returned in the response, containing\\ninformation about the template tasks and assignments.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace\":{\"type\":\"object\",\"properties\":{\"project_tracker_template_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the template to use to populate tasks and other information in the project.\"},\"project_template_weekends_as_workdays\":{\"type\":\"boolean\",\"description\":\"Whether weekends count as work days when applying the template. If `true`, weekend days will be included in task durations.\"},\"project_template_start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date that tasks will be based on when the template is applied. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"project_template_checklist_as_todos\":{\"type\":\"boolean\",\"description\":\"Whether checklist items are converted to To Dos when applying the template.\"},\"project_template_create_unnamed_resources\":{\"type\":\"boolean\",\"description\":\"If `true`, all template resources and task assignments will be mapped to unnamed\\nresources and `project_template_assignment_mappings` will be ignored.\"},\"project_template_distribute_hours\":{\"type\":\"boolean\",\"description\":\"Whether task estimated hours in the template are automatically added as scheduled hours\\nfor all tasks when applying the template. The hours will be distributed evenly between\\nthe task start date and end date.\"},\"project_template_assignment_mappings\":{\"type\":\"array\",\"description\":\"This maps template resources to named or unnamed resources when the template is applied.\",\"items\":{\"type\":\"object\",\"properties\":{\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account role to use as the workspace role for this template resource. If you pass a `role_id` but do not pass a `user_id`, an unnamed resource will be created.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user to map the template resource to. If you pass a `user_id` and do not set `role_id`, the workspace resource's role will be the user's default account role or—if they have none—it will be blank.\"},\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the [project template assignment](/tag/Project-Template-Assignments) this mapping is for.\"},\"create_unnamed_resource\":{\"type\":\"boolean\",\"description\":\"If this is `true` and no `user_id` is specified, a new unnamed resource will be created for this template resource using the specified role, and the tasks will be assigned to the unnamed resource.\"}}}},\"project_template_before_story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of an existing task the template tasks should be inserted after. The provided task ID must belong to a top-level task.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspaces/{id}/invite\":{\"post\":{\"summary\":\"Creating a Workspace Invitation\",\"description\":\"Sends an invitation to a project.\\n\\nTo add participants to a project, they must first be invited. Users that already exist in Kantata OX will\\nautomatically accept the invitation and be added to the project. Users that don't already exist will have\\nthe option to create an account.\\n\\nThis endpoint has its own rate limit. See the [Knowledge Base](https://knowledge.kantata.com/hc/en-us/articles/9698066628123) for more information.\\n\\n\\nThis endpoint returns structured Workspace Invitation objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspace_invitations` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workspace-invitation\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"invitation\":{\"type\":\"object\",\"properties\":{\"full_name\":{\"type\":\"string\",\"description\":\"The name of the user being invited (required).\"},\"email_address\":{\"type\":\"string\",\"description\":\"The email address of the user being invited.\"},\"invitee_role\":{\"type\":\"string\",\"description\":\"The role of the user being invited; either 'maven' (consultant) or 'buyer' (client).\"},\"subject\":{\"type\":\"string\",\"description\":\"The subject of the invitation email message.\"},\"message\":{\"type\":\"string\",\"description\":\"The text of the invitation email message.\"}},\"required\":[\"full_name\",\"email_address\",\"invitee_role\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace Invitation has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspace_invitations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceInvitation\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspaces/{id}/permissions\":{\"get\":{\"summary\":\"Fetch permissions in a Workspace\",\"description\":\"Gets less common project permissions for the authenticated user.\\n\\nThis endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-my-permissions-in-workspace\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}}],\"responses\":{\"200\":{\"description\":\"A list of Workspaces have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"can_change_budgetability\":{\"type\":\"boolean\",\"description\":\"Whether the user has permission to change the project budget settings.\"},\"can_change_currency\":{\"type\":\"boolean\",\"description\":\"Whether currency can be changed for the project.\"},\"can_change_time_approvals\":{\"type\":\"boolean\",\"description\":\"Whether the user has permission to change the time approval settings, and whether changing time\\napproval settings is allowed in the project.\"},\"can_change_expense_approvals\":{\"type\":\"boolean\",\"description\":\"Whether the user has permission to change the expense approval settings, and whether changing the\\nexpense approval settings is allowed in the project.\"},\"can_edit_change_orders\":{\"type\":\"boolean\",\"description\":\"Whether project change orders can be disabled.\"},\"can_edit_project_settings\":{\"type\":\"boolean\",\"description\":\"Whether the user has permission to edit settings in the project.\"},\"can_edit_team_names\":{\"type\":\"boolean\",\"description\":\"Whether the user has permission to edit team names in the project.\"},\"can_manage_invoice_preferences\":{\"type\":\"boolean\",\"description\":\"Whether the user has permission to edit invoice preferences in the project.\"},\"can_manage_finance\":{\"type\":\"boolean\",\"description\":\"Whether the user has permission (and the account has access) to project finance settings.\"},\"can_view_insights_dynamic_dashboards\":{\"type\":\"boolean\",\"description\":\"Whether the user has permission to view dynamic dashboards on the account.\"}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspaces/{id}/toggle_expense_approvals\":{\"put\":{\"summary\":\"Toggle expense approval setting\",\"description\":\"Enables the expense approval setting for a project.\\n\\nIf a `backfill_date` is specified, expenses until the specified date will be approved and the results of the\\napproval will be emailed to the authenticated user. Once the expenses have been approved, they cannot be unapproved.\\n\\n\\nThis endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace-expense-approval-setting\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace\":{\"type\":\"object\",\"properties\":{\"enable\":{\"type\":\"boolean\",\"description\":\"Whether expense approvals should be enabled.\"},\"backfill_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Date through which to backfill expenses. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspaces/{id}/toggle_time_approvals\":{\"put\":{\"summary\":\"Toggle time approval setting\",\"description\":\"Turns the time approval setting for a project on or off.\\n\\nIf you enable the time approval setting and specify a `backfill_date`, time entries until the specified date will be approved and the results of the\\napproval will be emailed to the authenticated user. Once the time entries have been approved, they cannot be unapproved.\\n\\nThis setting can't be turned off if there are active timesheet submissions or approvals for the project.\\n\\n\\nThis endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workspace-time-approval-setting\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace\":{\"type\":\"object\",\"properties\":{\"enable\":{\"type\":\"boolean\",\"description\":\"Whether time approvals should be enabled.\"},\"backfill_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"If `enable` is true, this is the date through which to approve existing time entries. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workspace has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workspaces/{id}/unarchive_with_approvals\":{\"put\":{\"summary\":\"Unarchive Workspace with Approvals\",\"description\":\"Unarchives a project.\\n\\nIf a time lock is set for the account and the project’s time approval setting is enabled, this endpoint will also\\napprove all unsubmitted time entries on or before the time lock date.\\n\\n\\nThis endpoint returns structured Workspace objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workspaces` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"unarchive-workspace-with-approvals\",\"tags\":[\"Workspaces\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `account_color` (AccountColor) - Retrieves the color of the workspace. The response will include `account_color_id`, which references the data in the `account_colors` top-level key.\\n- `account_insights_mappings` (AccountInsightsMapping) - Retrieves the Insights dynamic dashboards in the workspace. The response will include `account_insights_mapping_ids`, which references the data in the `account_insights_mappings` top-level key.\\n- `approver` (User) - Retrieves the first approver (as determined by user ID) on the workspace who is viewable to the current user. The response will include `approver_id`, which references the data in the `users` top-level key.\\n- `approvers` (User) - Retrieves all time approvers on the workspace who are viewable to the current user. The response will include `approver_ids`, which references the data in the `users` top-level key.\\n- `creator` (User) - Retrieves the user who created the project. The response will include `creator_id`, which references the data in the `users` top-level key. If the creator has left the project, you can use `primary_counterpart` to get the provider-side team lead.\\n- `current_status_report` (StatusReport) - Retrieves the most recent project status report from today. The response will include `current_status_report_id`, which references the data in the `status_reports` top-level key.\\n- `current_user_participation` (Participation) - Retrieves the workspace participation of the current user. The response will include `current_user_participation_ids`, which references the data in the `participations` top-level key.\\n- `custom_field_values` (CustomFieldValue) - Retrieves custom field values for the workspace. The response will include `custom_field_value_ids`, which references the data in the `custom_field_values` top-level key.\\n- `external_references` (ExternalReference) - Includes references to external integrations for this object.\\n- `financial_viewers` (User) - Retrieves the users on the project who have financial access. The response will include `financial_viewer_ids`, which references the data in the `users` top-level key.\\n- `next_uncompleted_milestone` (Story) - Retrieves the next project milestone that is not complete. The response will include `next_uncompleted_milestone_id`, which references the data in the `stories` top-level key.\\n- `participants` (User) - Retrieves users that are participating in the project. The response will include `participant_ids`, which references the data in the `users` top-level key.\\n- `participations` (Participation) - Retrieves the [participations](/tag/Participations) of each participant in the project. The response will include `participation_ids`, which references the data in the `participations` top-level key.\\n- `possible_approvers` (User) - Retrieves the users that can be made time approvers on the workspace. The response will include `possible_approver_ids`, which references the data in the `users` top-level key.\\n- `primary_counterpart` (User) - Retrieves the lead of the Clients team. The response will include `primary_counterpart_id`, which references the data in the `users` top-level key.\\n- `primary_maven` (User) - Retrieves the lead of the Providers team. The response will include `primary_maven_id`, which references the data in the `users` top-level key.\\n- `primary_workspace_group` (WorkspaceGroup) - Retrieves the primary group associated with the project. The response will include `primary_workspace_group_id`, which references the data in the `workspace_groups` top-level key.\\n- `status_reports` (StatusReport) - Retrieves the status reports for the workspace. The response will include `status_report_ids`, which references the data in the `status_reports` top-level key.\\n- `timesheet_submissions` (TimesheetSubmission) - Retrieves the list of all submitted timesheets which the user can approve on the project. The response will include `timesheet_submission_ids`, which references the data in the `timesheet_submissions` top-level key.\\n- `workspace_groups` (WorkspaceGroup) - Retrieves groups associated with the project that is visible to the current user. The response will include `workspace_group_ids`, which references the data in the `workspace_groups` top-level key.\\n- `workspace_resources` (WorkspaceResource) - Retrieves the named resources for the workspace. The response will include `workspace_resource_ids`, which references the data in the `workspace_resources` top-level key.\\n- `workspace_resources_with_unnamed` (WorkspaceResource) - Retrieves the named and unnamed resources for the workspace. The response will include `workspace_resources_with_unnamed_ids`, which references the data in the `workspace_resources` top-level key.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"optional_fields\",\"description\":\"Allows you to request one or more optional fields as an array.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"string\",\"enum\":[\"client_lead_name\",\"provider_lead_name\",\"stage\",\"estimated_minutes\",\"total_invoiced\",\"total_minutes_approved\",\"billable_minutes\",\"non_billable_minutes\",\"minutes_logged\",\"incoming_email_address\",\"lock_date\"]}}}],\"responses\":{\"200\":{\"description\":\"Workspace has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workspaces\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workspace\"}},\"external_references\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/ExternalReference\"}},\"stories\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Story\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"participations\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Participation\"}},\"timesheet_submissions\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/TimesheetSubmission\"}},\"workspace_groups\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceGroup\"}},\"custom_field_values\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/CustomFieldValue\"}},\"workspace_resources\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkspaceResource\"}},\"status_reports\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/StatusReport\"}},\"account_colors\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountColor\"}},\"account_insights_mappings\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/AccountInsightsMapping\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workweek_memberships\":{\"get\":{\"summary\":\"Fetching a list of Workweek Memberships\",\"description\":\"The Workweek Memberships endpoint provides a list of all workweek memberships that belongs to the\\naccount of the user making the request. The response will contain an array of workweek membership\\nobjects, sorted by their `start_date`.\\n\\n\\nThis endpoint returns structured Workweek Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweek_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workweek-memberships\",\"tags\":[\"Workweek Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"effective_date\",\"description\":\"Includes only workweek memberships with a start date before, and an end date after, the specified date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the user to whom the workweek membership belongs.\\n- `workweek` (Workweek) - References the associated workweek.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `start_date:asc` and `start_date:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"start_date:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"participants_for_workspace_id\",\"description\":\"Limit Workweek Memberships by those participating in the workspace of the specified workspace ID.\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\"}},{\"in\":\"query\",\"name\":\"participating_with\",\"required\":false,\"description\":\"Limits workweek memberships to those associated with the user making the request.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"user_ids\",\"description\":\"Includes only workweek memberships that belong to the specified user IDs.\",\"style\":\"form\",\"explode\":false,\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"}}}],\"responses\":{\"200\":{\"description\":\"A list of Workweek Memberships have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workweek Membership\",\"description\":\"This endpoint returns structured Workweek Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweek_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workweek-membership\",\"tags\":[\"Workweek Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the user to whom the workweek membership belongs.\\n- `workweek` (Workweek) - References the associated workweek.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workweek_membership\":{\"type\":\"object\",\"properties\":{\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user to whom the workweek belongs.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date of the workweek (must be a Sunday). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"sunday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Sunday.\"},\"monday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Monday.\"},\"tuesday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Tuesday.\"},\"wednesday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Wednesday.\"},\"thursday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Thursday.\"},\"friday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Friday.\"},\"saturday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Saturday.\"}},\"required\":[\"user_id\"]}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workweek Membership has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workweek_memberships/standardize_to_default\":{\"put\":{\"summary\":\"Switch to default workweek\",\"description\":\"Switches the specified user to the account default workweek, starting on the specified date.\\n\\nThis endpoint returns structured Workweek Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweek_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-user-workweek-to-default\",\"tags\":[\"Workweek Memberships\"],\"parameters\":[{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the user to whom the workweek membership belongs.\\n- `workweek` (Workweek) - References the associated workweek.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workweek_membership\":{\"type\":\"object\",\"properties\":{\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user being switched to the default workeek.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Switches to default workweek from the specified date. If not specified, defaults to today. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workweek Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workweek_memberships/{id}\":{\"get\":{\"summary\":\"Fetching a single Workweek Membership\",\"description\":\"This endpoint returns structured Workweek Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweek_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workweek-membership\",\"tags\":[\"Workweek Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the user to whom the workweek membership belongs.\\n- `workweek` (Workweek) - References the associated workweek.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Workweek Membership has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workweek Membership\",\"description\":\"This endpoint returns structured Workweek Membership objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweek_memberships` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workweek-membership\",\"tags\":[\"Workweek Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `user` (User) - References the user to whom the workweek membership belongs.\\n- `workweek` (Workweek) - References the associated workweek.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workweek_membership\":{\"type\":\"object\",\"properties\":{\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date of the workweek (must be a Sunday). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"sunday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Sunday.\"},\"monday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Monday.\"},\"tuesday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Tuesday.\"},\"wednesday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Wednesday.\"},\"thursday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Thursday.\"},\"friday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Friday.\"},\"saturday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Saturday.\"}}}}}}},\"required\":true},\"responses\":{\"200\":{\"description\":\"Workweek Membership has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}},\"users\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/User\"}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Workweek Membership\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-workweek-membership\",\"tags\":[\"Workweek Memberships\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Workweek Membership has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workweeks\":{\"get\":{\"summary\":\"Fetching a list of Workweeks\",\"description\":\"The Workweeks endpoint provides a list of every default Workweek that belongs to the Account of the User making the request.\\nThe response will contain an array of Workweek objects, sorted by their `start_date`.\\n\\n\\nThis endpoint returns structured Workweek objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweeks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workweeks\",\"tags\":[\"Workweeks\"],\"parameters\":[{\"in\":\"query\",\"name\":\"created_after\",\"description\":\"Filter for records created after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"created_before\",\"description\":\"Filter for records created before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"effective_date\",\"description\":\"Includes only workweeks that are effective on and after the specified date. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `workweek_memberships` (WorkweekMembership) - References the workweek memberships that use the workweek.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"only\",\"description\":\"Allows you to request one or more resources directly by ID. Multiple IDs can be supplied\\nin a comma separated list, like `GET /api/v1/workspaces.json?only=5,6,7`.\",\"schema\":{\"type\":\"string\"}},{\"in\":\"query\",\"name\":\"order\",\"description\":\"Supply `order` with the name of a valid sort field for the endpoint and a direction.\\n\\nValid values: `created_at:asc`, `created_at:desc`, `start_date:asc`, and `start_date:desc`.\",\"schema\":{\"type\":\"string\",\"default\":\"start_date:asc\"}},{\"in\":\"query\",\"name\":\"page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":1}},{\"in\":\"query\",\"name\":\"per_page\",\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"maximum\":200,\"default\":20}},{\"in\":\"query\",\"name\":\"updated_after\",\"description\":\"Filter for records updated after a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}},{\"in\":\"query\",\"name\":\"updated_before\",\"description\":\"Filter for records updated before a specified datetime. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\",\"schema\":{\"type\":\"string\",\"format\":\"date-time\"}}],\"responses\":{\"200\":{\"description\":\"A list of Workweeks have been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"post\":{\"summary\":\"Creating a new Workweek\",\"description\":\"This endpoint returns structured Workweek objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweeks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"create-workweek\",\"tags\":[\"Workweeks\"],\"parameters\":[{\"in\":\"query\",\"name\":\"enable_workweeks\",\"required\":false,\"description\":\"Required when creating a workweek for the first time.\",\"schema\":{\"type\":\"boolean\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `workweek_memberships` (WorkweekMembership) - References the workweek memberships that use the workweek.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/create-workweekBody\"},\"responses\":{\"200\":{\"description\":\"Workweek has been created.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}},\"/workweeks/{id}\":{\"get\":{\"summary\":\"Fetching a single Workweek\",\"description\":\"This endpoint returns structured Workweek objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweeks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"get-workweek\",\"tags\":[\"Workweeks\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `workweek_memberships` (WorkweekMembership) - References the workweek memberships that use the workweek.\",\"schema\":{\"type\":\"string\"}}],\"responses\":{\"200\":{\"description\":\"The Workweek has been retrieved.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"put\":{\"summary\":\"Updating an existing Workweek\",\"description\":\"This endpoint returns structured Workweek objects.\\nAs with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array\\nand will be indexed by ID in the `workweeks` top-level JSON key.\\nPlease see our [Response Format](#section/Response-Format) section for more information.\",\"operationId\":\"update-workweek\",\"tags\":[\"Workweeks\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}},{\"in\":\"query\",\"name\":\"include\",\"description\":\"Any of the below associations can be included in your request by providing the `include` param, e.g. `include=association1,association2`.\\n- `workweek_memberships` (WorkweekMembership) - References the workweek memberships that use the workweek.\",\"schema\":{\"type\":\"string\"}}],\"requestBody\":{\"$ref\":\"#/components/requestBodies/create-workweekBody\"},\"responses\":{\"200\":{\"description\":\"Workweek has been updated.\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"meta\":{\"type\":\"object\",\"properties\":{\"count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_count\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_number\":{\"type\":\"integer\",\"format\":\"int32\"},\"page_size\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"results\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}}},\"workweeks\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/Workweek\"}},\"workweek_memberships\":{\"type\":\"object\",\"additionalProperties\":{\"$ref\":\"#/components/schemas/WorkweekMembership\"}}}}}}},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}},\"delete\":{\"summary\":\"Deleting an existing Workweek\",\"description\":\"The response will contain no content and an HTTP 204 status code if the request was\\nsuccessful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.\",\"operationId\":\"delete-workweek\",\"tags\":[\"Workweeks\"],\"parameters\":[{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"description\":\"The ID of the Model.\",\"schema\":{\"type\":\"integer\"}}],\"responses\":{\"204\":{\"description\":\"Workweek has been deleted.\"},\"400\":{\"description\":\"Bad Request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"401\":{\"description\":\"Unauthorized request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"403\":{\"description\":\"Forbidden request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"404\":{\"description\":\"Page Not Found\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"422\":{\"description\":\"Unprocessable Entity\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}},\"503\":{\"description\":\"Service is unavailable\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/Errors\"}}}}}}}},\"x-tagGroups\":[{\"name\":\"# Subscribed Events\",\"tags\":[\"Event Types\",\"Events\"]},{\"name\":\"Account Locations\",\"tags\":[\"Account Locations\"]},{\"name\":\"Account Settings & Members\",\"tags\":[\"Access Group Memberships\",\"Account Colors\",\"Account Invitations\",\"Account Memberships\",\"Backup Approver Associations\",\"Billable Utilizations\",\"Cost Rates\",\"Custom Branding\",\"Organization Memberships\",\"Organizations\",\"Roles\",\"Skill Categories\",\"Skill Memberships\",\"Skills\",\"User Group Memberships\",\"Users\"]},{\"name\":\"Currencies\",\"tags\":[\"Currencies\"]},{\"name\":\"Custom Fields\",\"tags\":[\"Custom Field Choices\",\"Custom Field Sets\",\"Custom Field Values\",\"Custom Fields\"]},{\"name\":\"Data Exporter\",\"tags\":[\"Data Export Schema\",\"Data Exports\"]},{\"name\":\"Estimates\",\"tags\":[\"Estimate Scenario Resource Allocations\",\"Estimate Scenario Resources\",\"Estimate Scenarios\",\"Estimates\"]},{\"name\":\"Expense Budgets\",\"tags\":[\"Expense Budgets\"]},{\"name\":\"Expense Tracking\",\"tags\":[\"Attachments\",\"Expense Categories\",\"Expense Report Submissions\",\"Expenses\",\"Vendors\"]},{\"name\":\"External References\",\"tags\":[\"External References\"]},{\"name\":\"Foreign Exchange\",\"tags\":[\"Exchange Tables\"]},{\"name\":\"Insights & Analytics\",\"tags\":[\"Insights Access Group Memberships\",\"Insights Dynamic Dashboards\",\"Insights Report Exports\",\"Insights Reports\"]},{\"name\":\"Invoices\",\"tags\":[\"Client Invoice Defaults\",\"External Payments\",\"Invoices\",\"Workspace Invoice Preferences\"]},{\"name\":\"Personal Settings\",\"tags\":[\"Users\"]},{\"name\":\"Posts & Replies\",\"tags\":[\"Attachments\",\"Posts\",\"User File Associations\"]},{\"name\":\"Project Snapshots\",\"tags\":[\"Project Snapshots\"]},{\"name\":\"Project Templates\",\"tags\":[\"Project Template Additional Tabs\",\"Project Template Assignments\",\"Project Templates\"]},{\"name\":\"Projects\",\"tags\":[\"Participations\",\"Project Accounting Records\",\"Status Reports\",\"Workspace Allocations\",\"Workspace Baselines\",\"Workspace Groups\",\"Workspace Invoice Preferences\",\"Workspace Resource Skills\",\"Workspace Resources\",\"Workspace Status Changes\",\"Workspaces\"]},{\"name\":\"Proofs\",\"tags\":[\"Attachments\",\"Proof Review Participations\",\"Proof Reviews\",\"Proof Revisions\",\"Proofs\"]},{\"name\":\"Rate Cards\",\"tags\":[\"Activations\",\"Rate Card Role (Rate for a Role)\",\"Rate Card Set Version (Effective version by Date)\",\"Rate Card Sets (Group of Rate Cards)\",\"Rate Card Table Rows\",\"Rate Card Versions\",\"Rate Cards (Multiple Currencies)\"]},{\"name\":\"Recommendations\",\"tags\":[\"Recommendations\"]},{\"name\":\"Resource Requests\",\"tags\":[\"Resource Requests\"]},{\"name\":\"Scheduling\",\"tags\":[\"Holiday Calendar Associations\",\"Holiday Calendar Memberships\",\"Holiday Calendars\",\"Holidays\",\"Time Off Entries\",\"Workweek Memberships\",\"Workweeks\"]},{\"name\":\"Surveys (Legacy)\",\"tags\":[\"Survey Answers (Legacy)\",\"Survey Questions (Legacy)\",\"Survey Templates (Legacy)\",\"Surveys Responses (Legacy)\"]},{\"name\":\"Tasks\",\"tags\":[\"Assignments\",\"Daily Scheduled Hours (Story Allocation Days)\",\"Followers\",\"Stories\",\"Story Dependencies\",\"Story State Changes\",\"Story Tasks\"]},{\"name\":\"Time Tracking\",\"tags\":[\"Line Item Locks\",\"Time Entries\",\"Timesheet Approvals\",\"Timesheet Cancellations\",\"Timesheet Rejections\",\"Timesheet Submissions\"]}],\"servers\":[{\"url\":\"https://api.mavenlink.com/api/v1\"}],\"components\":{\"requestBodies\":{\"create-holidayBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"holiday\":{\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the holiday.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the holiday begins. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the holiday ends. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"paid\":{\"type\":\"boolean\",\"description\":\"Whether this time range is considered paid time off.\"},\"holiday_calendar_ids\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The calendars to which this holiday belongs.\"}},\"required\":[\"name\",\"start_date\"]}}}}},\"required\":true},\"create-workweekBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workweek\":{\"type\":\"object\",\"properties\":{\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date of the workweek (must be a Sunday). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"sunday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of workable minutes on Sunday.\"},\"monday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of workable minutes on Monday.\"},\"tuesday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of workable minutes on Tuesday.\"},\"wednesday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of workable minutes on Wednesday.\"},\"thursday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of workable minutes on Thursday.\"},\"friday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of workable minutes on Friday.\"},\"saturday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of workable minutes on Saturday.\"}}}}}}},\"required\":true},\"create-workspace-resource-allocations-from-scheduled-hoursBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"data\":{\"type\":\"array\",\"description\":\"An array of objects representing allocations to create for the specified resources.\",\"items\":{\"type\":\"object\",\"properties\":{\"resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of IDs of the resources to create allocations for. NOTE: This is only applicable when updating multiple resources via\\n                        `workspace_resources/allocations_matching_scheduled_hours`.\"},\"hard\":{\"type\":\"boolean\",\"description\":\"Whether the allocation is a Hard Allocation (“true”) or Soft (“false”). This value must be set to `false` if you are including any unnamed resources in your request.\"},\"occurrence\":{\"type\":\"object\",\"description\":\"The timeframe of scheduled hours in which to create allocations for.\",\"properties\":{\"type\":{\"type\":\"string\",\"description\":\"The timeframe in which to allocate the scheduled hours. Accepted values are `anytime`, `after`, `before`, and `between`.\"},\"after_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Sets the date on and after which the scheduled hours will be distributed as allocations. This value must be provided when the `type` is `after`. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"before_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Sets the date on and before which the scheduled hours will be distributed as allocations. This value must be provided when the `type` is `before`. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Sets the start of the date range which the scheduled hours will be distributed as allocations. This value must be provided when the `type` is `between`. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Sets the end of the date range which the scheduled hours will be distributed as allocations. This value must be provided when the `type` is `between`. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.\"}}}}}}}}}},\"required\":true},\"create-workspace-baselineBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"workspace_baseline\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"The title of the workspace baseline.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the workspace baseline.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the workspace the workspace baseline will belong to.\"}},\"required\":[\"title\"]}}}}},\"required\":true},\"approve-timesheet-submissionsBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"resolution\":{\"type\":\"object\",\"properties\":{\"description\":{\"type\":\"string\",\"description\":\"Any additional details about the resolution.\"},\"submission_ids\":{\"type\":\"array\",\"items\":{\"type\":\"integer\",\"format\":\"int32\"},\"description\":\"An array of Timesheet Submission IDs that will be processed in this resolution.\"}},\"required\":[\"submission_ids\"]}}}}},\"required\":true},\"approve-expense-report-submissionBody\":{\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"resolution\":{\"type\":\"object\",\"properties\":{\"description\":{\"type\":\"string\",\"description\":\"Any additional details about the resolution can be added in the description.\"}}}}}}},\"required\":true}},\"securitySchemes\":{\"BearerToken\":{\"type\":\"apiKey\",\"name\":\"Bearer\",\"in\":\"header\"},\"OauthSecurity\":{\"type\":\"oauth2\",\"flows\":{\"authorizationCode\":{\"authorizationUrl\":\"https://app.mavenlink.com/oauth/authorize\",\"tokenUrl\":\"https://app.mavenlink.com/oauth/token\",\"scopes\":{}}}}},\"schemas\":{\"AccessGroupMembership\":{\"title\":\"Access Group Membership\",\"description\":\"Access Groups allow you to manage product access for users. An Access Group Membership represents the connection of a user to an Access Group.\",\"type\":\"object\",\"properties\":{\"access_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated access group.\"},\"access_group_name\":{\"type\":\"string\",\"description\":\"The name of the associated access group.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the access group membership was created (i.e. when the user was added to the access group).\"},\"creator_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user that created the access group membership (i.e. the person that added the user to the access group).\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated user.\"},\"user_name\":{\"type\":\"string\",\"description\":\"The name of the associated user.\"}}},\"AccountColor\":{\"title\":\"Account Color\",\"description\":\"A color on the user's account that can be associated with a project.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"default_color\":{\"type\":\"boolean\",\"description\":\"Whether the color is the account default. Each account can only have one default color.\"},\"enabled\":{\"type\":\"boolean\",\"description\":\"Whether the color is enabled on the account.\"},\"hex\":{\"type\":\"string\",\"description\":\"The hex value of the color in the format #XXXXXX.\"},\"name\":{\"type\":\"string\",\"description\":\"The human readable color name.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"AccountDataExportResult\":{\"title\":\"Data Export\",\"description\":\"Account data exports are used to download account data from Kantata OX.\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The account ID the export was generated for.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the export was generated.\"},\"export_definition\":{\"type\":\"object\",\"description\":\"The data set and columns that were exported.\",\"additionalProperties\":{\"type\":\"object\",\"description\":\"The `key` value for a data set.\",\"properties\":{\"display_name\":{\"type\":\"string\",\"description\":\"The name of the data set as it appears in the Data Exporter.\"},\"key\":{\"type\":\"string\",\"description\":\"The `key` value for a data set.\"},\"columns\":{\"type\":\"array\",\"description\":\"The columns included in the export.\",\"items\":{\"type\":\"object\",\"properties\":{\"key\":{\"type\":\"string\",\"description\":\"The `key` value for a column in a data set.\"},\"display_name\":{\"type\":\"string\",\"description\":\"The names of columns as they appear in the Data Exporter.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of a column in an export.\"},\"type\":{\"type\":\"string\",\"description\":\"The data type of a column.\"}}}},\"filters\":{\"type\":\"object\",\"description\":\"The filters that were applied to the export.\",\"properties\":{\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date the export was filtered by, which restricts data to objects that were created on or after the given date.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The end date the export was filtered by, which restricts data to objects that were created on or before the given date.\"}}}}}},\"status\":{\"type\":\"string\",\"description\":\"The status of an export.\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"AccountInsightsMapping\":{\"title\":\"Account Insights Mapping\",\"description\":\"Account Insights Mapping represent the Insights dashboards on your account.\",\"type\":\"object\",\"properties\":{\"access_group_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`access_group_ids` will only be included in the response if `access_groups` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"creator\":{\"type\":\"string\",\"description\":\"The name of the person that created the dashboard.\"},\"dynamic\":{\"type\":\"boolean\",\"description\":\"Whether the dashboard is a dynamic dashboard.\"},\"is_custom_dashboard\":{\"type\":\"boolean\",\"description\":\"Whether the dashboard is a standard (`false`) or custom (`true`) dashboard.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the dashboard.\"}}},\"AccountInvitation\":{\"title\":\"Account Invitation\",\"description\":\"The Account Invitation represents an invitation to join an existing Kantata OX account as a user.\",\"type\":\"object\",\"properties\":{\"bill_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default billing rate, in cents, for the user in a workspace on this account.\\nVisible when the API user is on the invitation account. and the API user is an Account Project Lead..\"},\"billability_target\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user is on the invitation account. and the API user is an Account Project Lead..\"},\"cost_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default cost rate, in cents, for the user in a workspace on this account.\\nVisible when the API user is on the invitation account. and the API user is an Account Administrator..\"},\"default_role_id\":{\"type\":\"string\",\"description\":\"`default_role_id` will only be included in the response if `default_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"email_address\":{\"type\":\"string\",\"description\":\"The email address of the invited user. An email is sent to this address with a link to accept the invitation.\"},\"expiration_date\":{\"type\":\"string\",\"description\":\"The invitation's expiration date.\"},\"full_name\":{\"type\":\"string\",\"description\":\"The full name of the invited user.\"},\"headline\":{\"type\":\"string\"},\"invitee_id\":{\"type\":\"string\",\"description\":\"`invitee_id` will only be included in the response if `invitee` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"inviter_id\":{\"type\":\"string\",\"description\":\"`inviter_id` will only be included in the response if `inviter` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"pending\":{\"type\":\"boolean\",\"description\":\"The status of the invitation.\"},\"permission\":{\"type\":\"string\",\"description\":\"The access level that the invited user will have (one of administrator, reports_viewer_with_cost, reports_viewer, project_lead, project_creator, collaborator, and punch_clock).\"}}},\"AccountLocation\":{\"title\":\"Account Location\",\"description\":\"Represents a location associated with an account.\",\"type\":\"object\",\"properties\":{\"archived\":{\"type\":\"boolean\",\"description\":\"Whether the Account Location is archived.\"},\"in_use\":{\"type\":\"boolean\",\"description\":\"Whether the Account Location is in use.\"},\"name\":{\"type\":\"string\",\"description\":\"The location the Account Location represents.\"}}},\"AccountMembership\":{\"title\":\"Account Membership\",\"description\":\"An Account Membership represents the relationship of a user to an account.\",\"type\":\"object\",\"properties\":{\"backup_approver_association_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`backup_approver_association_ids` will only be included in the response if `backup_approver_associations` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"bill_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default billing rate, in cents, for the user in a workspace on this account when the workspace\\ndoes not use rate card. This attribute is only accessible if the current user is a Project Lead.\\nVisible when the account membership is on the same account as the API user. and the API user is an Account Project Lead..\"},\"billability_target\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the account membership is on the same account as the API user. and the API user is an Account Project Lead..\"},\"can_create_workspace\":{\"type\":\"boolean\",\"description\":\"Whether the user can create projects.\"},\"can_view_reports\":{\"type\":\"boolean\",\"description\":\"Whether the user can view reports.\"},\"collaborator_only_license\":{\"type\":\"boolean\",\"description\":\"Whether the user is always a Collaborator in projects.\\nVisible when the account membership is on the same account as the API user..\"},\"cost_rate_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`cost_rate_ids` will only be included in the response if `cost_rates` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"cost_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default cost rate, in cents, for the user in a workspace on this account. This attribute is only\\naccessible if the current user is an Administrator on the account.\\nVisible when the account membership is on the same account as the API user. and the API user is an Account Administrator..\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"default_read_only\":{\"type\":\"boolean\",\"description\":\"Whether the user is always read-only in projects.\"},\"default_role_id\":{\"type\":\"string\",\"description\":\"`default_role_id` will only be included in the response if `default_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"disabled_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date when the account membership was disabled.\"},\"effective_workweek_id\":{\"type\":\"string\",\"description\":\"`effective_workweek_id` will only be included in the response if `effective_workweek` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"future_billable_utilization_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`future_billable_utilization_ids` will only be included in the response if `future_billable_utilizations` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"is_administrator\":{\"type\":\"boolean\",\"description\":\"Whether the user is an Administrator.\"},\"is_backup_approver\":{\"type\":\"boolean\",\"description\":\"Whether the user is a backup approver for others users on the account.\"},\"is_owner\":{\"type\":\"boolean\",\"description\":\"The owner of the account.\"},\"is_project_lead\":{\"type\":\"boolean\",\"description\":\"Whether the user is a Project Lead.\"},\"is_punch_clock_user\":{\"type\":\"boolean\",\"description\":\"Whether the user is a Punch Clock User.\"},\"managee_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`managee_ids` will only be included in the response if `managees` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"manager_can_approve\":{\"type\":\"boolean\",\"description\":\"If present, the assigned manager can approve submitted time and expenses.\"},\"manager_can_edit_skills\":{\"type\":\"boolean\",\"description\":\"If present, the assigned manager can edit the user's skills.\"},\"manager_id\":{\"type\":\"string\",\"description\":\"`manager_id` will only be included in the response if `manager` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"non_participant\":{\"type\":\"boolean\",\"description\":\"\\nVisible when the account membership is on the same account as the API user..\\n\\nOnly returned when requested through the optional_fields param.\"},\"permission\":{\"type\":\"string\",\"description\":\"The user's access level. Options are administrator, reports_viewer_with_cost, reports_viewer, project_lead, project_creator, collaborator, external_collaborator, and punch_clock.\"},\"possible_managee_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`possible_managee_ids` will only be included in the response if `possible_managees` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"possible_manager_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`possible_manager_ids` will only be included in the response if `possible_managers` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"should_show_alert_on_timesheet_submission\":{\"type\":\"boolean\",\"description\":\"Show an alert on a user's timesheet submission.\"},\"skill_membership_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`skill_membership_ids` will only be included in the response if `skill_memberships` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"AdditionalItem\":{\"title\":\"Additional Item\",\"type\":\"object\",\"properties\":{\"amount_in_cents\":{\"type\":\"integer\",\"format\":\"int32\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"currency\":{\"type\":\"string\"},\"notes\":{\"type\":\"string\"},\"taxable\":{\"type\":\"boolean\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"Assignment\":{\"title\":\"Assignment\",\"description\":\"An Assignment represents the relationship of a resource to a task. It owns\\nStory Allocation Days.\",\"type\":\"object\",\"properties\":{\"allocated_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The calculated sum of the assignment's Story Allocation Day minutes.\"},\"assignee_id\":{\"type\":\"string\",\"description\":\"`assignee_id` will only be included in the response if `assignee` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"current\":{\"type\":\"boolean\",\"description\":\"Whether the assignment is active.\"},\"estimated_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated number of minutes that the resource is expected to work on this task.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resource who owns the assignment.\"},\"story_allocation_day_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`story_allocation_day_ids` will only be included in the response if `story_allocation_days` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"BackupApproverAssociation\":{\"title\":\"Backup Approver Association\",\"description\":\"Backup Approver Associations describe when a backup approver will be active, or responsible\\nfor approving time.\",\"type\":\"object\",\"properties\":{\"approver_id\":{\"type\":\"string\",\"description\":\"`approver_id` will only be included in the response if `approver` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"backup_approver_id\":{\"type\":\"string\",\"description\":\"`backup_approver_id` will only be included in the response if `backup_approver` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The backup approver end date.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The backup approver start date.\"}}},\"BaselinePayload\":{\"title\":\"Baseline Payload\",\"description\":\"A Baseline Payload is associate with one Workspace Baseline.\\n\\nThe `raw_data` attribute contains a snapshot of all the stories in the workspace. It tracks the following\\nattributes for each Story:\\n\\n* Start Date\\n* Due Date\\n* Percentage Complete.\",\"type\":\"object\",\"properties\":{\"raw_data\":{\"type\":\"string\",\"description\":\"A JSON blob for this Baseline Payload.\"},\"workspace_baseline_id\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"BillableUtilization\":{\"title\":\"Billable Utilization\",\"description\":\"Represents the billable utilization target for an account member. Each record has an effective date; the active billable utilization is the one with the most recent effective date.\",\"type\":\"object\",\"properties\":{\"account_membership_id\":{\"type\":\"string\",\"description\":\"`account_membership_id` will only be included in the response if `account_membership` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Date this billable utilization becomes active and the target goes into effect. Targets go into effect on midnight of the date selected (based on the Time Zone set in the Profile of the member).\"},\"target\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Percentage of logged hours that should be billable.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"BuyerParticipation\":{\"title\":\"Participation\",\"description\":\"Participations in Kantata OX connect Users and Workspaces (projects). It includes\\npermissions, cost rate, bill rate and role details for the participant in the workspace.\",\"type\":\"object\",\"properties\":{\"access_level\":{\"type\":\"string\",\"description\":\"Access level for the user in the workspace. It must be one of \\\"admin\\\", \\\"financial\\\", \\\"time_logging\\\", \\\"collaboration\\\".\\nVisible when the API user is an administrator on the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"active_role_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`active_role_ids` will only be included in the response if `active_roles` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"allocated_workspace_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The allocated minutes for the participant scoped to this project.\\nVisible when the API user is a reports viewer on the project's account..\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the participant has edit permissions to the project.\\nVisible when the API user is an administrator on the project.\"},\"can_invite\":{\"type\":\"boolean\",\"description\":\"Whether the participant can invite others to the project.\"},\"can_post\":{\"type\":\"boolean\",\"description\":\"Whether the participant can post in the project.\\nVisible when the API user is an administrator on the project.\"},\"cost_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost (in cents) for the participant for this this project.\\nVisible when the API user is an administrator and a consultant on the project..\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"default_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default rate (in cents) for the participant for this project.\\nVisible when the API user is a consultant on the project and has financial access on the project.\"},\"estimated_workspace_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated minutes for the participant scoped to this project.\\nVisible when the API user is a reports viewer on the project's account..\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"is_team_lead\":{\"type\":\"boolean\",\"description\":\"Whether the participant is a team lead in the project.\"},\"primary_role_id\":{\"type\":\"string\",\"description\":\"`primary_role_id` will only be included in the response if `primary_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate (in cents) for the participant for this project.\\nVisible when the API user is a consultant on the project and has financial access on the project.\"},\"role\":{\"type\":\"string\",\"description\":\"The role for the participant.\"},\"show_as_read_only\":{\"type\":\"boolean\",\"description\":\"Whether the API user can only read the project.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_resource_ids` will only be included in the response if `workspace_resources` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_role_id\":{\"type\":\"string\",\"description\":\"`workspace_role_id` will only be included in the response if `workspace_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"ChangeOrder\":{\"title\":\"Change Order\",\"type\":\"object\"},\"ClientInvoiceDefault\":{\"title\":\"Client Invoice Defaults\",\"description\":\"Represents the default configuration for presenting invoices to clients.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the invoice default was created.\"},\"expense_rollup_type\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Options for how expenses are formatted on an invoice. These options include 'Detailed' and 'Grouped'. They are represented by the numbers 0 and 1, respectively.\"},\"rich_text\":{\"type\":\"string\",\"description\":\"Default rich text shown as additional details on the invoice.\"},\"show_creators\":{\"type\":\"boolean\",\"description\":\"Whether the name of the person who created the entry should be shown.\"},\"show_dates\":{\"type\":\"boolean\",\"description\":\"Whether dates for items on the invoice should be shown.\"},\"show_hours\":{\"type\":\"boolean\",\"description\":\"Whether hours logged on a time entry on the invoice should be shown.\"},\"show_notes\":{\"type\":\"boolean\",\"description\":\"Whether notes for items on the invoice should be shown.\"},\"show_project_names\":{\"type\":\"boolean\",\"description\":\"Whether project names should be shown on the invoice.\"},\"show_rates\":{\"type\":\"boolean\",\"description\":\"Whether the rate for the item should be shown.\"},\"show_roles\":{\"type\":\"boolean\",\"description\":\"Whether the role of the person who created the item should be shown.\"},\"show_subtotals\":{\"type\":\"boolean\",\"description\":\"Whether subtotals should be shown for time entries on the invoice.\"},\"show_task_names\":{\"type\":\"boolean\",\"description\":\"Whether task names should be shown for invoice items.\"},\"show_tax\":{\"type\":\"boolean\",\"description\":\"Whether the item's taxable amount should be shown.\"},\"time_rollup_type\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Options for how time is formatted on an invoice. These options include 'Detailed', 'Grouped by task', and 'Grouped by person, then task'. They are represented by the numbers 0, 1, and 2, respectively.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the invoice default was last updated.\"}}},\"Column\":{\"title\":\"Column\",\"type\":\"object\",\"properties\":{\"filters\":{\"type\":\"string\",\"description\":\"The saved filters for the column.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the column.\"}}},\"CostRate\":{\"title\":\"Cost Rate\",\"description\":\"A Cost Rate represents the hourly cost of an account member, specified in a specific currency. A Cost Rate with the same currency\\nas the account default currency is called the `default cost rate`. This data can only be accessed by including\\nit when querying Account Membership.\",\"type\":\"object\",\"properties\":{\"account_membership_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated account membership.\"},\"amount_in_subunits\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount of the cost rate in the subunits of the currency (i.e. cents for US Dollars).\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"currency\":{\"type\":\"string\",\"description\":\"The ISO code of the cost rate currency.\"},\"in_use\":{\"type\":\"boolean\",\"description\":\"Indicates whether the account member associated with the cost rate is participating in a workspace\\non the account that uses the same currency as the cost rate.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"CustomField\":{\"title\":\"Custom Field\",\"description\":\"The [Custom Fields](https://mavenlink.zendesk.com/hc/en-us/articles/202924760-Custom-Fields-Overview-#arrange) object allows you to\\nview, create, update, and delete extra fields for additional Estimate, Project, Group, Resource, Task, and User information.\\nIf Custom Fields represent the fields themselves, [Custom Field Values](/tag/Custom-Field-Values)\\nrepresent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`choice_ids` will only be included in the response if `choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_set_id\":{\"type\":\"string\",\"description\":\"`custom_field_set_id` will only be included in the response if `custom_field_set` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"default_text\":{\"type\":\"string\",\"description\":\"The message in an empty custom field, before a `string`, `date`, `number`, or `currency`  value is entered in.\\nThis only appears in the UI.\\nVisible when whether the custom field is an input field..\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the custom field.\"},\"read_access\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n  - `project_collaboration` (default)\\n  - `time_logging`\\n  - `financial`\\n  - `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n  - `account_collaboration`\\n  - `project_creator`\\n  - `project_lead`\\n  - `reports_viewer`\\n  - `reports_viewer_with_cost`\\n  - `account_admin` (default).\"},\"unique_constraint\":{\"type\":\"boolean\",\"description\":\"Indicates whether a custom field value must be unique across Estimates, Projects, Groups, Resources, Tasks, or Users.\\nThis is set to `false` by default.\\n\\nDoes not apply to Custom Fields with choices.\\nVisible when whether the custom field is an input field..\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value_type\":{\"type\":\"string\",\"description\":\"The format of the [custom field's value](/tag/Custom-Field-Values):\\n    | Value Type           | Format                                   | Sample         |\\n    | -------------------- |:----------------------------------------:| --------------:|\\n    | `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n    | `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n    | `number`             | `<integer_value>`                        |           `13` |\\n    | `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n    | `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\nThis is set to `string`, by default.\"},\"write_access\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The permission level required for a user to create, update, or delete a custom field's value.\"}}},\"CustomFieldChoice\":{\"title\":\"Custom Field Choice\",\"description\":\"Custom Field Choices are possible values for `single` and `multi` type custom fields.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_id\":{\"type\":\"string\",\"description\":\"`custom_field_id` will only be included in the response if `custom_field` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"label\":{\"type\":\"string\"},\"position\":{\"type\":\"integer\",\"format\":\"int32\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"CustomFieldSet\":{\"title\":\"Custom Field Set\",\"description\":\"Custom Field Sets contain custom fields and definitions of each fields' subject type. The supported\\nsubjects are currently Estimate, Project, Project Group, Resource, Task, and User.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`custom_field_ids` will only be included in the response if `custom_fields` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"name\":{\"type\":\"string\"},\"subject_type\":{\"type\":\"string\",\"description\":\"The type of objects contained in the custom field set. The supported subjects are currently\\n*Workspace*, *Story*, *User*, and *WorkspaceGroup*.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"CustomFieldValue\":{\"title\":\"Custom Field Value\",\"description\":\"If [Custom Fields](/tag/Custom-Fields) represent the fields themselves,\\nCustom Field Values represent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account the Custom Field Value is in.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the Custom Field Value can be edited by the requester.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_id\":{\"type\":\"string\",\"description\":\"`custom_field_id` will only be included in the response if `custom_field` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_name\":{\"type\":\"string\",\"description\":\"The name of the Custom Field.\"},\"display_value\":{\"type\":\"string\",\"description\":\"The Custom Field Values, but in more understandable formats:\\n* For Custom Fields with values that are selected choices, the labels on those choices are returned.\\n* For Custom Fields with currency values, the amount with the currency symbol ($100) is returned.\\n* All other values are converted into a string.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"selected_choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`selected_choice_ids` will only be included in the response if `selected_choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"setter_id\":{\"type\":\"string\",\"description\":\"`setter_id` will only be included in the response if `setter` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Estimate, Project, Group, Resource, Task, or User the custom field is for.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_type\":{\"type\":\"string\",\"description\":\"The set of Custom Fields that values are returned for:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\"},\"type\":{\"type\":\"string\",\"description\":\"Potential formats of values:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value\":{\"type\":\"string\",\"description\":\"The value created or updated for the specified custom field.\\n\\nValues can be created or updated in these formats:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\n##### Note:\\nThe `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n- `project_collaboration` (default)\\n- `time_logging`\\n- `financial`\\n- `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n- `account_collaboration`\\n- `project_creator`\\n- `project_lead`\\n- `reports_viewer`\\n- `reports_viewer_with_cost`\\n- `account_admin` (default).\"}}},\"Department\":{\"title\":\"Organization\",\"description\":\"An Organization allows you to structure and group your projects and account members by\\ndepartments and geographies.\",\"type\":\"object\",\"properties\":{\"ancestor_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"The ids of all ancestors of the organization.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"name\":{\"type\":\"string\",\"description\":\"The unique name of the organization.\"},\"parent_id\":{\"type\":\"string\",\"description\":\"The id of the parent organization.\"},\"type\":{\"type\":\"string\",\"description\":\"The type of the organization, either 'Geography' or 'Department'.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"Estimate\":{\"title\":\"Estimate\",\"description\":\"An Estimate represents a potential project. Estimates allow you to plan out a project's budget, resources,\\nand allocations through associated estimate scenarios.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The time the estimate was created.\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the estimate, used in all associated estimate scenarios.\"},\"custom_field_value_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`custom_field_value_ids` will only be included in the response if `custom_field_values` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the estimate.\"},\"estimate_scenario_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`estimate_scenario_ids` will only be included in the response if `estimate_scenarios` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"is_locked\":{\"type\":\"boolean\",\"description\":\"Whether a project has been created from the estimate. If so, the estimate can no longer be updated.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the estimate.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"workspace_group_id\":{\"type\":\"string\",\"description\":\"`workspace_group_id` will only be included in the response if `workspace_group` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"EstimateScenario\":{\"title\":\"Estimate Scenario\",\"description\":\"An Estimate Scenario represents a possible project configuration. It includes a rate card, budget, and\\nassociated resources and allocations.\",\"type\":\"object\",\"properties\":{\"budget_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The maximum budget, in cents, available for the project.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"estimate_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the estimate for the scenario.\"},\"estimate_scenario_resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`estimate_scenario_resource_ids` will only be included in the response if `estimate_scenario_resources` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the estimate scenario.\"},\"rate_card_id\":{\"type\":\"string\",\"description\":\"`rate_card_id` will only be included in the response if `rate_card` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The estimated date when the project will start.\"},\"target_margin_percent\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The target profit margin, in percentage, for the project.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"EstimateScenarioResource\":{\"title\":\"Estimate Scenario Resource\",\"description\":\"An Estimate Scenario Resource is an unnamed resource in an estimate scenario.\",\"type\":\"object\",\"properties\":{\"allocation_id\":{\"type\":\"string\",\"description\":\"`allocation_id` will only be included in the response if `allocation` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"bill_rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The bill rate, in cents, of the estimate scenario resource.\\nWhen the estimate is unlocked, this is the average bill rate of all active account members in the\\nscenario resource's geography, whose default role matches the role of the scenario resource.\\nWhen the estimate is locked, this the cached value of the average bill rate when the estimate was locked.\"},\"cost_rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost rate, in cents, of the estimate scenario resource.\\nWhen the estimate is unlocked, this is the average cost rate of all active account members in the\\nscenario resource's geography, whose default role matches the role of the scenario resource.\\nWhen the estimate is locked, this the cached value of the average cost rate when the estimate was locked.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"display_label\":{\"type\":\"string\",\"description\":\"User facing Identifier for the Resource.\"},\"estimate_scenario_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Id of the Estimate Scenario that the Resource belongs to.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"geography_id\":{\"type\":\"string\",\"description\":\"`geography_id` will only be included in the response if `geography` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"label\":{\"type\":\"string\"},\"organization_membership_id\":{\"type\":\"string\",\"description\":\"`organization_membership_id` will only be included in the response if `organization_membership` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"role_name\":{\"type\":\"string\",\"description\":\"Name of the Resource's role if any.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"EstimateScenarioResourceAllocation\":{\"title\":\"Estimate Scenario Resource Allocation\",\"description\":\"Estimate Scenario Resource Allocations contain time-related data for scenario resources—used\\nfor calculating estimated cost and scheduled hours.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"duration_days\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total number of business days an scenario resource is expected to work on the project.\"},\"percent_allocated\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The percentage of available hours the scenario resource will work on the project.\"},\"relative_start_day\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of business days, after the estimate scenario's start date, that an scenario resource\\nwill begin working on the project.\"},\"resource_id\":{\"type\":\"string\",\"description\":\"`resource_id` will only be included in the response if `resource` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"Expense\":{\"title\":\"Expense\",\"description\":\"Expenses are non-time related costs incurred in a project. Once created, expenses can\\nbe included in generated invoices.\",\"type\":\"object\",\"properties\":{\"active_submission_id\":{\"type\":\"string\",\"description\":\"`active_submission_id` will only be included in the response if `active_submission` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"amount_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount, in cents, of the expense.\"},\"category\":{\"type\":\"string\",\"description\":\"The category of the expense (can be any string). Built-in categories are:\\nTravel, Mileage, Lodging, Food, Entertainment, and Other.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the expense.\"},\"currency_base_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of the units in the `amount_as_cents` attribute that are required to make up a single unit of the `currency`.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"The symbol that represents the currency of the expense.\"},\"date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the expense was incurred.\"},\"expense_category_id\":{\"type\":\"string\",\"description\":\"`expense_category_id` will only be included in the response if `expense_category` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"foreign_exchange_amount\":{\"type\":\"object\",\"description\":\"The currency conversion data for a converted expense.\",\"properties\":{\"date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date the expense was converted.\"},\"rate\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The exchange rate used to convert the expense.\"},\"source_currency\":{\"type\":\"string\",\"description\":\"The [ISO code](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473-Supported-Currency-ISO-Codes) of the foreign currency in which the expense was incurred.\"},\"source_value\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The amount of the expense, in foreign currency units.\"}}},\"is_billable\":{\"type\":\"boolean\",\"description\":\"Whether this is a billable expense.\"},\"is_invoiced\":{\"type\":\"boolean\",\"description\":\"Whether this expense has been included on an invoice.\"},\"notes\":{\"type\":\"string\",\"description\":\"All notes that have been added to the expense.\"},\"receipt_id\":{\"type\":\"string\",\"description\":\"`receipt_id` will only be included in the response if `receipt` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"recent_submission_id\":{\"type\":\"string\",\"description\":\"`recent_submission_id` will only be included in the response if `recent_submission` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"reimbursable\":{\"type\":\"boolean\",\"description\":\"Whether this expense is reimbursable to the creator or to a vendor.\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"taxable\":{\"type\":\"boolean\",\"description\":\"Whether this expense is marked as taxable when invoiced.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the viewing user can edit this expense.\\nOnly returned when requested through the optional_fields param.\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"vendor_id\":{\"type\":\"string\",\"description\":\"`vendor_id` will only be included in the response if `vendor` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"ExpenseBudget\":{\"title\":\"Expense Budgets\",\"description\":\"Expense budgets allow you to plan for non-labor expenses.\",\"type\":\"object\",\"properties\":{\"billable\":{\"type\":\"boolean\",\"description\":\"Whether the expense will be billed to the client.\"},\"burns_budget\":{\"type\":\"boolean\",\"description\":\"Whether the expense budget impacts the project margin.\"},\"cost_per_unit_in_subunits\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost, in the subunits of the currency (e.g. cents for USD).\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the expense budget.\"},\"expected_by\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the expenses are expected to be logged by.\"},\"expense_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`expense_ids` will only be included in the response if `expenses` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"fixed_fee\":{\"type\":\"boolean\",\"description\":\"Whether the expense will be billed as a fixed cost.\"},\"fixed_fee_item_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`fixed_fee_item_ids` will only be included in the response if `fixed_fee_items` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated story (task).\"},\"title\":{\"type\":\"string\",\"description\":\"The name of the expense budget.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the workspace the expense budget belongs to.\"}}},\"ExpenseCategory\":{\"title\":\"Expense Category\",\"description\":\"An Expense Category represents the type of expense that is being reported.\\nExpense categories have no attributes and consist of just their name\\nas a string. They can be changed by Account Administrators.\",\"type\":\"object\",\"properties\":{\"deleted_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The time when the expense category was deleted (if it has been deleted).\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the expense category.\"}}},\"ExpenseReportSubmission\":{\"title\":\"Expense Report Submission\",\"description\":\"Expense report submissions contain a set of expense line items. These expenses must be approved through\\nan expense report submission before they can be added to an invoice. All submission expenses must be in the \\nsame workspace (project).\",\"type\":\"object\",\"properties\":{\"comment\":{\"type\":\"string\",\"description\":\"Additional comments on the submission.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the submission was created.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the submission.\"},\"currency_base_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The base unit of the submission's currency.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"The symbol of the submission's currency.\"},\"current_resolution_created_at_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the submission's current resolution was created.\"},\"current_resolution_creator_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The creator id on the submission's current resolution.\"},\"current_resolution_description\":{\"type\":\"string\",\"description\":\"The description on the submission's current resolution.\"},\"expense_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`expense_ids` will only be included in the response if `expenses` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"line_item_total_formatted\":{\"type\":\"string\",\"description\":\"A formatted total of the line items (time entries or expenses) on the submission.\"},\"line_item_total_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"A total in cents of the line items (time entries or expenses) on the submission.\"},\"locked\":{\"type\":\"boolean\",\"description\":\"Whether or not the submission can be changed.\"},\"permissions\":{\"type\":\"object\",\"properties\":{\"can_cancel_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user cancel the submission.\"},\"can_approve_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user approve the submission.\"},\"can_reject_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user reject the submission.\"},\"can_resubmit_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user resubmit the submission.\"}}},\"resolution_description\":{\"type\":\"string\",\"description\":\"The description on the submission's current resolution.\"},\"resolution_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`resolution_ids` will only be included in the response if `resolutions` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"status\":{\"type\":\"string\",\"description\":\"The current status of the submission ('approved', 'rejected', 'cancelled', 'pending').\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the submission.\"},\"type\":{\"type\":\"string\",\"description\":\"Either an ExpenseReportSubmission or a TimesheetSubmission.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the submission was last updated.\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"ExternalPayment\":{\"title\":\"External Payment\",\"description\":\"An External Payment is a record within a workspace of a payment that happened outside of Kantata OX.\",\"type\":\"object\",\"properties\":{\"amount_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount the payment was for, in cents.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the payment was created.\"},\"invoice_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the invoice, if any, for which the payment was created.\"},\"message\":{\"type\":\"string\",\"description\":\"The message that accompanied the payment.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the payment was last updated.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the user who created the payment.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the project in which the payment was created.\"}}},\"ExternalReference\":{\"title\":\"External Reference\",\"description\":\"External References allows users see which objects (one of `Assignment`, `CustomField`, `CustomFieldChoice`, `CustomFieldSet`, `CustomFieldValue`, `Estimate`, `EstimateScenario`, `EstimateScenarioResource`, `Expense`, `Invoice`, `Participation`, `Post`, `RateCard`, `Role`, `Skill`, `StatusReport`, `Story`, `StoryAllocationDay`, `Submission`, `SurveyAnswer`, `SurveyQuestion`, `SurveyResponse`, `SurveyTemplate`, `TimeEntry`, `TimeOffEntry`, `User`, `Vendor`, `Workspace`, `WorkspaceAllocation`, `WorkspaceGroup`, or `WorkspaceResource`\\nare synced with third party systems. This allows you to view the sync status of items in addition to the integration\\nspecifics for a synced object.\\n\\nObjects that are synced with a third party system have external integration\\nattributes that include the corresponding ID of the third party object with\\nwhich it is synced, a link that allows you to view the object in the third\\nparty system, the status of the external object in the external system,\\nthe status of the sync, and a link to exceptions.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the reference was created.\"},\"external_link\":{\"type\":\"string\",\"description\":\"A URL that links to either the external object or event.\"},\"external_message\":{\"type\":\"string\",\"description\":\"An optional message about the external object.\"},\"external_status\":{\"type\":\"string\",\"description\":\"The status of the external object in the external system.\"},\"last_synced_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"locked\":{\"type\":\"boolean\",\"description\":\"An optional field, indicating whether the subject should be locked. To prevent changes to the\\nobject in Kantata OX, set this to true. This currently only applies to expense report rejections.\"},\"service_model\":{\"type\":\"string\",\"description\":\"The type of the external object to which this reference belongs.\"},\"service_model_ref\":{\"type\":\"string\",\"description\":\"The ID of the external object to which this reference belongs.\"},\"service_name\":{\"type\":\"string\",\"description\":\"The provider name of the integration.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the integration. Options are 'pending', 'successful', or 'failed'.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Kantata OX object to which this external reference belongs.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_type\":{\"type\":\"string\",\"description\":\"The type of Kantata OX object to which this external reference belongs.\\nOne of `Assignment`, `CustomField`, `CustomFieldChoice`, `CustomFieldSet`, `CustomFieldValue`, `Estimate`, `EstimateScenario`, `EstimateScenarioResource`, `Expense`, `Invoice`, `Participation`, `Post`, `RateCard`, `Role`, `Skill`, `StatusReport`, `Story`, `StoryAllocationDay`, `Submission`, `SurveyAnswer`, `SurveyQuestion`, `SurveyResponse`, `SurveyTemplate`, `TimeEntry`, `TimeOffEntry`, `User`, `Vendor`, `Workspace`, `WorkspaceAllocation`, `WorkspaceGroup`, or `WorkspaceResource`.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the reference was last updated.\"}}},\"FixedFeeItem\":{\"title\":\"Fixed Fee Item\",\"type\":\"object\",\"properties\":{\"amount_in_cents\":{\"type\":\"integer\",\"format\":\"int32\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"currency\":{\"type\":\"string\"},\"notes\":{\"type\":\"string\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\"},\"taxable\":{\"type\":\"boolean\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\"}}},\"Geography\":{\"title\":\"Organization\",\"description\":\"An Organization allows you to structure and group your projects and account members by\\ndepartments and geographies.\",\"type\":\"object\",\"properties\":{\"ancestor_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"The ids of all ancestors of the organization.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"name\":{\"type\":\"string\",\"description\":\"The unique name of the organization.\"},\"parent_id\":{\"type\":\"string\",\"description\":\"The id of the parent organization.\"},\"type\":{\"type\":\"string\",\"description\":\"The type of the organization, either 'Geography' or 'Department'.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"Holiday\":{\"title\":\"Holiday\",\"description\":\"A holiday is a day (or range of days) representing company-wide time off. Holidays are associated with a calendar for scheduling purposes.\\\".\",\"type\":\"object\",\"properties\":{\"calendar_names_list\":{\"type\":\"string\",\"description\":\"A comma separated list of calendar names to which the holiday belongs.\\nOnly returned when requested through the optional_fields param.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the holiday ends.\"},\"holiday_calendar_association_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`holiday_calendar_association_ids` will only be included in the response if `holiday_calendar_associations` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the holiday.\"},\"paid\":{\"type\":\"boolean\",\"description\":\"Whether the holiday is paid.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the holiday begins.\"},\"total_hours\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of workweek hours that the holiday includes.\"}}},\"HolidayCalendar\":{\"title\":\"Holiday Calendar\",\"description\":\"A Holiday Calendar defines the days in which account members are unavailable to work due to company-wide days off.\",\"type\":\"object\",\"properties\":{\"default\":{\"type\":\"boolean\",\"description\":\"Whether the holiday calendar is the account default.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the holiday calendar.\"}}},\"HolidayCalendarAssociation\":{\"title\":\"Holiday Calendar Association\",\"description\":\"A Holiday Calendar Association represents the relationship between Holiday objects and Holiday Calendar objects.\\nA Holiday can be associated with several different Holiday Calendars.\\nTo associate a Holiday with a Holiday Calendar create a Holiday Calendar Assocation.\",\"type\":\"object\",\"properties\":{\"holiday_calendar_id\":{\"type\":\"string\",\"description\":\"`holiday_calendar_id` will only be included in the response if `holiday_calendar` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"holiday_calendar_name\":{\"type\":\"string\",\"description\":\"Returns the name of the associated Holiday Calendar.\"},\"holiday_id\":{\"type\":\"string\",\"description\":\"`holiday_id` will only be included in the response if `holiday` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"holiday_name\":{\"type\":\"string\",\"description\":\"Returns the name of the associated Holiday.\"}}},\"HolidayCalendarMembership\":{\"title\":\"Holiday Calendar Membership\",\"description\":\"A Holiday Calendar Membership represents a calendar which has been applied to a user.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the calendar stops applying.\"},\"holiday_calendar_id\":{\"type\":\"string\",\"description\":\"`holiday_calendar_id` will only be included in the response if `holiday_calendar` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"in_use\":{\"type\":\"boolean\",\"description\":\"Whether the calendar is currently active for the user.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"When the calendar begins to apply.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The user associated with the calendar.\"}}},\"InsightsAccessGroupMembership\":{\"title\":\"Insights Access Group Membership\",\"description\":\"[Insights Access Groups](https://mavenlink.zendesk.com/hc/en-us/articles/115002115073) allow you to manage classic Insights access for users. An Insights Access \\n        Group Membership represents the connection of a user to an Insights Access Group.\",\"type\":\"object\",\"properties\":{\"account_permission\":{\"type\":\"string\",\"description\":\"The account level permission of the associated user.\\nOnly returned when requested through the optional_fields param.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the user can create and edit custom classic Insights dashboards and reports. \\n\\n**Warning**: Users with `can_edit` permission have access to *all* account data via Insights.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"When the Insights Access Group Membership was created (i.e. when the user was added to the Insights Access Group).\"},\"insights_access_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated Insights Access Group.\"},\"insights_access_group_name\":{\"type\":\"string\",\"description\":\"The name of the associated Insights Access Group.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"When the Insights Access Group Membership was updated.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated user.\"},\"user_name\":{\"type\":\"string\",\"description\":\"The name of the associated user.\\nOnly returned when requested through the optional_fields param.\"}}},\"Invoice\":{\"title\":\"Invoice\",\"description\":\"An Invoice is defined as a list of costs incurred during a Kantata OX project, which are billable to an end user.\",\"type\":\"object\",\"properties\":{\"additional_item_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`additional_item_ids` will only be included in the response if `additional_items` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"balance_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The balance, in cents, of the invoice.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date the invoice was recorded in Kantata OX, in YY-MM-DD[T]HH:MM:SS-TIMEZONE format.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency being used for the invoice.\"},\"currency_base_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of the units in the `balance_in_cents` attribute that are required to make up a single unit of the `currency`.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"The symbol that represents the currency being used for the invoice.\"},\"draft\":{\"type\":\"boolean\",\"description\":\"Whether or not the invoice is a draft.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the invoice is due, in YYYY-MM-DD format.\"},\"expense_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`expense_ids` will only be included in the response if `expenses` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"fixed_fee_item_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`fixed_fee_item_ids` will only be included in the response if `fixed_fee_items` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"invoice_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the invoice was incurred, in YYYY-MM-DD format.\"},\"message\":{\"type\":\"string\",\"description\":\"Any notes added to the invoice.\"},\"payment_schedule\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of days within which the total amount of the invoice is expected to be paid. For example, use `30` for a Net 30 payment schedule. See https://en.wikipedia.org/wiki/Net_D.\"},\"project_code\":{\"type\":\"string\",\"description\":\"The invoice project code.\"},\"purchase_order\":{\"type\":\"string\",\"description\":\"The invoice purchase order.\"},\"recipient_id\":{\"type\":\"string\",\"description\":\"`recipient_id` will only be included in the response if `recipient` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"status\":{\"type\":\"string\",\"description\":\"The current status of the invoice ('new', 'cancelled', 'accepted payment').\"},\"tax_rate\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The tax rate percentage that is applied to the invoice total.\"},\"time_entry_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`time_entry_ids` will only be included in the response if `time_entries` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"title\":{\"type\":\"string\",\"description\":\"A string of the format (Draft )Invoice #<user-invoice-number>.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date the invoice was last updated, in YY-MM-DD[T]HH:MM:SS-TIMEZONE format.\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"user_invoice_number\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The invoice number.\"},\"user_invoice_title\":{\"type\":\"string\",\"description\":\"The title of the invoice.\"},\"workspace_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_ids` will only be included in the response if `workspaces` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"IpRestriction\":{\"title\":\"IP Restriction\",\"description\":\"Each IP Restriction represents the account permission levels that can access Kantata OX\\nfor a range of IP Addresses.\",\"type\":\"object\",\"properties\":{\"administrator\":{\"type\":\"boolean\",\"description\":\"Access allowed in this IpRestriction rule applies to users with an account role of administrator.\"},\"collaborator\":{\"type\":\"boolean\",\"description\":\"Access allowed in this IpRestriction rule applies to users with an account role of collaborator.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"ip_address_cidr\":{\"type\":\"string\",\"description\":\"Address range represented in Classless Inter-Domain Routing notation.\"},\"is_default\":{\"type\":\"boolean\",\"description\":\"Specifies if this record is the default whitelist that is created when IP Restrictions are enabled.\"},\"name\":{\"type\":\"string\",\"description\":\"User-defined display name for the whitelist range (e.g. Salt Lake Office).\"},\"project_creator\":{\"type\":\"boolean\",\"description\":\"Access allowed in this IpRestriction rule applies to users with an account role of project creator.\"},\"project_lead\":{\"type\":\"boolean\",\"description\":\"Access allowed in this IpRestriction rule applies to users with an account role of project lead.\"},\"punch_clock\":{\"type\":\"boolean\",\"description\":\"Access allowed in this IpRestriction rule applies to users with an account role of punch clock.\"},\"reports_viewer\":{\"type\":\"boolean\",\"description\":\"Access allowed in this IpRestriction rule applies to users with an account role of reports viewer.\"},\"reports_viewer_with_cost\":{\"type\":\"boolean\",\"description\":\"Access allowed in this IpRestriction rule applies to users with an account role of reports viewer with cost.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"LineItemLock\":{\"title\":\"Line Item Lock\",\"description\":\"LineItemLocks provide a way for you to lock time in the past so that previous time entries \\ncannot be edited or updated and new time entries cannot be created before the selected lock date.\\n\\nLine Items can be locked to any Saturday in the past on a per account basis.\\n\\nKeep in mind that this feature does not lock the ability to invoice approved time entries,\\nnor does it lock the submission or approval of expenses.\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The account for which line items will be locked.\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"locked_to\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date before which you would like line items to be locked.\"}}},\"MavenParticipation\":{\"title\":\"Participation\",\"description\":\"Participations in Kantata OX connect Users and Workspaces (projects). It includes\\npermissions, cost rate, bill rate and role details for the participant in the workspace.\",\"type\":\"object\",\"properties\":{\"access_level\":{\"type\":\"string\",\"description\":\"Access level for the user in the workspace. It must be one of \\\"admin\\\", \\\"financial\\\", \\\"time_logging\\\", \\\"collaboration\\\".\\nVisible when the API user is an administrator on the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"active_role_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`active_role_ids` will only be included in the response if `active_roles` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"allocated_workspace_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The allocated minutes for the participant scoped to this project.\\nVisible when the API user is a reports viewer on the project's account..\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the participant has edit permissions to the project.\\nVisible when the API user is an administrator on the project.\"},\"can_invite\":{\"type\":\"boolean\",\"description\":\"Whether the participant can invite others to the project.\"},\"can_post\":{\"type\":\"boolean\",\"description\":\"Whether the participant can post in the project.\\nVisible when the API user is an administrator on the project.\"},\"cost_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost (in cents) for the participant for this this project.\\nVisible when the API user is an administrator and a consultant on the project..\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"default_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default rate (in cents) for the participant for this project.\\nVisible when the API user is a consultant on the project and has financial access on the project.\"},\"estimated_workspace_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated minutes for the participant scoped to this project.\\nVisible when the API user is a reports viewer on the project's account..\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"is_team_lead\":{\"type\":\"boolean\",\"description\":\"Whether the participant is a team lead in the project.\"},\"primary_role_id\":{\"type\":\"string\",\"description\":\"`primary_role_id` will only be included in the response if `primary_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate (in cents) for the participant for this project.\\nVisible when the API user is a consultant on the project and has financial access on the project.\"},\"role\":{\"type\":\"string\",\"description\":\"The role for the participant.\"},\"show_as_read_only\":{\"type\":\"boolean\",\"description\":\"Whether the API user can only read the project.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_resource_ids` will only be included in the response if `workspace_resources` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_role_id\":{\"type\":\"string\",\"description\":\"`workspace_role_id` will only be included in the response if `workspace_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"Organization\":{\"title\":\"Organization\",\"description\":\"An Organization allows you to structure and group your projects and account members by\\ndepartments and geographies.\",\"type\":\"object\",\"properties\":{\"ancestor_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"The ids of all ancestors of the organization.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"name\":{\"type\":\"string\",\"description\":\"The unique name of the organization.\"},\"parent_id\":{\"type\":\"string\",\"description\":\"The id of the parent organization.\"},\"type\":{\"type\":\"string\",\"description\":\"The type of the organization, either 'Geography' or 'Department'.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"OrganizationMembership\":{\"title\":\"Organization Membership\",\"description\":\"An Organization Membership represents the connection of a user and project to an organization.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"department_id\":{\"type\":\"string\",\"description\":\"`department_id` will only be included in the response if `department` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"geography_id\":{\"type\":\"string\",\"description\":\"`geography_id` will only be included in the response if `geography` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"member_id\":{\"type\":\"string\",\"description\":\"The ID of the project or user.\"},\"member_type\":{\"type\":\"string\",\"description\":\"The type of object that describes the member (workspace or user).\"},\"primary\":{\"type\":\"boolean\",\"description\":\"Indicates whether this is the primary organization for the member (user or workspace).\\nVisible when the primary organization feature is enabled.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"Participation\":{\"title\":\"Participation\",\"description\":\"Participations in Kantata OX connect Users and Workspaces (projects). It includes\\npermissions, cost rate, bill rate and role details for the participant in the workspace.\",\"type\":\"object\",\"properties\":{\"access_level\":{\"type\":\"string\",\"description\":\"Access level for the user in the workspace. It must be one of \\\"admin\\\", \\\"financial\\\", \\\"time_logging\\\", \\\"collaboration\\\".\\nVisible when the API user is an administrator on the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"active_role_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`active_role_ids` will only be included in the response if `active_roles` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"allocated_workspace_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The allocated minutes for the participant scoped to this project.\\nVisible when the API user is a reports viewer on the project's account..\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the participant has edit permissions to the project.\\nVisible when the API user is an administrator on the project.\"},\"can_invite\":{\"type\":\"boolean\",\"description\":\"Whether the participant can invite others to the project.\"},\"can_post\":{\"type\":\"boolean\",\"description\":\"Whether the participant can post in the project.\\nVisible when the API user is an administrator on the project.\"},\"cost_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost (in cents) for the participant for this this project.\\nVisible when the API user is an administrator and a consultant on the project..\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"default_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default rate (in cents) for the participant for this project.\\nVisible when the API user is a consultant on the project and has financial access on the project.\"},\"estimated_workspace_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated minutes for the participant scoped to this project.\\nVisible when the API user is a reports viewer on the project's account..\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"is_team_lead\":{\"type\":\"boolean\",\"description\":\"Whether the participant is a team lead in the project.\"},\"primary_role_id\":{\"type\":\"string\",\"description\":\"`primary_role_id` will only be included in the response if `primary_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The rate (in cents) for the participant for this project.\\nVisible when the API user is a consultant on the project and has financial access on the project.\"},\"role\":{\"type\":\"string\",\"description\":\"The role for the participant.\"},\"show_as_read_only\":{\"type\":\"boolean\",\"description\":\"Whether the API user can only read the project.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_resource_ids` will only be included in the response if `workspace_resources` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_role_id\":{\"type\":\"string\",\"description\":\"`workspace_role_id` will only be included in the response if `workspace_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"Payment\":{\"title\":\"Payment\",\"type\":\"object\"},\"Post\":{\"title\":\"Post\",\"description\":\"A Post represents a message written by participants in a project that appears in the project.\",\"type\":\"object\",\"properties\":{\"attachment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`attachment_ids` will only be included in the response if `attachments` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"formatted_message\":{\"type\":\"string\",\"description\":\"Sanitized HTML representation of the message with links, user mentions and emoji images.\"},\"google_document_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`google_document_ids` will only be included in the response if `google_documents` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"has_attachments\":{\"type\":\"boolean\",\"description\":\"Whether the post contains any attachments.\"},\"message\":{\"type\":\"string\",\"description\":\"The message of the post.\"},\"newest_reply_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time of the most recent reply.\"},\"newest_reply_id\":{\"type\":\"string\",\"description\":\"`newest_reply_id` will only be included in the response if `newest_reply` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"newest_reply_user_id\":{\"type\":\"string\",\"description\":\"`newest_reply_user_id` will only be included in the response if `newest_reply_user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"parsed_message\":{\"type\":\"string\",\"description\":\"Based on the markdown preference, includes either the parsed markdown or the message.\"},\"private\":{\"type\":\"boolean\",\"description\":\"Whether the post is private.\"},\"recipient_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`recipient_ids` will only be included in the response if `recipients` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"reply\":{\"type\":\"boolean\",\"description\":\"Whether there are any replies to the post.\"},\"reply_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of replies to the post.\"},\"reply_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`reply_ids` will only be included in the response if `replies` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Whether the post is a reply, the internal ID of the parent post, or the object to which the reply is made.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_title\":{\"type\":\"string\",\"description\":\"The subject title for proof posts.\"},\"subject_type\":{\"type\":\"string\",\"description\":\"The class name of the object to which the reply is made.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"PrivateLabel\":{\"title\":\"Custom Branding (Private Label)\",\"description\":\"The Custom Branding values for the current users account.\",\"type\":\"object\",\"properties\":{\"business_name\":{\"type\":\"string\",\"description\":\"Business name alias.\"},\"button_color\":{\"type\":\"string\",\"description\":\"Hex value of chosen button color.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date the custom branding was created.\"},\"custom_login_message\":{\"type\":\"string\",\"description\":\"Value of the custom login message if set.\"},\"header_color\":{\"type\":\"string\",\"description\":\"Hex value of chosen header color.\"},\"left_nav_background_color\":{\"type\":\"string\",\"description\":\"Hex value of the chosen left navigation color.\"},\"left_nav_button_color\":{\"type\":\"string\",\"description\":\"Hex value of the left nav button.\"},\"link_color\":{\"type\":\"string\",\"description\":\"Hex value of chosen link color.\"},\"logo_url\":{\"type\":\"string\",\"description\":\"URL of the chosen logo.\"},\"state\":{\"type\":\"string\",\"description\":\"The current state of custom branding on the account with possible values: new and disabled, disabled, active, preview.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date the custom branding was most recently updated.\"}}},\"ProjectTemplate\":{\"title\":\"Project Template\",\"description\":\"Project Templates are sets of tasks and attributes that can be applied to new or existing projects.\\n      A single template can be used on any number of projects.\",\"type\":\"object\",\"properties\":{\"budget\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated overall budget of the project associated with the template.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the project template.\"},\"description\":{\"type\":\"string\",\"description\":\"A description of the project template (this does not map over to the project description when applied).\"},\"duration\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated number of days that the project will take to complete.\"},\"is_budgeted\":{\"type\":\"boolean\",\"description\":\"The project template has financial attributes including overall budget, task budgets, and task time estimates.\"},\"item_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of tasks in the project template.\"},\"permissions\":{\"type\":\"object\",\"properties\":{\"can_edit_project_template\":{\"type\":\"boolean\",\"description\":\"Whether the current user can edit the project template.\"}}},\"project_template_additional_tab_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`project_template_additional_tab_ids` will only be included in the response if `project_template_additional_tabs` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"project_template_assignment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`project_template_assignment_ids` will only be included in the response if `project_template_assignments` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"raw_json\":{\"type\":\"string\",\"description\":\"A json hash that contains all the project templates tasks.\\nOnly returned when requested through the optional_fields param.\"},\"shared\":{\"type\":\"boolean\",\"description\":\"(Deprecated in favor of sharing) The project template is shared with users on the account, other than the creator.\"},\"sharing\":{\"type\":\"string\",\"description\":\"The project template sharing settings. A template can be private, shared, or editable.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the project template.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"ProjectTemplateAdditionalTab\":{\"title\":\"Project Template Additional Tab\",\"description\":\"Project Template Additional Tabs are additional tabs configured in a project template that are added to a project when the template is applied.\",\"type\":\"object\",\"properties\":{\"associated_tab_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the form or Insights dynamic dashboard that is a project template additional tab.\"},\"project_template_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the template the additional tab is associated with.\"},\"tab_type\":{\"type\":\"string\",\"description\":\"The type of additional project tab. Possible values are `form` and `dashboard` (i.e. an Insights dynamic dashboard).\"}}},\"ProjectTemplateAssignment\":{\"title\":\"Project Template Assignment\",\"description\":\"Project Template Assignments represent placeholders for task assignees in project templates.\",\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of resource or assignment placeholder for the associated project template.\"},\"project_template_id\":{\"type\":\"string\",\"description\":\"`project_template_id` will only be included in the response if `project_template` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"role_initials\":{\"type\":\"string\",\"description\":\"Three letter initals for the Resource's Role if any.\\nOnly returned when requested through the optional_fields param.\"},\"role_name\":{\"type\":\"string\",\"description\":\"Name of the Resource's role if any.\\nOnly returned when requested through the optional_fields param.\"},\"total_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nOnly returned when requested through the optional_fields param.\"},\"total_estimated_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nOnly returned when requested through the optional_fields param.\"}}},\"Proof\":{\"title\":\"Proof\",\"description\":\"Proofs are assets, belonging to a task that has been uploaded for review. Although they can have\\nseveral revisions, proofs only have a single *current* revision.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_name\":{\"type\":\"string\",\"description\":\"The full name of the user who uploaded the current revision.\"},\"current_revision_id\":{\"type\":\"string\",\"description\":\"`current_revision_id` will only be included in the response if `current_revision` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"download_url\":{\"type\":\"string\",\"description\":\"The URL from which to download the attachment associated with the current revision of the proof.\"},\"filename\":{\"type\":\"string\",\"description\":\"The name of the file associated with the current revision.\"},\"filesize\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The file size of the attachment associated with the current revision.\"},\"has_comments\":{\"type\":\"boolean\",\"description\":\"Whether there are comments on the current revision in the proofing workspace.\"},\"review_status\":{\"type\":\"string\",\"description\":\"The status of the active proof review (if one exists).\"},\"review_url\":{\"type\":\"string\",\"description\":\"The URL from which to view the proof in the proofing workspace.\"},\"revision_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of revisions.\"},\"revision_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date that the current revision was created.\"},\"revision_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`revision_ids` will only be included in the response if `revisions` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"title\":{\"type\":\"string\"},\"viewable\":{\"type\":\"boolean\",\"description\":\"Whether the proof has finished processing and is ready to be viewed in the proofing workspace.\"}}},\"ProofReview\":{\"title\":\"Proof Review\",\"description\":\"Represents the review of a proof and its current status.\",\"type\":\"object\",\"properties\":{\"can_modify\":{\"type\":\"boolean\",\"description\":\"Whether the current user can modify the proof review.\"},\"participation_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`participation_ids` will only be included in the response if `participations` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"proof_revision_id\":{\"type\":\"string\",\"description\":\"`proof_revision_id` will only be included in the response if `proof_revision` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"status\":{\"type\":\"string\",\"description\":\"The current status of the proof review. This can be *In Progress*, *Approved*, or *Rejected*.\"}}},\"ProofReviewParticipation\":{\"title\":\"Proof Review Participation\",\"description\":\"Represent a users's involvement (participation) in the review of a proof.\",\"type\":\"object\",\"properties\":{\"project_review_id\":{\"type\":\"string\",\"description\":\"`project_review_id` will only be included in the response if `proof_review` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the participation. This can be 'waiting', 'rejected', or 'approved'.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user associated with the participation.\"}}},\"ProofRevision\":{\"title\":\"Proof Revision\",\"description\":\"A Proof Revision represents a specific version of a proof. The latest version that\\nmost operations are taken on is the \\\"current\\\" revision.\",\"type\":\"object\",\"properties\":{\"creator_name\":{\"type\":\"string\",\"description\":\"The full name of the user who created the revision.\"},\"current\":{\"type\":\"boolean\",\"description\":\"True if the revision is the current revision. This is the only revision of the proof that can be reviewed.\"},\"download_url\":{\"type\":\"string\",\"description\":\"The URL from which to download the attachment associated with the revision.\"},\"filesize\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The filesize of the attachment associated with the revision.\"},\"original_filename\":{\"type\":\"string\",\"description\":\"The filename of the attachment when the revision was created.\"},\"proof_id\":{\"type\":\"string\",\"description\":\"`proof_id` will only be included in the response if `proof` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"proof_review_id\":{\"type\":\"string\",\"description\":\"`proof_review_id` will only be included in the response if `proof_review` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"review_url\":{\"type\":\"string\",\"description\":\"The URL with which to view the revision in the proofing workspace.\"},\"revision_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date the revision was created.\"}}},\"RateCard\":{\"title\":\"Rate Card\",\"description\":\"A Rate Card belongs to a Rate Card Set, and represents a currency in the set. Rate Cards have\\nmany Rate Card Versions which represent the effective version of a Rate Card at a specified point of time.\\n\\nRate Cards are accessible to users with Financial access (Project Lead or higher) on the account.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the Rate Card.\"},\"effective_rate_card_version_id\":{\"type\":\"string\",\"description\":\"`effective_rate_card_version_id` will only be included in the response if `effective_rate_card_version` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_card_set_id\":{\"type\":\"string\",\"description\":\"`rate_card_set_id` will only be included in the response if `rate_card_set` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_card_set_title\":{\"type\":\"string\",\"description\":\"The Rate Card Set and Currency.\"},\"rate_card_version_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`rate_card_version_ids` will only be included in the response if `rate_card_versions` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"removable\":{\"type\":\"boolean\",\"description\":\"Whether or not the Rate Card can be deleted.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"uses\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total usage count of the Rate Card.\"}}},\"RateCardRole\":{\"title\":\"Rate Card Role\",\"description\":\"A Rate Card Role belongs to a Rate Card Version and represents the bill rate, in cents per hour, for a Role\\nFor example, the rate for a developer may be 2000 cents per hour.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The bill rate, in cents per hour, for the Rate Card Role.\"},\"rate_card_version_id\":{\"type\":\"string\",\"description\":\"`rate_card_version_id` will only be included in the response if `rate_card_version` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"RateCardSet\":{\"title\":\"Rate Card Set\",\"description\":\"A Rate Card Set represents a group of Rate Cards with multiple currencies, that\\ncan be bundled together. A Rate Card Set belongs to an account, and can have several Rate Card Set Versions, each representing the\\nthe effective version for a specified date.\",\"type\":\"object\",\"properties\":{\"account_default\":{\"type\":\"boolean\",\"description\":\"Whether the Rate Card Set is an account default.\"},\"active_currencies\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Includes only currencies that belong to published Rate Card Set Versions.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"default_currencies\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Includes only currencies that belong to published Rate Card Set Versions on the account default Rate Card Set.\"},\"destroyable\":{\"type\":\"boolean\",\"description\":\"Whether the Rate Card Set can be deleted.\"},\"rate_card_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`rate_card_ids` will only be included in the response if `rate_cards` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_card_set_version_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`rate_card_set_version_ids` will only be included in the response if `rate_card_set_versions` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the Rate Card Set.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"workspace_group_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_group_ids` will only be included in the response if `workspace_groups` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"RateCardSetVersion\":{\"title\":\"Rate Card Set Version\",\"description\":\"Rate Card Set Versions represent a snapshot of a Rate Card Set\\n  which takes effect on the set published date. A Rate Card Set Version owns a copy of each Rate Card Version\\n   of a Rate Card on the associated Rate Card Set.\\nRate Card Set Versions are only accessible, editable and publishable by Administrators on the account.\",\"type\":\"object\",\"properties\":{\"active\":{\"type\":\"boolean\",\"description\":\"Whether the Rate Card Set Version is published.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"effective_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date on which the Rate Card Set Version take effect.\"},\"rate_card_set_id\":{\"type\":\"string\",\"description\":\"`rate_card_set_id` will only be included in the response if `rate_card_set` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_card_version_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`rate_card_version_ids` will only be included in the response if `rate_card_versions` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"used_currencies\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Available currencies on Rate Cards associated with this Rate Card Set Version.\"}}},\"RateCardVersion\":{\"title\":\"Rate Card Version\",\"description\":\"A Rate Card Version represents a snapshot of a Rate Card at a specified point in time and is used to set the\\ndefault rate. It belongs to a Rate Card Set Version and can own many Rate Card Roles.\\n\\nThe default Rate is the Rate applied for any Roles that do not explicitly have a Rate set.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"default_rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The default Rate for any Role that does not explicitly have a Rate associated with it.\"},\"rate_card_id\":{\"type\":\"string\",\"description\":\"`rate_card_id` will only be included in the response if `rate_card` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_card_role_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`rate_card_role_ids` will only be included in the response if `rate_card_roles` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"rate_card_set_version_id\":{\"type\":\"string\",\"description\":\"`rate_card_set_version_id` will only be included in the response if `rate_card_set_version` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"Resolution\":{\"title\":\"Resolution\",\"description\":\"A resolution is a submission approval, rejection, or cancelation. This can be for an expense report \\nsubmission or a timesheet submission.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"description\":{\"type\":\"string\",\"description\":\"Additional resolution details.\"},\"target_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the associated submission.\"},\"target_type\":{\"type\":\"string\",\"description\":\"Whether the resolution is for a timesheet submission or an expense report submission.\"},\"type\":{\"type\":\"string\",\"description\":\"The resolution type, either approval, rejection, or cancellation.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the user who created the resolution.\"}}},\"Resource\":{\"title\":\"Resource\",\"type\":\"object\",\"properties\":{\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"label\":{\"type\":\"string\"},\"organization_membership_id\":{\"type\":\"string\",\"description\":\"`organization_membership_id` will only be included in the response if `organization_membership` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"ResourceRequest\":{\"title\":\"Resource Requests\",\"description\":\"Resource Requests are used as a method for a requestor to ask an approver to staff a resource.\\nResource Requests are associated to a workspace resource and must have an approver associated.\",\"type\":\"object\",\"properties\":{\"approver_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`approver_ids` will only be included in the response if `approvers` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"resource_id\":{\"type\":\"string\",\"description\":\"`resource_id` will only be included in the response if `resource` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"status\":{\"type\":\"string\",\"description\":\"The current state of the request: new, cancelled, rejected, or approved.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"Role\":{\"title\":\"Role\",\"description\":\"A Role represents the main position or title assigned to members on an account. Roles may be associated with account memberships, account invitations,\\nparticipation, project template assignments, rate card roles, rate card versions, resources, or time adjustments.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"deleted_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The time the role was deleted.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the role.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"Skill\":{\"title\":\"Skill\",\"description\":\"Skills are used in Kantata OX to describe capabilities of users for the purposes of resource planning.\\nThey can be associated with a user through a Skill Membership.\\nThis model includes categories such as 'Skill', 'Language', 'Certification' and 'Other'.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time a skill was last updated.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the skill.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"max_level\":{\"type\":\"string\",\"description\":\"The max level allowed for the skill.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the skill.\"},\"skill_category_id\":{\"type\":\"string\",\"description\":\"`skill_category_id` will only be included in the response if `skill_category` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time at skill a workweek was created.\"}}},\"SkillCategory\":{\"title\":\"Skill Category\",\"description\":\"The classification for a group of skills.\",\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"The name of the skill category.\"},\"skill_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`skill_ids` will only be included in the response if `skills` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"SkillMembership\":{\"title\":\"Skill Membership\",\"description\":\"A Skill Membership represents a skill that has been assigned to a specified user.\",\"type\":\"object\",\"properties\":{\"cached_skill_name\":{\"type\":\"string\",\"description\":\"The name of the skill.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The objects proficiency level for the skill (1-5).\"},\"max_level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The maximum level assigned for the skill.\"},\"skill_id\":{\"type\":\"string\",\"description\":\"`skill_id` will only be included in the response if `skill` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"StatusReport\":{\"title\":\"Status Report\",\"description\":\"A Status Report provides a color level and description for a projects status. Referred to as Health Report in the UI.\",\"type\":\"object\",\"properties\":{\"color\":{\"type\":\"string\",\"description\":\"The status color for for the report overall. One of green, yellow, red.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the overall status of the project.\"},\"details\":{\"type\":\"array\",\"description\":\"Optional color and description for various categories of a project's health.\",\"items\":{\"type\":\"object\",\"properties\":{\"category\":{\"type\":\"string\",\"description\":\"The category for which this detail applies. One of Scope, Budget, Schedule, Client.\"},\"color\":{\"type\":\"string\",\"description\":\"The status color for the specified category. One of green, yellow, red.\"},\"description\":{\"type\":\"string\",\"description\":\"A description of the status of the specified category.\"}}}},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"updater_id\":{\"type\":\"string\",\"description\":\"`updater_id` will only be included in the response if `updater` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"Story\":{\"title\":\"Story\",\"description\":\"Stories are [tasks](https://mavenlink.zendesk.com/hc/en-us/articles/202806550-Tasks-Overview).\",\"type\":\"object\",\"properties\":{\"ancestor_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"IDs of all parent tasks.\"},\"ancestry_depth\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of levels a subtask is nested below the top-level task.\"},\"archived\":{\"type\":\"boolean\"},\"archived_editable\":{\"type\":\"boolean\",\"description\":\"If set to `true`, the requester can edit the archived task.\\nOnly returned when requested through the optional_fields param.\"},\"assigned_role_id\":{\"type\":\"string\",\"description\":\"`assigned_role_id` will only be included in the response if `assigned_role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"assignee_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`assignee_ids` will only be included in the response if `assignees` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"assignment_timestamped_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"attachment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`attachment_ids` will only be included in the response if `attachments` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"billable\":{\"type\":\"boolean\"},\"budget_estimate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story budgets in the story's workspace.\"},\"budget_used_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story budgets in the story's workspace.\"},\"can_align_time\":{\"type\":\"boolean\",\"description\":\"If set to `true`, the account the task belongs to allows time to be aligned.\\nOnly returned when requested through the optional_fields param.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"If set to `true`, the requester can edit the task.\\nOnly returned when requested through the optional_fields param.\"},\"can_post\":{\"type\":\"boolean\",\"description\":\"If set to `true`, the requester can post in the project that the task belongs to.\\nOnly returned when requested through the optional_fields param.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"current_assignment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`current_assignment_ids` will only be included in the response if `current_assignments` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_value_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`custom_field_value_ids` will only be included in the response if `custom_field_values` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"deleted_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"descendant_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`descendant_ids` will only be included in the response if `descendants` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"description\":{\"type\":\"string\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"fixed_fee\":{\"type\":\"boolean\"},\"follower_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`follower_ids` will only be included in the response if `followers` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"formatted_description\":{\"type\":\"string\",\"description\":\"The task description with special formatting, like emoji and @-mentions.\\nOnly returned when requested through the optional_fields param.\"},\"google_document_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`google_document_ids` will only be included in the response if `google_documents` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"has_out_of_bounds_sads\":{\"type\":\"boolean\",\"description\":\"If set to `true`, the task has Daily Scheduled Hours (or Story Allocation Days) before its start date or after its due date.\\nOnly returned when requested through the optional_fields param.\"},\"has_proofing_access\":{\"type\":\"boolean\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nWhether or not the account the task belongs to has the proofing feature.\"},\"invoiced_balance_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story budgets in the story's workspace.\"},\"is_time_trackable_type\":{\"type\":\"boolean\",\"description\":\"If set to `true`, the task is a type of task that can have time tracked against it.\\nOnly returned when requested through the optional_fields param.\"},\"logged_billable_time_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story time estimates in the story's workspace.\"},\"logged_nonbillable_time_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story time estimates in the story's workspace.\"},\"parent_id\":{\"type\":\"string\",\"description\":\"`parent_id` will only be included in the response if `parent` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"parsed_description\":{\"type\":\"string\",\"description\":\"The task description with rendered markdown.\\nOnly returned when requested through the optional_fields param.\"},\"percentage_complete\":{\"type\":\"integer\",\"format\":\"int32\"},\"position\":{\"type\":\"integer\",\"format\":\"int32\"},\"potential_workspace_resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`potential_workspace_resource_ids` will only be included in the response if `potential_workspace_resources` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"potential_workspace_resources_with_unnamed_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`potential_workspace_resources_with_unnamed_ids` will only be included in the response if `potential_workspace_resources_with_unnamed` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"priority\":{\"type\":\"integer\",\"format\":\"int32\"},\"project_plan\":{\"type\":\"boolean\",\"description\":\"Whether the story is a project task (`true`) or is a To Do (`false`).\"},\"proof_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`proof_ids` will only be included in the response if `proofs` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"read_only\":{\"type\":\"boolean\",\"description\":\"If set to `true`, the requester can see the task, but cannot edit it.\\nOnly returned when requested through the optional_fields param.\"},\"render_description_markdown\":{\"type\":\"boolean\",\"description\":\"If set to `true`, the account the task belongs to is configured to render markdown in task descriptions.\\nOnly returned when requested through the optional_fields param.\"},\"reply_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`reply_ids` will only be included in the response if `replies` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"root_id\":{\"type\":\"string\",\"description\":\"`root_id` will only be included in the response if `root` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"source_dependency_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`source_dependency_ids` will only be included in the response if `source_dependencies` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\"},\"state\":{\"type\":\"string\"},\"story_state_change_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`story_state_change_ids` will only be included in the response if `story_state_changes` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_task_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`story_task_ids` will only be included in the response if `story_tasks` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_type\":{\"type\":\"string\"},\"sub_stories_billable_time_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story time estimates in the story's workspace.\"},\"sub_stories_budget_estimate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story budgets in the story's workspace.\"},\"sub_stories_budget_used_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story budgets in the story's workspace.\"},\"sub_stories_time_estimate_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story time estimates in the story's workspace.\"},\"sub_story_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of subtasks.\"},\"sub_story_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`sub_story_ids` will only be included in the response if `sub_stories` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subtree_depth\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of parent tasks.\"},\"tag_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`tag_ids` will only be included in the response if `tags` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"target_dependency_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`target_dependency_ids` will only be included in the response if `target_dependencies` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"time_estimate_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story time estimates in the story's workspace.\"},\"time_trackable\":{\"type\":\"boolean\",\"description\":\"If set to `true`, time can be tracked against the task.\"},\"title\":{\"type\":\"string\"},\"uninvoiced_balance_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story budgets in the story's workspace.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"weight\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view story time estimates in the story's workspace.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_resource_ids` will only be included in the response if `workspace_resources` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_resources_with_unnamed_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_resources_with_unnamed_ids` will only be included in the response if `workspace_resources_with_unnamed` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"StoryAllocationDay\":{\"title\":\"Daily Scheduled Hours (Story Allocation Day)\",\"description\":\"Daily Scheduled Hours (Story Allocation Day) is the planned amount of time for a project resource\\non a specific task for a specified day. Daily Scheduled Hours in Kantata OX are owned by an Assignment.\",\"type\":\"object\",\"properties\":{\"assignment_id\":{\"type\":\"string\",\"description\":\"`assignment_id` will only be included in the response if `assignment` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"current\":{\"type\":\"boolean\",\"description\":\"Whether or not the Story Allocation Day's Assignment is active.\"},\"date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date of the Story Allocation Day.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of minutes allocated for the Story Allocation Day.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"StoryDependency\":{\"title\":\"Story Dependency\",\"description\":\"Story dependencies define relationships between tasks and the sequence in which they must be completed in order to close a project. A dependency is between two tasks (stories) in a project (workspace), with one being the predecessor (source) task, and the other the successor (target) task. To learn more about dependencies, see our [Gantt Chart Dependencies article](https://mavenlink.zendesk.com/hc/en-us/articles/360000456874-Gantt-Chart-Dependencies).\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"dependency_type\":{\"type\":\"string\",\"description\":\"The type of the dependency.\\n- `0`: Start to Start (SS)—The predecessor begins before the successor can begin.\\n- `1`: Start to Finish (SF)—The predecessor begins before the successor can end.\\n- `2`: Finish to Start (FS)—The predecessor ends before the successor can begin.\\n- `3`: Finish to Finish (FF)—The predecessor ends before the successor can end.\"},\"lag\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The days between the predecessor task ending and the successor task beginning.\"},\"source_id\":{\"type\":\"string\",\"description\":\"`source_id` will only be included in the response if `source` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"target_id\":{\"type\":\"string\",\"description\":\"`target_id` will only be included in the response if `target` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"}}},\"StoryFollow\":{\"title\":\"Story Follow (Follower)\",\"description\":\"Story Follow allows a user to follow a task to which they are not assigned.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the story follow was created.\"},\"follower_id\":{\"type\":\"string\",\"description\":\"`follower_id` will only be included in the response if `follower` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the story follow was last updated.\"}}},\"StoryStateChange\":{\"title\":\"Story State Change\",\"description\":\"A Story State Changes in Kantata OX acts as an audit trail for a change to the state of a Story.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"formatted_state\":{\"type\":\"string\",\"description\":\"The formatted version of the new state of the story.\"},\"state\":{\"type\":\"string\",\"description\":\"The new state of the story (state can differ based on the story type).\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"StoryTask\":{\"title\":\"Story Task\",\"description\":\"A Story Task is a checklist item within a Story.\",\"type\":\"object\",\"properties\":{\"completed\":{\"type\":\"boolean\",\"description\":\"Represents the completion of the Story Task.\"},\"completed_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The time the Story Task was completed.\"},\"completed_by_id\":{\"type\":\"string\",\"description\":\"`completed_by_id` will only be included in the response if `completed_by` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The time the Story Task was created.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the Story Task.\"},\"position\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Represents the order of the Story Task in the list.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The time the Story Task was last updated.\"}}},\"Submission\":{\"title\":\"Submission\",\"description\":\"Submissions contain a set of Time Entries for a specific week or Expenses for a specified time period.\\nSubmission Time Entries and Expenses must be approved before they can be added to an invoice.\",\"type\":\"object\",\"properties\":{\"comment\":{\"type\":\"string\",\"description\":\"Additional comments on the submission.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the submission was created.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the submission.\"},\"currency_base_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The base unit of the submission's currency.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"The symbol of the submission's currency.\"},\"current_resolution_created_at_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the submission's current resolution was created.\"},\"current_resolution_creator_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The creator id on the submission's current resolution.\"},\"current_resolution_description\":{\"type\":\"string\",\"description\":\"The description on the submission's current resolution.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"line_item_total_formatted\":{\"type\":\"string\",\"description\":\"A formatted total of the line items (time entries or expenses) on the submission.\"},\"line_item_total_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"A total in cents of the line items (time entries or expenses) on the submission.\"},\"permissions\":{\"type\":\"object\",\"properties\":{\"can_cancel_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user cancel the submission.\"},\"can_approve_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user approve the submission.\"},\"can_reject_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user reject the submission.\"},\"can_resubmit_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user resubmit the submission.\"}}},\"resolution_description\":{\"type\":\"string\",\"description\":\"The description on the submission's current resolution.\"},\"status\":{\"type\":\"string\",\"description\":\"The current status of the submission ('approved', 'rejected', 'cancelled', 'pending').\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the submission.\"},\"type\":{\"type\":\"string\",\"description\":\"Either an ExpenseReportSubmission or a TimesheetSubmission.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the submission was last updated.\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"SubmissionApproval\":{\"title\":\"Resolution\",\"description\":\"A resolution is a submission approval, rejection, or cancelation. This can be for an expense report \\nsubmission or a timesheet submission.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"description\":{\"type\":\"string\",\"description\":\"Additional resolution details.\"},\"target_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the associated submission.\"},\"target_type\":{\"type\":\"string\",\"description\":\"Whether the resolution is for a timesheet submission or an expense report submission.\"},\"type\":{\"type\":\"string\",\"description\":\"The resolution type, either approval, rejection, or cancellation.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the user who created the resolution.\"}}},\"SubmissionCancellation\":{\"title\":\"Resolution\",\"description\":\"A resolution is a submission approval, rejection, or cancelation. This can be for an expense report \\nsubmission or a timesheet submission.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"description\":{\"type\":\"string\",\"description\":\"Additional resolution details.\"},\"target_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the associated submission.\"},\"target_type\":{\"type\":\"string\",\"description\":\"Whether the resolution is for a timesheet submission or an expense report submission.\"},\"type\":{\"type\":\"string\",\"description\":\"The resolution type, either approval, rejection, or cancellation.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the user who created the resolution.\"}}},\"SubmissionRejection\":{\"title\":\"Resolution\",\"description\":\"A resolution is a submission approval, rejection, or cancelation. This can be for an expense report \\nsubmission or a timesheet submission.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"description\":{\"type\":\"string\",\"description\":\"Additional resolution details.\"},\"target_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the associated submission.\"},\"target_type\":{\"type\":\"string\",\"description\":\"Whether the resolution is for a timesheet submission or an expense report submission.\"},\"type\":{\"type\":\"string\",\"description\":\"The resolution type, either approval, rejection, or cancellation.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The id of the user who created the resolution.\"}}},\"SurveyAnswer\":{\"title\":\"Survey Answer\",\"description\":\"Survey Answers (Legacy) represent a user's answer to a survey question on a survey response.\\nThis feature requires the Legacy Surveys account add-on. This feature is unrelated to Pulse surveys.\",\"type\":\"object\",\"properties\":{\"choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`choice_ids` will only be included in the response if `choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the survey answer was created.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"survey_question_id\":{\"type\":\"string\",\"description\":\"`survey_question_id` will only be included in the response if `survey_question` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"survey_response_id\":{\"type\":\"string\",\"description\":\"`survey_response_id` will only be included in the response if `survey_response` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"text\":{\"type\":\"string\",\"description\":\"The text answer to the question.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the survey answer was last updated.\"}}},\"SurveyQuestion\":{\"title\":\"Survey Question\",\"description\":\"Survey Questions (Legacy) appear on and can be responded to through surveys.\\nThis feature requires the Legacy Surveys account add-on. This feature is unrelated to Pulse surveys.\",\"type\":\"object\",\"properties\":{\"choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`choice_ids` will only be included in the response if `choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the survey question was created.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"question_type\":{\"type\":\"string\",\"description\":\"The type of the question. Valid values: single, multi, date, string, integer, decimal.\"},\"text\":{\"type\":\"string\",\"description\":\"The text of the question asked.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the survey question was last updated.\"}}},\"SurveyResponse\":{\"title\":\"Survey Response\",\"description\":\"Survey Response (Legacy) represents an instance of a particular survey that has been assigned for response.\\nThis feature requires the Legacy Surveys account add-on. This feature is unrelated to Pulse surveys.\",\"type\":\"object\",\"properties\":{\"close_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The close date for this survey.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the survey response was created.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the survey.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The due date for this survey.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"open_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The open date for this survey.\"},\"owner_id\":{\"type\":\"string\",\"description\":\"`owner_id` will only be included in the response if `owner` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"respondent_id\":{\"type\":\"string\",\"description\":\"`respondent_id` will only be included in the response if `respondent` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the survey response.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"survey_answer_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`survey_answer_ids` will only be included in the response if `survey_answers` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"survey_template_id\":{\"type\":\"string\",\"description\":\"`survey_template_id` will only be included in the response if `survey_template` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the survey.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the survey response was last updated.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"SurveyTemplate\":{\"title\":\"Survey Template\",\"description\":\"Survey Templates (Legacy) define a set a questions for which survey responses can be created from.\\nThis feature requires the Legacy Surveys account add-on. This feature is unrelated to Pulse surveys.\",\"type\":\"object\",\"properties\":{\"close_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The close date to be used for surveys based on this template.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the survey template was created.\"},\"description\":{\"type\":\"string\",\"description\":\"Description of the survey.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The due date to be used for surveys based on this template.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"open_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The open date to be used for surveys based on this template.\"},\"owner_id\":{\"type\":\"string\",\"description\":\"`owner_id` will only be included in the response if `owner` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"respondent_id\":{\"type\":\"string\",\"description\":\"`respondent_id` will only be included in the response if `respondent` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"survey_question_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`survey_question_ids` will only be included in the response if `survey_questions` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"survey_response_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`survey_response_ids` will only be included in the response if `survey_responses` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the survey.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the survey template was last updated.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"TimeEntry\":{\"title\":\"Time Entry\",\"description\":\"This object allows you to manage Kantata OX time entries, depending on your permissions.\\nCreating and updating time entries allows you to include time when invoicing clients.\",\"type\":\"object\",\"properties\":{\"active_submission_id\":{\"type\":\"string\",\"description\":\"`active_submission_id` will only be included in the response if `active_submission` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"approved\":{\"type\":\"boolean\",\"description\":\"Specifies whether the time entry has been approved.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"Whether the work for the time entry is billable.\"},\"cost_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Cost to perform the work in time entry's currency per hour.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the time entry was created, but not necessarily when the work was performed.\\n        The work can be performed at a different time.\"},\"currency\":{\"type\":\"string\",\"description\":\"Currency of the project when the time entry was made.\"},\"currency_base_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of subunits to make a regular unit of time entries currency.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"Symbol for the currency of the time entry.\"},\"date_performed\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"Date the time entry work was performed by the specified user.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"invoice_id\":{\"type\":\"string\",\"description\":\"`invoice_id` will only be included in the response if `invoice` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"is_invoiced\":{\"type\":\"boolean\",\"description\":\"Specifies whether the time entry has been invoiced.\"},\"location\":{\"type\":\"string\",\"description\":\"The location of the time entry.\\nVisible when the account has locations.\"},\"location_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The location id of the time entry.\\nVisible when the account has locations.\\n\\nOnly returned when requested through the optional_fields param.\"},\"notes\":{\"type\":\"string\",\"description\":\"Notes about the time entries work.\"},\"rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Billable rate for the work in time entry currency's cents per hour.\"},\"recent_submission_id\":{\"type\":\"string\",\"description\":\"`recent_submission_id` will only be included in the response if `recent_submission` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"taxable\":{\"type\":\"boolean\",\"description\":\"Specifies whether the time entry is taxable.\"},\"time_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Amount of work that was performed in minutes.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"Date the time entry was last updated.\"},\"user_can_edit\":{\"type\":\"boolean\",\"description\":\"Returns true if the requesting user can edit the time entry.\\nOnly returned when requested through the optional_fields param.\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"TimeOffEntry\":{\"title\":\"Time Off Entry\",\"description\":\"A Time Off Entry represents the number of hours a specific user has scheduled off for a requested date.\",\"type\":\"object\",\"properties\":{\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The number of hours of time off for the requested date.\"},\"requested_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date for which time off is requested.\"},\"submission_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date on which the time off was submitted.\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"TimesheetSubmission\":{\"title\":\"Timesheet Submission\",\"description\":\"Timesheet Submissions contain a set of Time Entries for a specific week. These Time Entries must be\\napproved through a Timesheet Submission before creating an invoice.\",\"type\":\"object\",\"properties\":{\"comment\":{\"type\":\"string\",\"description\":\"Additional comments on the submission.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the submission.\"},\"currency_base_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The base unit of the submission's currency.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"The symbol of the submission's currency.\"},\"current_resolution_created_at_date\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time that the submission's current resolution was created.\"},\"current_resolution_creator_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The creator id on the submission's current resolution.\"},\"current_resolution_description\":{\"type\":\"string\",\"description\":\"The description on the submission's current resolution.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The last day of the week.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"line_item_total_formatted\":{\"type\":\"string\",\"description\":\"A formatted total of the line items (time entries or expenses) on the submission.\"},\"line_item_total_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"A total in cents of the line items (time entries or expenses) on the submission.\"},\"permissions\":{\"type\":\"object\",\"properties\":{\"can_cancel_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user cancel the submission.\"},\"can_approve_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user approve the submission.\"},\"can_reject_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user reject the submission.\"},\"can_resubmit_submission\":{\"type\":\"boolean\",\"description\":\"Can the current user resubmit the submission.\"}}},\"resolution_description\":{\"type\":\"string\",\"description\":\"The description on the submission's current resolution.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The first day of the week.\"},\"status\":{\"type\":\"string\",\"description\":\"The current status of the submission ('approved', 'rejected', 'cancelled', 'pending').\"},\"time_entry_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`time_entry_ids` will only be included in the response if `time_entries` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the submission.\"},\"type\":{\"type\":\"string\",\"description\":\"Either an ExpenseReportSubmission or a TimesheetSubmission.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"User\":{\"title\":\"User\",\"description\":\"Users represent the individuals that are participating in Kantata OX projects. User objects are often returned as\\nnested JSON objects within other returned items such as Posts or Stories.\",\"type\":\"object\",\"properties\":{\"abbreviated_timezone\":{\"type\":\"string\",\"description\":\"The abbreviation for the user's time zone.\\nOnly returned when requested through the optional_fields param.\"},\"account_membership_id\":{\"type\":\"string\",\"description\":\"`account_membership_id` will only be included in the response if `account_membership` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"bio\":{\"type\":\"string\",\"description\":\"A biography (defined by the user).\\nOnly returned when requested through the optional_fields param.\"},\"city\":{\"type\":\"string\",\"description\":\"The home city of the user (based on their profile).\\nOnly returned when requested through the optional_fields param.\"},\"classification\":{\"type\":\"string\",\"description\":\"Indicates whether a user is Internal or External.\\nOnly returned when requested through the optional_fields param.\"},\"country\":{\"type\":\"string\",\"description\":\"The home country of the user (based on their profile).\\nOnly returned when requested through the optional_fields param.\"},\"custom_field_value_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`custom_field_value_ids` will only be included in the response if `custom_field_values` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"email_address\":{\"type\":\"string\",\"description\":\"The email address of the user.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"full_name\":{\"type\":\"string\",\"description\":\"The full name of the user.\"},\"headline\":{\"type\":\"string\",\"description\":\"A short description of the user.\"},\"last_site_activity\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The last time a user logged in. This field is only available in conjunction with the `on_my_account` filter option. Only visible when the API user is an Account Administrator.\\nOnly returned when requested through the optional_fields param.\"},\"manager_id\":{\"type\":\"string\",\"description\":\"`manager_id` will only be included in the response if `manager` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"photo_path\":{\"type\":\"string\",\"description\":\"The URL of the user's profile photo.\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"skill_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`skill_ids` will only be included in the response if `skills` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"skill_membership_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`skill_membership_ids` will only be included in the response if `skill_memberships` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"state\":{\"type\":\"string\",\"description\":\"The home state of the user (based on their profile).\\nOnly returned when requested through the optional_fields param.\"},\"website\":{\"type\":\"string\",\"description\":\"A website (defined by the user).\\nOnly returned when requested through the optional_fields param.\"},\"work_sample_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`work_sample_ids` will only be included in the response if `work_samples` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"UserFileAssociation\":{\"title\":\"User File Association\",\"description\":\"User File Associations act as a join object between a user, project, and\\nan attachment (or Google document).\",\"type\":\"object\",\"properties\":{\"asset_object_ref\":{\"type\":\"object\",\"description\":\"`asset_object_ref` will only be included in the response if `asset_object` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"post_id\":{\"type\":\"string\",\"description\":\"`post_id` will only be included in the response if `post` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"UserWorkspaceGroup\":{\"title\":\"User Group Membership\",\"description\":\"A User Group Membership represents the connection of a user to a [Workspace Group](/tag/Workspace-Groups).\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"When the user was assigned to the Workspace Group.\"},\"creator_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user that assigned the associated user to the Workspace Group.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user that is assigned to the Workspace Group.\"},\"workspace_group_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Workspace Group the user is assigned to.\"}}},\"Vendor\":{\"title\":\"Vendor\",\"description\":\"A Vendor is an entity to which an expense can be paid.\",\"type\":\"object\",\"properties\":{\"archived\":{\"type\":\"boolean\",\"description\":\"Whether the vendor is archived.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"externally_managed\":{\"type\":\"boolean\",\"description\":\"Whether the vendor was created by an external system and then imported.\"},\"in_use\":{\"type\":\"boolean\",\"description\":\"Whether the vendor is used on an invoice.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the vendor.\"}}},\"WorkSample\":{\"title\":\"Work Sample\",\"type\":\"object\",\"properties\":{\"attachment_filename\":{\"type\":\"string\"},\"attachment_id\":{\"type\":\"string\"},\"description\":{\"type\":\"string\"},\"title\":{\"type\":\"string\"},\"trapped_website_url\":{\"type\":\"string\",\"description\":\"Redirected version of a work sample url.\"},\"website_url\":{\"type\":\"string\"}}},\"Workspace\":{\"title\":\"Workspace\",\"description\":\"Workspaces (also called projects) represent the space in which Kantata OX users plan, communicate, and collaborate.\",\"type\":\"object\",\"properties\":{\"access_level\":{\"type\":\"string\",\"description\":\"Whether the project is open, and who can join it. Possible values are `invitation`, `open`, and `admin`.\"},\"account_color_id\":{\"type\":\"string\",\"description\":\"`account_color_id` will only be included in the response if `account_color` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account which the project is in.\"},\"account_insights_mapping_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`account_insights_mapping_ids` will only be included in the response if `account_insights_mappings` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"actual_fees_includes_additional_line_items\":{\"type\":\"boolean\",\"description\":\"Whether invoice additional items are included in actual fees calculations for the project.\\nVisible when the authenticated user is a project administrator and is on the account that the project is on.\"},\"actual_fees_includes_expenses\":{\"type\":\"boolean\",\"description\":\"Whether expenses are included in actual fees calculations for the project.\\nVisible when the authenticated user is a project administrator and is on the account that the project is on.\"},\"approver_id\":{\"type\":\"string\",\"description\":\"`approver_id` will only be included in the response if `approver` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"approver_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`approver_ids` will only be included in the response if `approvers` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"archived\":{\"type\":\"boolean\",\"description\":\"Whether the project is archived.\"},\"billable_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total amount of billable time entries, in minutes. Only visible if the authenticated user has financial access in the project and is on the provider team.\\nVisible when the authenticated user can see total time approved in the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"budget_remaining\":{\"type\":\"string\",\"description\":\"The amount of the project budget remaining.\\nVisible when the authenticated user is on the provider team and can either see reports on the account or has financial access in the project.\"},\"budget_used\":{\"type\":\"string\",\"description\":\"The amount of the project budget that has been used.\\nVisible when the authenticated user is on the provider team and can either see reports on the account or has financial access in the project.\"},\"budget_used_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The amount of the project budget that has been used, in the subunits of the currency (e.g. cents for USD).\\nVisible when the authenticated user is on the provider team and can either see reports on the account or has financial access in the project.\"},\"budgeted\":{\"type\":\"boolean\",\"description\":\"Whether the project is budgeted.\"},\"can_create_line_items\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user can create line items in the project (i.e. time entries, expenses, fixed fee items, or additional items).\"},\"can_invite\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user can invite others to the project.\"},\"change_orders_enabled\":{\"type\":\"boolean\",\"description\":\"Whether change orders are enabled in the project.\"},\"client_lead_name\":{\"type\":\"string\",\"description\":\"The name of the team lead for the client side of the project.\\nOnly returned when requested through the optional_fields param.\"},\"client_role_name\":{\"type\":\"string\",\"description\":\"The client team name.\"},\"consultant_role_name\":{\"type\":\"string\",\"description\":\"The provider team name.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date the project was created.\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the project. Only visible if the authenticated user has financial access in the project.\"},\"currency_base_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The base unit of the currency of the project. For example, the base unit for USD is 100.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"The [ISO symbol](https://knowledge.kantata.com/hc/en-us/articles/360041576473) for the currency of the project. For example, `USD`.\"},\"current_status_report_id\":{\"type\":\"string\",\"description\":\"`current_status_report_id` will only be included in the response if `current_status_report` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"current_user_participation_id\":{\"type\":\"string\",\"description\":\"`current_user_participation_id` will only be included in the response if `current_user_participation` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_value_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`custom_field_value_ids` will only be included in the response if `custom_field_values` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"default_rate\":{\"type\":\"string\",\"description\":\"The default billing rate for the project.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the project.\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The due date of the project.\"},\"effective_due_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The due date of the project (deprecated).\"},\"estimated_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total task estimated minutes of the project.\\nVisible when the authenticated user can see reports on the account or has financial access in the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"exclude_archived_stories_percent_complete\":{\"type\":\"boolean\",\"description\":\"Whether archived tasks are excluded from the calculation of the project completion percentage.\"},\"expenses_in_burn_rate\":{\"type\":\"boolean\",\"description\":\"Whether both expenses and invoice additional items are included in the actual fees calculation for the project. This field is the `AND` of `actual_fees_includes_expenses` and `actual_fees_includes_additional_line_items`.\\nVisible when the authenticated user is a project administrator and is on the account that the project is on.\"},\"external_link\":{\"type\":\"object\",\"description\":\"A link that displays within the project workspace. Requires the Project Button facilitated feature.\\nVisible when the workspace has the project button feature enabled.\",\"properties\":{\"url\":{\"type\":\"string\",\"description\":\"The URL of the link.\\nVisible when the workspace has the project button feature enabled.\"},\"text\":{\"type\":\"string\",\"description\":\"The button text.\\nVisible when the workspace has the project button feature enabled.\"}}},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"financial_viewer_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`financial_viewer_ids` will only be included in the response if `financial_viewers` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"has_active_expense_report_submissions\":{\"type\":\"boolean\",\"description\":\"Whether the project has active expense report submissions.\"},\"has_active_timesheet_submissions\":{\"type\":\"boolean\",\"description\":\"Whether the project has active timesheet submissions.\"},\"has_budget_access\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user has budget access in the project.\"},\"incoming_email_address\":{\"type\":\"string\",\"description\":\"The email address for the project—unique to the authenticated user—which can be used to post to the project's Activity Feed via email.\\nVisible when the authenticated user is a project administrator and is on the account that the project is on.\\n\\nOnly returned when requested through the optional_fields param.\"},\"lock_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The line item lock date for the account the project is on, if any.\\nOnly returned when requested through the optional_fields param.\"},\"minutes_logged\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total minutes logged on the project, including time adjustments. Only visible if the authenticated user has financial access in the project and is on the provider team.\\nVisible when the authenticated user can see total time approved in the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"next_uncompleted_milestone_id\":{\"type\":\"string\",\"description\":\"`next_uncompleted_milestone_id` will only be included in the response if `next_uncompleted_milestone` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"non_billable_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total of all non-billable time entries in minutes, only included if the current user has financial access and is a maven in the project.\\nVisible when the authenticated user can see total time approved in the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"over_budget\":{\"type\":\"boolean\",\"description\":\"Whether the project is over budget. Only visible if the authenticated user has financial access in the project.\\nVisible when the authenticated user is a project administrator and is on the account that the project is on.\"},\"participant_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`participant_ids` will only be included in the response if `participants` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"participation_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`participation_ids` will only be included in the response if `participations` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"percent_of_budget_used\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The percent of the project budget used.\\nVisible when the authenticated user is on the provider team and can either see reports on the account or has financial access in the project.\"},\"percentage_complete\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The completion percentage of the project, calculated from the completion percentage of the stories (tasks), including archived stories.\"},\"permissions\":{\"type\":\"object\",\"description\":\"Various project permissions for the authenticated user.\",\"properties\":{\"can_upload_files\":{\"type\":\"boolean\",\"description\":\"WWhether the authenticated user can upload files to the project.\"},\"can_private_message\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user can send private messages in the project.\"},\"can_join\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user can join the project.\"},\"is_participant\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user is participating in the project.\"},\"access_level\":{\"type\":\"string\",\"description\":\"The authenticated user’s permission level in the project.\"},\"team_lead\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user is a team lead in the project.\"},\"user_is_client\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user is a client in the project.\"},\"can_change_price\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user can change the price (budget) of the project.\"},\"can_change_story_billable\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user can change the billable status of stories (tasks) in the project.\"},\"can_post\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user has post permissions in the project.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user has edit permissions in the project.\"},\"restricted\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user is a restricted user in the project.\"},\"can_see_financials\":{\"type\":\"boolean\",\"description\":\"Whether the authenticated user has financial access in the project.\"},\"is_guest_on_project\":{\"type\":\"boolean\",\"description\":\"Returns true if the authenticated user can view projects without joining. Otherwise, returns false.\"}}},\"possible_approver_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`possible_approver_ids` will only be included in the response if `possible_approvers` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"posts_require_privacy_decision\":{\"type\":\"boolean\",\"description\":\"Whether posts are private (`true`) or shared with all project participants (`false`) by default.\"},\"price\":{\"type\":\"string\",\"description\":\"The project budget.\\nVisible when the authenticated user can see reports on the account or has financial access in the project.\"},\"price_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The project budget, in the subunits of the currency (e.g. cents for USD).\\nVisible when the authenticated user can see reports on the account or has financial access in the project.\"},\"primary_counterpart_id\":{\"type\":\"string\",\"description\":\"`primary_counterpart_id` will only be included in the response if `primary_counterpart` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"primary_maven_id\":{\"type\":\"string\",\"description\":\"`primary_maven_id` will only be included in the response if `primary_maven` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"primary_workspace_group_id\":{\"type\":\"string\",\"description\":\"`primary_workspace_group_id` will only be included in the response if `primary_workspace_group` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"provider_lead_name\":{\"type\":\"string\",\"description\":\"The name of the team lead for the provider side of the project.\\nOnly returned when requested through the optional_fields param.\"},\"rate_card_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the rate card for the project.\"},\"require_expense_approvals\":{\"type\":\"boolean\",\"description\":\"Whether expense approvals are required in the project.\"},\"require_notes_on_time_entries\":{\"type\":\"boolean\",\"description\":\"Whether notes are required on time entries logged against this project.\"},\"require_time_approvals\":{\"type\":\"boolean\",\"description\":\"Whether time approvals are required in the project.\"},\"stage\":{\"type\":\"string\",\"description\":\"The stage of the project. Possible values are `estimate` or `project`.\\nOnly returned when requested through the optional_fields param.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date of the project.\"},\"status\":{\"type\":\"object\",\"description\":\"A hash containing the status of the project.\\nVisible when the authenticated user can view the project status.\",\"properties\":{\"color\":{\"type\":\"string\",\"description\":\"The status color of the project (e.g. 'red').\\nVisible when the authenticated user can view the project status.\"},\"key\":{\"type\":\"string\",\"description\":\"The status key of the project (e.g. '501').\\nVisible when the authenticated user can view the project status.\"},\"message\":{\"type\":\"string\",\"description\":\"The status message of the project (e.g. 'Cancelled').\\nVisible when the authenticated user can view the project status.\"}}},\"status_report_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`status_report_ids` will only be included in the response if `status_reports` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"stories_are_fixed_fee_by_default\":{\"type\":\"boolean\",\"description\":\"Whether stories (tasks) are fixed fee by default.\\nVisible when the authenticated user is a project administrator and is on the account that the project is on.\"},\"target_margin\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The target margin of the project.\\nVisible when the authenticated user is on the provider team and can either see reports on the account or has financial access in the project.\"},\"tasks_default_non_billable\":{\"type\":\"boolean\",\"description\":\"Whether stories (tasks) are non-billable by default.\"},\"time_trackable\":{\"type\":\"boolean\",\"description\":\"Whether time can be tracked against this project and its tasks.\"},\"timesheet_submission_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`timesheet_submission_ids` will only be included in the response if `timesheet_submissions` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the project.\"},\"total_expenses_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total amount of expenses on the project, in the subunits of the currency (e.g. cents for USD).\\nVisible when the authenticated user is a project administrator and is on the account that the project is on.\"},\"total_invoiced\":{\"type\":\"string\",\"description\":\"The total amount invoiced, in the subunits of the currency (e.g. cents for USD).\\nVisible when the authenticated user can see reports on the account or has financial access in the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"total_minutes_approved\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total amount of approved time entries, in minutes. Only visible if the authenticated user has financial access in the project and is on the provider team.\\nVisible when the authenticated user can see total time approved in the project.\\n\\nOnly returned when requested through the optional_fields param.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date that the project was last updated.\"},\"workspace_group_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_group_ids` will only be included in the response if `workspace_groups` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_invoice_preference_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the workspace invoice preference which the project is associated with.\"},\"workspace_resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_resource_ids` will only be included in the response if `workspace_resources` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_resources_with_unnamed_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_resources_with_unnamed_ids` will only be included in the response if `workspace_resources_with_unnamed` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"WorkspaceAllocation\":{\"title\":\"Workspace Allocation\",\"description\":\"A workspace allocation represents a resource’s allocation over a specific period of time,\\nand is always associated with a workspace resource.\\n\\n*Note:* When an allocation is split, two allocations are returned in the response.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the allocation ends on.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"hard\":{\"type\":\"boolean\",\"description\":\"Indicates if the allocation is a Hard Allocation (“true”) or Soft (“false”).\"},\"minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Total minutes the resource is allocated over the date range.\"},\"notes\":{\"type\":\"string\",\"description\":\"User entered notes about the allocation.\"},\"percentage\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"Percentage that a user is allocated compared to their capacity between the start and end date of the allocation.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the allocation starts on.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"updater_id\":{\"type\":\"string\",\"description\":\"`updater_id` will only be included in the response if `updater` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_resource_id\":{\"type\":\"string\",\"description\":\"The ID of the workspace resource that the allocation will be associated with.\"}}},\"WorkspaceBaseline\":{\"title\":\"Workspace Baseline\",\"description\":\"A Gantt workspace baseline is composed of a workspace’s aggregate data at the time of the baseline creation.\\n\\nA workspace baseline has an associated baseline payload.\",\"type\":\"object\",\"properties\":{\"budget_used_formatted\":{\"type\":\"string\",\"description\":\"\\nVisible when the API user can view task budgets.\"},\"budget_used_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view task budgets.\"},\"completed_stories\":{\"type\":\"integer\",\"format\":\"int32\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"creator_name\":{\"type\":\"string\"},\"currency_base_unit\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"E.g. 100 (as in, 100 cents for 1 USD dollar).\\nVisible when the API user can view task budgets.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"E.g. USD.\\nVisible when the API user can view task budgets.\"},\"description\":{\"type\":\"string\"},\"due_date\":{\"type\":\"string\",\"format\":\"date\"},\"payload_id\":{\"type\":\"string\",\"description\":\"`payload_id` will only be included in the response if `payload` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"percentage_complete\":{\"type\":\"integer\",\"format\":\"int32\"},\"projected_due_date\":{\"type\":\"string\",\"format\":\"date\"},\"status_color\":{\"type\":\"string\",\"description\":\"The color of the workspace's status.\\nVisible when the API user can view project statuses.\"},\"status_text\":{\"type\":\"string\",\"description\":\"The text of the workspace's status.\\nVisible when the API user can view project statuses.\"},\"title\":{\"type\":\"string\"},\"total_budget_formatted\":{\"type\":\"string\",\"description\":\"\\nVisible when the API user can view task budgets.\"},\"total_budget_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"\\nVisible when the API user can view task budgets.\"},\"total_stories\":{\"type\":\"integer\",\"format\":\"int32\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"WorkspaceGroup\":{\"title\":\"Workspace Group\",\"description\":\"Workspace Groups (also known as groups) allow for the categorization of Kantata OX Workspaces and Users. Workspace Groups are unique to each Kantata OX Account. These endpoints allow you to fetch, create, update, and delete Workspace Groups. \\n\\nTo add a workspace to a Workspace Group, use the [create workspace](/tag/Workspaces#operation/create-workspace) or [update workspace](/tag/Workspaces#operation/update-workspace) endpoint and set the `workspace_group_ids` field.\\n\\nTo add a user to a Workspace Group, use the [create user group membership](/tag/User-Group-Memberships#operation/create-user-group-memberships) endpoint.\",\"type\":\"object\",\"properties\":{\"address\":{\"type\":\"string\",\"description\":\"The address of the company contact.\"},\"company\":{\"type\":\"boolean\",\"description\":\"Whether the group represents a company.\"},\"contact_name\":{\"type\":\"string\",\"description\":\"The name of the company contact.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"When the group was created.\"},\"email\":{\"type\":\"string\",\"description\":\"The email of the company contact.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the group.\"},\"notes\":{\"type\":\"string\",\"description\":\"Notes on the group.\"},\"phone_number\":{\"type\":\"string\",\"description\":\"The phone number of the company contact.\"},\"rate_card_set_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`rate_card_set_ids` will only be included in the response if `rate_card_sets` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"When the group was last updated.\"},\"website\":{\"type\":\"string\",\"description\":\"The website of the company contact.\"},\"workspace_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workspace_ids` will only be included in the response if `workspaces` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"WorkspaceInvitation\":{\"title\":\"Workspace Invitation\",\"type\":\"object\",\"properties\":{\"email_address\":{\"type\":\"string\"},\"full_name\":{\"type\":\"string\"},\"invitee_role\":{\"type\":\"string\"},\"message\":{\"type\":\"string\"},\"subject\":{\"type\":\"string\"}}},\"WorkspaceInvoicePreference\":{\"title\":\"Workspace Invoice Preference\",\"description\":\"Workspace Invoice Preferences specify the default values to be applied to new invoices created for specified \\nprojects. It is only used for projects that have financials enabled.\\n\\nThese preferences can only be created and updated by users who can manage invoice preferences\\non the project. This can be found by querying `can_manage_invoice_preferences` on Workspace.\",\"type\":\"object\",\"properties\":{\"client_invoice_address\":{\"type\":\"string\",\"description\":\"The address of the client being invoiced.\"},\"client_invoice_name\":{\"type\":\"string\",\"description\":\"The name of the client being invoiced.\"},\"consultant_invoice_address\":{\"type\":\"string\",\"description\":\"The address of the provider who is sending the invoice.\"},\"consultant_invoice_name\":{\"type\":\"string\",\"description\":\"The name of the provider who is sending the invoice.\"},\"project_code\":{\"type\":\"string\",\"description\":\"The invoice project code (defined by the user).\"},\"purchase_order\":{\"type\":\"string\",\"description\":\"The invoice purchase order (defined by the user).\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the project for which the invoice preferences will apply.\"}}},\"WorkspacePost\":{\"title\":\"Post\",\"description\":\"A Post represents a message written by participants in a project that appears in the project.\",\"type\":\"object\",\"properties\":{\"attachment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`attachment_ids` will only be included in the response if `attachments` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"formatted_message\":{\"type\":\"string\",\"description\":\"Sanitized HTML representation of the message with links, user mentions and emoji images.\"},\"google_document_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`google_document_ids` will only be included in the response if `google_documents` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"has_attachments\":{\"type\":\"boolean\",\"description\":\"Whether the post contains any attachments.\"},\"message\":{\"type\":\"string\",\"description\":\"The message of the post.\"},\"newest_reply_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time of the most recent reply.\"},\"newest_reply_id\":{\"type\":\"string\",\"description\":\"`newest_reply_id` will only be included in the response if `newest_reply` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"newest_reply_user_id\":{\"type\":\"string\",\"description\":\"`newest_reply_user_id` will only be included in the response if `newest_reply_user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"parsed_message\":{\"type\":\"string\",\"description\":\"Based on the markdown preference, includes either the parsed markdown or the message.\"},\"private\":{\"type\":\"boolean\",\"description\":\"Whether the post is private.\"},\"recipient_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`recipient_ids` will only be included in the response if `recipients` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"reply\":{\"type\":\"boolean\",\"description\":\"Whether there are any replies to the post.\"},\"reply_count\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of replies to the post.\"},\"reply_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`reply_ids` will only be included in the response if `replies` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Whether the post is a reply, the internal ID of the parent post, or the object to which the reply is made.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_title\":{\"type\":\"string\",\"description\":\"The subject title for proof posts.\"},\"subject_type\":{\"type\":\"string\",\"description\":\"The class name of the object to which the reply is made.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"WorkspaceResource\":{\"title\":\"Workspace Resource\",\"description\":\"With workspace resources it is possible for a user to have many resources with different roles\\nwithin a single workspace. Workspace resource can be assigned to tasks via Assignments which\\nenables specifying a specific role / rate per assigned task.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_value_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`custom_field_value_ids` will only be included in the response if `custom_field_values` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"display_label\":{\"type\":\"string\",\"description\":\"User facing Identifer for the Resource.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"full_name\":{\"type\":\"string\",\"description\":\"Full Name of the Resource's user if any.\"},\"label\":{\"type\":\"string\"},\"organization_membership_id\":{\"type\":\"string\",\"description\":\"`organization_membership_id` will only be included in the response if `organization_membership` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"participation_id\":{\"type\":\"string\",\"description\":\"`participation_id` will only be included in the response if `participation` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"photo_path\":{\"type\":\"string\",\"description\":\"URI of the Workspace Resource User Profile Photo if there is an user of the Resource.\"},\"resource_bill_rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The bill rate of the resource in a project, in the subunits of the currency (e.g. cents for USD).\\nIf the resource's bill rate was overridden for the project, this field returns the overridden rate.\\n\\nIncluding this field in your request may result in a slower response. We recommend including this field only if necessary.\\nVisible when the authenticated user has financial access in the project and is on the provider team.\\n\\nOnly returned when requested through the optional_fields param.\"},\"resource_cost_rate\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost rate of the resource in a project, in the subunits of the currency (e.g. cents for USD).\\nIf the resource's cost rate was overridden for the project, this field returns the overridden rate.\\n\\nIncluding this field in your request may result in a slower response. We recommend including this field only if necessary.\\nVisible when the authenticated user has financial access in the project and is on the provider team.\\n\\nOnly returned when requested through the optional_fields param.\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"role_initials\":{\"type\":\"string\",\"description\":\"Three letter initals for the Resource's Role if any.\"},\"role_name\":{\"type\":\"string\",\"description\":\"Name of the Resource's role if any.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"Id of the Workspace that the Resource belongs to.\"},\"workspace_title\":{\"type\":\"string\",\"description\":\"Title of the Workspace that the Resource belongs to.\"}}},\"WorkspaceResourceSkill\":{\"title\":\"Workspace Resource Skill\",\"description\":\"A Workspace Resource Skill represents a skill that has been assigned to a workspace resource.\",\"type\":\"object\",\"properties\":{\"cached_skill_name\":{\"type\":\"string\",\"description\":\"The name of the skill.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The objects proficiency level for the skill (1-5).\"},\"max_level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The maximum level assigned for the skill.\"},\"skill_id\":{\"type\":\"string\",\"description\":\"`skill_id` will only be included in the response if `skill` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"workspace_resource_id\":{\"type\":\"string\",\"description\":\"`workspace_resource_id` will only be included in the response if `workspace_resource` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"WorkspaceStatusChange\":{\"title\":\"Workspace Status Change\",\"description\":\"Workspace Status Changes represents a record of changes made to the status of a project.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"from_color\":{\"type\":\"string\",\"description\":\"Color of the previous status.\"},\"from_message\":{\"type\":\"string\",\"description\":\"Message of the previous status.\"},\"from_status_key\":{\"type\":\"string\",\"description\":\"Value of the previous status key.\"},\"to_color\":{\"type\":\"string\",\"description\":\"Color of the new status.\"},\"to_message\":{\"type\":\"string\",\"description\":\"Message of the new status.\"},\"to_status_key\":{\"type\":\"string\",\"description\":\"Value of the new status key.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"Workweek\":{\"title\":\"Workweek\",\"description\":\"Workweeks are owned by an account. A workweek can be used as the account default, or\\ncan be associated to a user through a workweek membership.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time a workweek was last updated.\"},\"default\":{\"type\":\"boolean\",\"description\":\"Whether the workweek is the default for the account.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The end date of the workweek.\"},\"friday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Friday.\"},\"monday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Monday.\"},\"saturday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Saturday.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date of the workweek.\"},\"sunday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Sunday.\"},\"thursday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Thursday.\"},\"total_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The total number of available working minutes for the week.\"},\"tuesday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Tuesday.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time at which a workweek was created.\"},\"wednesday_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of available working minutes on Wednesday.\"},\"workweek_membership_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`workweek_membership_ids` will only be included in the response if `workweek_memberships` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"WorkweekMembership\":{\"title\":\"Workweek Membership\",\"description\":\"A Workweek Membership represents the relationship of a user to a workweek.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the workweek membership was last updated.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The end date of the workweek.\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The start date of the workweek.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the workweek membership was created.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the associated user.\"},\"workweek_id\":{\"type\":\"string\",\"description\":\"`workweek_id` will only be included in the response if `workweek` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"Error\":{\"type\":\"object\",\"properties\":{\"type\":{\"type\":\"string\"},\"message\":{\"type\":\"string\"}}},\"Errors\":{\"type\":\"object\",\"properties\":{\"errors\":{\"type\":\"array\",\"items\":{\"$ref\":\"#/components/schemas/Error\"}}}},\"ActsAsTaggableOn_Tag\":{\"title\":\"Acts As Taggable On/Tag\",\"type\":\"object\",\"properties\":{\"name\":{\"type\":\"string\"},\"status\":{\"type\":\"string\"}}},\"Attachments_Base\":{\"title\":\"Attachment\",\"description\":\"Attachments are files that accompany other resources provided by the Kantata OX API.  Expenses can have an\\nattachment (tracked as a receipt).  Posts can also have attachments, which are displayed along with the post\\nin the activity feed or in task tracker.  Proofs have one attachment, which is the file that will represent the\\nproof in the Kantata OX proofing system.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_name\":{\"type\":\"string\",\"description\":\"The user who originally uploaded the attachment.\\nVisible when the attachment belongs to a proof or a post.\"},\"deletable\":{\"type\":\"boolean\",\"description\":\"Whether the current user can delete the attachment.\\nVisible when the attachment belongs to a post.\"},\"deleted_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"filename\":{\"type\":\"string\",\"description\":\"The original filename of the attachment when it was uploaded.\"},\"filesize\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The size of the attachment, in bytes.\"},\"previewable\":{\"type\":\"boolean\",\"description\":\"Whether the attachment is a previewable thumbnailed image.\"},\"proof_url\":{\"type\":\"string\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nThe URL with which to download the proof.\\nVisible when the attachment belongs to a proof.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"url\":{\"type\":\"string\",\"description\":\"The url from which to download the attachment from the CDN.\"},\"view_in_new_tab\":{\"type\":\"boolean\",\"description\":\"Whether the attachment is a filetype that should be viewed in a new tab; usually PDFs.\"},\"viewable\":{\"type\":\"boolean\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nWhether the proof attachment has finished processing and is ready for viewing.\\nVisible when the attachment belongs to a proof.\"}}},\"Attachments_PostAttachment\":{\"title\":\"Attachment\",\"description\":\"Attachments are files that accompany other resources provided by the Kantata OX API.  Expenses can have an\\nattachment (tracked as a receipt).  Posts can also have attachments, which are displayed along with the post\\nin the activity feed or in task tracker.  Proofs have one attachment, which is the file that will represent the\\nproof in the Kantata OX proofing system.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_name\":{\"type\":\"string\",\"description\":\"The user who originally uploaded the attachment.\\nVisible when the attachment belongs to a proof or a post.\"},\"deletable\":{\"type\":\"boolean\",\"description\":\"Whether the current user can delete the attachment.\\nVisible when the attachment belongs to a post.\"},\"deleted_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"filename\":{\"type\":\"string\",\"description\":\"The original filename of the attachment when it was uploaded.\"},\"filesize\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The size of the attachment, in bytes.\"},\"previewable\":{\"type\":\"boolean\",\"description\":\"Whether the attachment is a previewable thumbnailed image.\"},\"proof_url\":{\"type\":\"string\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nThe URL with which to download the proof.\\nVisible when the attachment belongs to a proof.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"url\":{\"type\":\"string\",\"description\":\"The url from which to download the attachment from the CDN.\"},\"view_in_new_tab\":{\"type\":\"boolean\",\"description\":\"Whether the attachment is a filetype that should be viewed in a new tab; usually PDFs.\"},\"viewable\":{\"type\":\"boolean\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nWhether the proof attachment has finished processing and is ready for viewing.\\nVisible when the attachment belongs to a proof.\"}}},\"Attachments_ProofAttachment\":{\"title\":\"Attachment\",\"description\":\"Attachments are files that accompany other resources provided by the Kantata OX API.  Expenses can have an\\nattachment (tracked as a receipt).  Posts can also have attachments, which are displayed along with the post\\nin the activity feed or in task tracker.  Proofs have one attachment, which is the file that will represent the\\nproof in the Kantata OX proofing system.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_name\":{\"type\":\"string\",\"description\":\"The user who originally uploaded the attachment.\\nVisible when the attachment belongs to a proof or a post.\"},\"deletable\":{\"type\":\"boolean\",\"description\":\"Whether the current user can delete the attachment.\\nVisible when the attachment belongs to a post.\"},\"deleted_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"filename\":{\"type\":\"string\",\"description\":\"The original filename of the attachment when it was uploaded.\"},\"filesize\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The size of the attachment, in bytes.\"},\"previewable\":{\"type\":\"boolean\",\"description\":\"Whether the attachment is a previewable thumbnailed image.\"},\"proof_url\":{\"type\":\"string\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nThe URL with which to download the proof.\\nVisible when the attachment belongs to a proof.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"url\":{\"type\":\"string\",\"description\":\"The url from which to download the attachment from the CDN.\"},\"view_in_new_tab\":{\"type\":\"boolean\",\"description\":\"Whether the attachment is a filetype that should be viewed in a new tab; usually PDFs.\"},\"viewable\":{\"type\":\"boolean\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nWhether the proof attachment has finished processing and is ready for viewing.\\nVisible when the attachment belongs to a proof.\"}}},\"Attachments_ReceiptAttachment\":{\"title\":\"Attachment\",\"description\":\"Attachments are files that accompany other resources provided by the Kantata OX API.  Expenses can have an\\nattachment (tracked as a receipt).  Posts can also have attachments, which are displayed along with the post\\nin the activity feed or in task tracker.  Proofs have one attachment, which is the file that will represent the\\nproof in the Kantata OX proofing system.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_name\":{\"type\":\"string\",\"description\":\"The user who originally uploaded the attachment.\\nVisible when the attachment belongs to a proof or a post.\"},\"deletable\":{\"type\":\"boolean\",\"description\":\"Whether the current user can delete the attachment.\\nVisible when the attachment belongs to a post.\"},\"deleted_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"filename\":{\"type\":\"string\",\"description\":\"The original filename of the attachment when it was uploaded.\"},\"filesize\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The size of the attachment, in bytes.\"},\"previewable\":{\"type\":\"boolean\",\"description\":\"Whether the attachment is a previewable thumbnailed image.\"},\"proof_url\":{\"type\":\"string\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nThe URL with which to download the proof.\\nVisible when the attachment belongs to a proof.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"url\":{\"type\":\"string\",\"description\":\"The url from which to download the attachment from the CDN.\"},\"view_in_new_tab\":{\"type\":\"boolean\",\"description\":\"Whether the attachment is a filetype that should be viewed in a new tab; usually PDFs.\"},\"viewable\":{\"type\":\"boolean\",\"description\":\"**Important**: After December 31, 2024, Proofing will no longer be available in Kantata OX and this field will be unavailable.\\n\\nWhether the proof attachment has finished processing and is ready for viewing.\\nVisible when the attachment belongs to a proof.\"}}},\"CustomFields_ChoiceField\":{\"title\":\"Custom Field\",\"description\":\"The [Custom Fields](https://mavenlink.zendesk.com/hc/en-us/articles/202924760-Custom-Fields-Overview-#arrange) object allows you to\\nview, create, update, and delete extra fields for additional Estimate, Project, Group, Resource, Task, and User information.\\nIf Custom Fields represent the fields themselves, [Custom Field Values](/tag/Custom-Field-Values)\\nrepresent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`choice_ids` will only be included in the response if `choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_set_id\":{\"type\":\"string\",\"description\":\"`custom_field_set_id` will only be included in the response if `custom_field_set` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"default_text\":{\"type\":\"string\",\"description\":\"The message in an empty custom field, before a `string`, `date`, `number`, or `currency`  value is entered in.\\nThis only appears in the UI.\\nVisible when whether the custom field is an input field..\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the custom field.\"},\"read_access\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n  - `project_collaboration` (default)\\n  - `time_logging`\\n  - `financial`\\n  - `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n  - `account_collaboration`\\n  - `project_creator`\\n  - `project_lead`\\n  - `reports_viewer`\\n  - `reports_viewer_with_cost`\\n  - `account_admin` (default).\"},\"unique_constraint\":{\"type\":\"boolean\",\"description\":\"Indicates whether a custom field value must be unique across Estimates, Projects, Groups, Resources, Tasks, or Users.\\nThis is set to `false` by default.\\n\\nDoes not apply to Custom Fields with choices.\\nVisible when whether the custom field is an input field..\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value_type\":{\"type\":\"string\",\"description\":\"The format of the [custom field's value](/tag/Custom-Field-Values):\\n    | Value Type           | Format                                   | Sample         |\\n    | -------------------- |:----------------------------------------:| --------------:|\\n    | `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n    | `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n    | `number`             | `<integer_value>`                        |           `13` |\\n    | `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n    | `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\nThis is set to `string`, by default.\"},\"write_access\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The permission level required for a user to create, update, or delete a custom field's value.\"}}},\"CustomFields_ChoiceValue\":{\"title\":\"Custom Field Value\",\"description\":\"If [Custom Fields](/tag/Custom-Fields) represent the fields themselves,\\nCustom Field Values represent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account the Custom Field Value is in.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the Custom Field Value can be edited by the requester.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_id\":{\"type\":\"string\",\"description\":\"`custom_field_id` will only be included in the response if `custom_field` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_name\":{\"type\":\"string\",\"description\":\"The name of the Custom Field.\"},\"display_value\":{\"type\":\"string\",\"description\":\"The Custom Field Values, but in more understandable formats:\\n* For Custom Fields with values that are selected choices, the labels on those choices are returned.\\n* For Custom Fields with currency values, the amount with the currency symbol ($100) is returned.\\n* All other values are converted into a string.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"selected_choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`selected_choice_ids` will only be included in the response if `selected_choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"setter_id\":{\"type\":\"string\",\"description\":\"`setter_id` will only be included in the response if `setter` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Estimate, Project, Group, Resource, Task, or User the custom field is for.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_type\":{\"type\":\"string\",\"description\":\"The set of Custom Fields that values are returned for:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\"},\"type\":{\"type\":\"string\",\"description\":\"Potential formats of values:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value\":{\"type\":\"string\",\"description\":\"The value created or updated for the specified custom field.\\n\\nValues can be created or updated in these formats:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\n##### Note:\\nThe `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n- `project_collaboration` (default)\\n- `time_logging`\\n- `financial`\\n- `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n- `account_collaboration`\\n- `project_creator`\\n- `project_lead`\\n- `reports_viewer`\\n- `reports_viewer_with_cost`\\n- `account_admin` (default).\"}}},\"CustomFields_CurrencyValue\":{\"title\":\"Custom Field Value\",\"description\":\"If [Custom Fields](/tag/Custom-Fields) represent the fields themselves,\\nCustom Field Values represent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account the Custom Field Value is in.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the Custom Field Value can be edited by the requester.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_id\":{\"type\":\"string\",\"description\":\"`custom_field_id` will only be included in the response if `custom_field` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_name\":{\"type\":\"string\",\"description\":\"The name of the Custom Field.\"},\"display_value\":{\"type\":\"string\",\"description\":\"The Custom Field Values, but in more understandable formats:\\n* For Custom Fields with values that are selected choices, the labels on those choices are returned.\\n* For Custom Fields with currency values, the amount with the currency symbol ($100) is returned.\\n* All other values are converted into a string.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"selected_choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`selected_choice_ids` will only be included in the response if `selected_choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"setter_id\":{\"type\":\"string\",\"description\":\"`setter_id` will only be included in the response if `setter` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Estimate, Project, Group, Resource, Task, or User the custom field is for.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_type\":{\"type\":\"string\",\"description\":\"The set of Custom Fields that values are returned for:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\"},\"type\":{\"type\":\"string\",\"description\":\"Potential formats of values:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value\":{\"type\":\"string\",\"description\":\"The value created or updated for the specified custom field.\\n\\nValues can be created or updated in these formats:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\n##### Note:\\nThe `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n- `project_collaboration` (default)\\n- `time_logging`\\n- `financial`\\n- `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n- `account_collaboration`\\n- `project_creator`\\n- `project_lead`\\n- `reports_viewer`\\n- `reports_viewer_with_cost`\\n- `account_admin` (default).\"}}},\"CustomFields_DateValue\":{\"title\":\"Custom Field Value\",\"description\":\"If [Custom Fields](/tag/Custom-Fields) represent the fields themselves,\\nCustom Field Values represent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account the Custom Field Value is in.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the Custom Field Value can be edited by the requester.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_id\":{\"type\":\"string\",\"description\":\"`custom_field_id` will only be included in the response if `custom_field` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_name\":{\"type\":\"string\",\"description\":\"The name of the Custom Field.\"},\"display_value\":{\"type\":\"string\",\"description\":\"The Custom Field Values, but in more understandable formats:\\n* For Custom Fields with values that are selected choices, the labels on those choices are returned.\\n* For Custom Fields with currency values, the amount with the currency symbol ($100) is returned.\\n* All other values are converted into a string.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"selected_choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`selected_choice_ids` will only be included in the response if `selected_choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"setter_id\":{\"type\":\"string\",\"description\":\"`setter_id` will only be included in the response if `setter` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Estimate, Project, Group, Resource, Task, or User the custom field is for.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_type\":{\"type\":\"string\",\"description\":\"The set of Custom Fields that values are returned for:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\"},\"type\":{\"type\":\"string\",\"description\":\"Potential formats of values:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value\":{\"type\":\"string\",\"description\":\"The value created or updated for the specified custom field.\\n\\nValues can be created or updated in these formats:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\n##### Note:\\nThe `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n- `project_collaboration` (default)\\n- `time_logging`\\n- `financial`\\n- `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n- `account_collaboration`\\n- `project_creator`\\n- `project_lead`\\n- `reports_viewer`\\n- `reports_viewer_with_cost`\\n- `account_admin` (default).\"}}},\"CustomFields_InputField\":{\"title\":\"Custom Field\",\"description\":\"The [Custom Fields](https://mavenlink.zendesk.com/hc/en-us/articles/202924760-Custom-Fields-Overview-#arrange) object allows you to\\nview, create, update, and delete extra fields for additional Estimate, Project, Group, Resource, Task, and User information.\\nIf Custom Fields represent the fields themselves, [Custom Field Values](/tag/Custom-Field-Values)\\nrepresent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`choice_ids` will only be included in the response if `choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"creator_id\":{\"type\":\"string\",\"description\":\"`creator_id` will only be included in the response if `creator` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_set_id\":{\"type\":\"string\",\"description\":\"`custom_field_set_id` will only be included in the response if `custom_field_set` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"default_text\":{\"type\":\"string\",\"description\":\"The message in an empty custom field, before a `string`, `date`, `number`, or `currency`  value is entered in.\\nThis only appears in the UI.\\nVisible when whether the custom field is an input field..\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"name\":{\"type\":\"string\",\"description\":\"The name of the custom field.\"},\"read_access\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n  - `project_collaboration` (default)\\n  - `time_logging`\\n  - `financial`\\n  - `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n  - `account_collaboration`\\n  - `project_creator`\\n  - `project_lead`\\n  - `reports_viewer`\\n  - `reports_viewer_with_cost`\\n  - `account_admin` (default).\"},\"unique_constraint\":{\"type\":\"boolean\",\"description\":\"Indicates whether a custom field value must be unique across Estimates, Projects, Groups, Resources, Tasks, or Users.\\nThis is set to `false` by default.\\n\\nDoes not apply to Custom Fields with choices.\\nVisible when whether the custom field is an input field..\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value_type\":{\"type\":\"string\",\"description\":\"The format of the [custom field's value](/tag/Custom-Field-Values):\\n    | Value Type           | Format                                   | Sample         |\\n    | -------------------- |:----------------------------------------:| --------------:|\\n    | `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n    | `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n    | `number`             | `<integer_value>`                        |           `13` |\\n    | `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n    | `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\nThis is set to `string`, by default.\"},\"write_access\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The permission level required for a user to create, update, or delete a custom field's value.\"}}},\"CustomFields_IntegerValue\":{\"title\":\"Custom Field Value\",\"description\":\"If [Custom Fields](/tag/Custom-Fields) represent the fields themselves,\\nCustom Field Values represent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account the Custom Field Value is in.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the Custom Field Value can be edited by the requester.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_id\":{\"type\":\"string\",\"description\":\"`custom_field_id` will only be included in the response if `custom_field` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_name\":{\"type\":\"string\",\"description\":\"The name of the Custom Field.\"},\"display_value\":{\"type\":\"string\",\"description\":\"The Custom Field Values, but in more understandable formats:\\n* For Custom Fields with values that are selected choices, the labels on those choices are returned.\\n* For Custom Fields with currency values, the amount with the currency symbol ($100) is returned.\\n* All other values are converted into a string.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"selected_choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`selected_choice_ids` will only be included in the response if `selected_choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"setter_id\":{\"type\":\"string\",\"description\":\"`setter_id` will only be included in the response if `setter` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Estimate, Project, Group, Resource, Task, or User the custom field is for.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_type\":{\"type\":\"string\",\"description\":\"The set of Custom Fields that values are returned for:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\"},\"type\":{\"type\":\"string\",\"description\":\"Potential formats of values:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value\":{\"type\":\"string\",\"description\":\"The value created or updated for the specified custom field.\\n\\nValues can be created or updated in these formats:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\n##### Note:\\nThe `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n- `project_collaboration` (default)\\n- `time_logging`\\n- `financial`\\n- `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n- `account_collaboration`\\n- `project_creator`\\n- `project_lead`\\n- `reports_viewer`\\n- `reports_viewer_with_cost`\\n- `account_admin` (default).\"}}},\"CustomFields_StringValue\":{\"title\":\"Custom Field Value\",\"description\":\"If [Custom Fields](/tag/Custom-Fields) represent the fields themselves,\\nCustom Field Values represent the values in/of those fields.\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account the Custom Field Value is in.\"},\"can_edit\":{\"type\":\"boolean\",\"description\":\"Whether the Custom Field Value can be edited by the requester.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"custom_field_id\":{\"type\":\"string\",\"description\":\"`custom_field_id` will only be included in the response if `custom_field` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"custom_field_name\":{\"type\":\"string\",\"description\":\"The name of the Custom Field.\"},\"display_value\":{\"type\":\"string\",\"description\":\"The Custom Field Values, but in more understandable formats:\\n* For Custom Fields with values that are selected choices, the labels on those choices are returned.\\n* For Custom Fields with currency values, the amount with the currency symbol ($100) is returned.\\n* All other values are converted into a string.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"selected_choice_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`selected_choice_ids` will only be included in the response if `selected_choices` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"setter_id\":{\"type\":\"string\",\"description\":\"`setter_id` will only be included in the response if `setter` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the Estimate, Project, Group, Resource, Task, or User the custom field is for.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_type\":{\"type\":\"string\",\"description\":\"The set of Custom Fields that values are returned for:\\n* `Estimate`\\n* `Workspace` (Project)\\n* `WorkspaceGroup` (Group)\\n* `Resource`\\n* `Story` (Task)\\n* `User`.\"},\"type\":{\"type\":\"string\",\"description\":\"Potential formats of values:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |.\"},\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"value\":{\"type\":\"string\",\"description\":\"The value created or updated for the specified custom field.\\n\\nValues can be created or updated in these formats:\\n\\n| Value Type           | Format                                   | Sample         |\\n| -------------------- |:----------------------------------------:| --------------:|\\n| `string`             | `<text_string>`                          |        `\\\"foo\\\"` |\\n| `date`               | `<ISO_8601 Date Format>`                 | `\\\"2014-02-25\\\"` |\\n| `number`             | `<integer_value>`                        |           `13` |\\n| `currency`           | `[<int_value_in_cents>, <currency_code>]`| `[998, \\\"USD\\\"]` |\\n| `single` and `multi` | `[<choice_ids>]`                         |    `[1, 2, 4]` |\\n\\n##### Note:\\nThe `read_access` [permission setting on each custom field](https://mavenlink.zendesk.com/hc/en-us/articles/202924760#see)\\ndetermines the minimum permission needed to view a custom field and its value.\\n* `Workspace` (Project), `Resource`, and `Story` (Task) custom fields are project-specific objects,\\nso their minimum permissions are set at the [project level](https://mavenlink.zendesk.com/hc/en-us/articles/115002779293-Project-Permissions):\\n- `project_collaboration` (default)\\n- `time_logging`\\n- `financial`\\n- `project_admin`\\n\\nMost account-level permissions supercede project-level permissions. Therefore, Account Administrators\\nare able to view all Project, Resource, and Task custom fields and values across the account,\\nregardless of project participation or `read_access` settings.\\n* `Estimate`, `WorkspaceGroup` (Group), and `User` custom fields are account-wide objects,\\nso their minimum permissions are set at the [account level](https://mavenlink.zendesk.com/hc/en-us/articles/203041364):\\n- `account_collaboration`\\n- `project_creator`\\n- `project_lead`\\n- `reports_viewer`\\n- `reports_viewer_with_cost`\\n- `account_admin` (default).\"}}},\"Project_Snapshots_Models_ProjectSnapshot\":{\"title\":\"Project Snapshots\",\"description\":\"Project snapshots capture the state of a project at a specific point in time. Snapshots are useful for gaining a historical perspective on a project, and for comparing the current state of a project to a previous state.\\n\\nProject financials, tasks, and resources are all captured in a snapshot, as well as project and task custom field values.\",\"type\":\"object\",\"properties\":{\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"When the snapshot was created.\"},\"currency\":{\"type\":\"string\",\"description\":\"The [ISO code](https://knowledge.kantata.com/hc/en-us/articles/360041576473) of the currency set on the project at the time of the snapshot.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the snapshot.\"},\"duration\":{\"type\":\"string\",\"description\":\"The duration of the project at the time of the snapshot, based on the earliest start date and latest due date of tasks.\"},\"is_baseline\":{\"type\":\"boolean\",\"description\":\"Whether the snapshot is set as the baseline for the project.\"},\"project_snapshot_assignment_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`project_snapshot_assignment_ids` will only be included in the response if `project_snapshot_assignments` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"project_snapshot_custom_field_value_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`project_snapshot_custom_field_value_ids` will only be included in the response if `project_snapshot_custom_field_values` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"project_snapshot_resource_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`project_snapshot_resource_ids` will only be included in the response if `project_snapshot_resources` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"project_snapshot_task_custom_field_value_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`project_snapshot_task_custom_field_value_ids` will only be included in the response if `project_snapshot_task_custom_field_values` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"project_snapshot_task_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`project_snapshot_task_ids` will only be included in the response if `project_snapshot_tasks` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"status_as_text\":{\"type\":\"string\",\"description\":\"The status of the project at the time of the snapshot.\"},\"status_color\":{\"type\":\"string\",\"description\":\"The status color of the project at the time of the snapshot.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the snapshot.\"}}},\"Project_Snapshots_Models_ProjectSnapshotAssignment\":{\"title\":\"Project Snapshot Assignments\",\"description\":\"Project snapshot assignments represent the state of task assignments in a project when a snapshot was taken, including resource estimated minutes, scheduled minutes, and rates.\",\"type\":\"object\",\"properties\":{\"bill_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The bill rate in cents of the resource at the time of the snapshot.\"},\"cost_rate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The cost rate in cents of the resource at the time of the snapshot.\"},\"estimated_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The estimated time in minutes for the resource of this assignment at the time of the snapshot.\"},\"project_snapshot_resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resource the assignment is for.\"},\"project_snapshot_task_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the task the assignment is for.\"},\"scheduled_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The scheduled minutes of the assignment.\"}}},\"Project_Snapshots_Models_ProjectSnapshotCustomFieldValue\":{\"title\":\"Snapshot Custom Field Value\",\"description\":\"Snapshot custom field values represent the state of project and task custom field values when a snapshot was taken.\",\"type\":\"object\",\"properties\":{\"custom_field_name\":{\"type\":\"string\",\"description\":\"The name of the custom field.\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the snapshot project or snapshot task the custom field value is for. This is not the same as the project or task ID.\"},\"subject_type\":{\"type\":\"string\",\"description\":\"The subject type of the custom field value, e.g. `SnapshotWorkspace` (snapshot project) or `SnapshotStory` (snapshot task).\"},\"value\":{\"type\":\"string\",\"description\":\"The value of the custom field.\"},\"value_type\":{\"type\":\"string\",\"description\":\"The value type of the custom field, e.g. `string`, `date`, `number`, `currency`, `single`, or `multi`.\"}}},\"Project_Snapshots_Models_ProjectSnapshotResource\":{\"title\":\"Project Snapshot Resources\",\"description\":\"Project Snapshot Resources represent the state of project resources when a snapshot was taken, including their roles and total project allocation.\",\"type\":\"object\",\"properties\":{\"allocated_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The number of minutes the resource was allocated on the project at the time of the snapshot.\"},\"name\":{\"type\":\"string\",\"description\":\"For named resources, this is the person's full name. For unnamed resources, this is the title.\"},\"project_snapshot_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the snapshot this snapshot resource is for.\"},\"resource_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the resource.\"},\"role_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the role the resource had on the project at the time of the snapshot.\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user for the resource at the time of the snapshot. For unnamed resources, this is null.\"}}},\"Project_Snapshots_Models_ProjectSnapshotTask\":{\"title\":\"Project Snapshot Task\",\"description\":\"Project snapshot tasks represent the state of tasks in a project when a snapshot was taken.\",\"type\":\"object\",\"properties\":{\"archived\":{\"type\":\"boolean\",\"description\":\"Whether the task was archived when the snapshot was taken.\"},\"billable\":{\"type\":\"boolean\",\"description\":\"Whether the task was billable when the snapshot was taken.\"},\"budget_estimate_in_cents\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The budget of the task when the snapshot was taken.\"},\"description\":{\"type\":\"string\",\"description\":\"The description of the task when the snapshot was taken.\"},\"due_date\":{\"type\":\"string\",\"description\":\"The due date of the task when the snapshot was taken.\"},\"percentage_complete\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The percentage complete of the task when the snapshot was taken.\"},\"priority_level\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The priority level of the task when the snapshot was taken.\"},\"project_plan\":{\"type\":\"boolean\",\"description\":\"Whether the task was a project task (`true`) or a To Do (`false`) when the snapshot was taken.\"},\"project_snapshot_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the snapshot this snapshot task is for.\"},\"start_date\":{\"type\":\"string\",\"description\":\"The start date of the task when the snapshot was taken.\"},\"state\":{\"type\":\"string\",\"description\":\"The status of the task when the snapshot was taken.\"},\"story_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the story (task).\"},\"story_type\":{\"type\":\"string\",\"description\":\"The type of the task when the snapshot was taken.\"},\"time_estimate_in_minutes\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The task estimate in minutes when the snapshot was taken.\"},\"title\":{\"type\":\"string\",\"description\":\"The title of the task when the snapshot was taken.\"},\"wbs\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The WBS number of the task when the snapshot was taken.\"}}},\"ProjectAccounting_Models_ProjectAccountingRecord\":{\"title\":\"Project Accounting Records\",\"description\":\"Project accounting records.\",\"type\":\"object\",\"properties\":{\"amount\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The amount calculated for baseline, forecasting,\\n              earned value, earned value forecasting, or revenue recognition\\n              within the specified accounting period.\"},\"amount_to_date\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The total amount spent to date (for all accounting periods).\"},\"budget\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The budget of the project or task.\"},\"contract_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"A contract's start or end date, or any other designated date.\"},\"cost\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The cost of the project or task within the specified accounting period.\"},\"cost_eac\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The [estimated cost](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n              of the project or task when it is completed. This updates during the course of a project or task, as costs are logged.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the record was created.\"},\"currency\":{\"type\":\"string\",\"description\":\"The currency of the record. See the\\n              [ISO codes of currencies supported by Kantata OX](https://mavenlink.zendesk.com/hc/en-us/articles/360041576473).\"},\"description\":{\"type\":\"string\",\"description\":\"A brief description of the record.\"},\"end_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the accounting period ends.\"},\"external_reference_ids\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"`external_reference_ids` will only be included in the response if `external_references` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"fees\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The fees from the specified accounting period.\"},\"hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The [hours](https://mavenlink.zendesk.com/hc/en-us/articles/360059325413)\\n              spent within the specified accounting period.\"},\"hours_eac\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The [estimated hours](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n              for the project or task when it is completed. This updates during the course of a project or task, as hours are logged.\"},\"hours_etc\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The [estimated hours](https://mavenlink.zendesk.com/hc/en-us/articles/360004619334-Project-Completion-Estimates)\\n              until completion (`hours_eac` - `hours`) of the project or task.\"},\"labor_type\":{\"type\":\"string\",\"description\":\"Whether the cost associated with the record is for `labor` or `non-labor`.\"},\"notes\":{\"type\":\"string\",\"description\":\"Extra information to note about the record.\"},\"percent_complete\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"How much of the project or task is complete in decimal format (e.g. 0.75 = 75%).\"},\"role_id\":{\"type\":\"string\",\"description\":\"`role_id` will only be included in the response if `role` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"service_type\":{\"type\":\"string\",\"description\":\"An organization-specific category of services\\n              that is related to the record (e.g. Branding, Campaigns, Photography, etc.).\"},\"start_date\":{\"type\":\"string\",\"format\":\"date\",\"description\":\"The date the accounting period begins.\"},\"status\":{\"type\":\"string\",\"description\":\"The status of the record (`Draft`, `Pending Approval`, `Approved`, or `Cancelled`).\"},\"story_id\":{\"type\":\"string\",\"description\":\"`story_id` will only be included in the response if `story` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"total_estimated_hours\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The hours initially estimated for the project or task.\\n              This value does not change over the course of a project.\"},\"total_hours_to_date\":{\"type\":\"number\",\"format\":\"float\",\"description\":\"The total hours logged to date for the project or task.\"},\"type\":{\"type\":\"string\",\"description\":\"The type of project accounting record (`Baseline`, `Earned Value`,\\n                `Earned Value Forecasting`, `Forecasting`, or `Recognition`).\"},\"user_id\":{\"type\":\"string\",\"description\":\"`user_id` will only be included in the response if `user` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"},\"workspace_id\":{\"type\":\"string\",\"description\":\"`workspace_id` will only be included in the response if `workspace` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\"}}},\"SubscribedEvents_Models_SubscribedEvent\":{\"title\":\"Subscribed Event\",\"description\":\"An API feature that returns the last 9 days of trackable changes (\\\"events\\\") in an account.\\n\\nFor a list of all the event types tracked by Subscribed Events, please see the [Knowledge Base](https://mavenlink.zendesk.com/hc/en-us/articles/4407962435227).\",\"type\":\"object\",\"properties\":{\"account_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the account that the change occurred in.\"},\"context_workspace_id\":{\"type\":\"string\",\"description\":\"The ID of the workspace associated with the event, if any.\"},\"created_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the event record was created. Note that this is not when the action was actually performed and may be different from `subject_changed_at`.\"},\"current_payload\":{\"type\":\"string\",\"description\":\"The updated data record, as metadata in JSON format.\\nOnly returned when requested through the optional_fields param.\"},\"event_type\":{\"type\":\"string\",\"description\":\"The type of change event. For a list of all the event types tracked by Subscribed Events, please see the [Knowledge Base](https://mavenlink.zendesk.com/hc/en-us/articles/4407962435227).\"},\"payload_changes\":{\"type\":\"string\",\"description\":\"The previous and current values for the changed fields in the data record, as metadata in JSON format.\\nOnly returned when requested through the optional_fields param.\"},\"previous_payload\":{\"type\":\"string\",\"description\":\"The data record before it was changed, as metadata in JSON format.\\nOnly returned when requested through the optional_fields param.\"},\"subject_changed_at\":{\"type\":\"string\",\"format\":\"date-time\",\"description\":\"The date and time the event was triggered (i.e. when the action was performed).\"},\"subject_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the data record that was changed.\"},\"subject_ref\":{\"type\":\"object\",\"description\":\"`subject_ref` will only be included in the response if `subject` is in the list of included associations. See <a href='#section/Includes'>include</a> section for usage.\",\"properties\":{\"key\":{\"type\":\"string\"},\"id\":{\"type\":\"string\"}}},\"subject_type\":{\"type\":\"string\",\"description\":\"The type of data record that was changed (e.g. TimeEntry).\"},\"user_id\":{\"type\":\"integer\",\"format\":\"int32\",\"description\":\"The ID of the user who made the change.\"}}}}}}},\"options\":{\"theme\":{\"overrides\":{\"DownloadButton\":{\"custom\":\"\"},\"NextSectionButton\":{\"custom\":\"\"}},\"codeBlock\":{\"tokens\":{}},\"schema\":{\"constraints\":{},\"examples\":{}},\"rightPanel\":{\"textColor\":\"#eeeeee\"},\"typography\":{\"heading1\":{},\"heading2\":{},\"heading3\":{\"fontSize\":\"1.5em\"},\"rightPanelHeading\":{}},\"fab\":{\"color\":\"Ef7314\"},\"colors\":{\"primary\":{\"main\":\"#ef7314\"}},\"layout\":{\"showDarkRightPanel\":false},\"components\":{\"panels\":{\"borderRadius\":\"4px\"},\"httpBadges\":{\"borderRadius\":\"3px\"}}},\"pagination\":\"section\",\"showConsole\":true,\"scrollYOffset\":0,\"hideTryItPanel\":true,\"expandResponses\":\"200\",\"hideDownloadButton\":true,\"generateCodeSamples\":{\"languages\":[{\"lang\":\"curl\",\"label\":\"curl\"},{\"lang\":\"Ruby\",\"label\":\"Ruby\"},{\"lang\":\"JavaScript\",\"label\":\"JavaScript\"},{\"lang\":\"Python\",\"label\":\"Python\"},{\"lang\":\"C#\",\"label\":\"C#\"},{\"lang\":\"Go\",\"label\":\"Go\"}]},\"samplesTabsMaxCount\":4,\"expandSingleSchemaField\":true,\"corsProxyUrl\":\"https://cors.redoc.ly/\",\"licenseKey\":\"eyJ0IjpmYWxzZSwiaSI6MTcyOTk0MTAzMSwiZSI6MTcyOTk0NDYzMSwiaCI6WyJkZXZlbG9wZXIua2FudGF0YS5jb20iLCJyZWRvYy5seSJdfQ==.G40m4xAiMeKWtOJiQdW1njjBZfBrxzUhjoXo7nqNatKMoMg8btaCTOo1GWNcr3aZnSNJaoHOShRJjGacqLY7uw==\"}}");