--- title: Update url: https://www.tines.com/docs/api/resources/update/ updated: 2025-12-02T15:37:48+00:00 description: Use a HTTP PUT request to update a resource. If the resource has a test value this can be modified by using the is_test parameter. --- *[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/llms.txt) › [Tines API](https://www.tines.com/llms.txt) › [Resources](https://www.tines.com/llm/docs/api/resources.md)* # Update *[View on tines.com](https://www.tines.com/docs/api/resources/update/)* ## Description Use a HTTP PUT request to update a resource. If the resource has a test value this can be modified by using the is_test parameter. ## Request HTTP Method: **PUT** | Parameter | Description | | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | resource_id | The ID of the live resource. | | value | Contents of the resource. For file resources, pass a JSON object with file data (see below). | | name | **Optional** Name of the resource. | | folder_id | **Optional** The ID of the folder to move the resource to, or an empty value to indicate the root folder. Note that this folder must exist within the team identified by `team_id`, or the resource's current team if `team_id` isn't specified. | | read_access | **Optional** Control where this resource can be used (`TEAM`, `GLOBAL`, `SPECIFIC_TEAMS`). default: `TEAM`. (`SPECIFIC_TEAMS` is a premium feature. [Reach out to find out more](https://tines.com/contact-support).) | | shared_team_slugs | **Optional** List of teams' slugs where this resource can be used. Required to set `read_access` to `SPECIFIC_TEAMS`. default: `[]` (empty array). | | description | **Optional** Description of the resource. default: `""` (empty string). | | test_resource_enabled | **Optional** Boolean value stating if the resource is enabled for using a test. resource | | is_test | **Optional** Boolean value stating if the test resource should be updated. `test_resource_enabled` must be set to `TRUE` and a test resource must exist for the update to succeed. | | include_referencing_action_ids | **Optional** Defaults to `true`, when set to `false` we will exclude `referencing_action_ids` from the response | | typed_value | **Optional** Defaults to `false`. When set to `true`, returns properly typed values (boolean, number, array, object) instead of strings | ### File value object | Field | Required | Description | | -------- | -------- | ----------------------------------- | | name | Yes | File name (e.g., "document.pdf") | | contents | Yes | Base64-encoded file contents | | type | No | MIME type (e.g., "application/pdf") | ### Sample request (text resource) ```bash curl -X PUT \ https:///api/v1/global_resources/<> \ -H 'content-type: application/json' \ -H 'Authorization: Bearer <>' \ -d '{ "value":"updated resource value" }' ``` ### Sample request (file resource) ```bash curl -X PUT \ https:///api/v1/global_resources/<> \ -H 'content-type: application/json' \ -H 'Authorization: Bearer <>' \ -d '{ "value": { "name": "updated_document.pdf", "contents": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovQ3...", "type": "application/pdf" } }' ``` ## Response A successful request will return a JSON object describing the updated resource. Test resource data is contained within the live resource. ### Field description | Parameter | Description | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Resource ID. | | name | Name of the resource. | | value | Value of the resource. By default, returns a string representation. Use `typed_value=true` to get properly typed values (boolean, number, array, object). | | team_id | ID of team to which the resource belongs. | | folder_id | ID of folder to which the resource belongs. | | user_id | ID of user associated with the resource. | | read_access | Control where this resource can be used (`TEAM`, `GLOBAL`, `SPECIFIC_TEAMS`). | | shared_team_slugs | List of teams' slugs where this resource can be used when `read_access` is `SPECIFIC_TEAMS`, otherwise empty. | | slug | An underscored representation of the resource name | | created_at | ISO 8601 Timestamp representing date and time the resource was created. | | updated_at | ISO 8601 Timestamp representing date and time the resource was last updated. | | description | Description of the resource. | | test_resource_enabled | A boolean value stating if the resource is enabled for using a test resource. | | test_resource | JSON block of the test resource. | | referencing_action_ids | IDs of action that are referencing the Resource. | ### Sample response ```json { "id": 9, "name": "an array resource", "value": "updated resource value", "team_id": 1, "folder_id": 1, "user_id": 1, "read_access": "TEAM", "shared_team_slugs": [], "slug": "an_array_resource", "created_at": "2020-02-05T20:40:32.313Z", "updated_at": "2020-02-05T20:55:18.239Z", "description": "", "test_resource_enabled": false } ```