Global resources (v1)

Create a resource

For a test resource used in TEST mode of change control, provide live_resource_id; the other optional values then default to those of the specified live resource.

post/api/v1/global_resources

Request

  • Base URL: https://your-tenant.tines.com
  • URL: https://your-tenant.tines.com/api/v1/global_resources
  • Auth: one of:
    • API key in header X-User-Token
    • HTTP bearer

Request body

namestring required

Name of the resource

valuestring required

Contents of the resource. A non-JSON string is parsed as regular text; pass a JSON object or array for a JSON resource

team_idinteger required

ID of the team where the resource will be located

folder_idinteger

ID of the folder where the resource will be located

read_access'TEAM' | 'GLOBAL' | 'SPECIFIC_TEAMS'

Where this resource can be used (defaults to TEAM). SPECIFIC_TEAMS is a premium feature

shared_team_slugsstring[]

Teams' slugs where this resource can be used. Required to set read_access to SPECIFIC_TEAMS (defaults to [])

descriptionstring

Description of the resource (defaults to "")

live_resource_idinteger

ID of the live resource that this new test value corresponds to

include_referencing_action_idsboolean

Defaults to true. When false, referencing_action_ids is excluded from the response

typed_valueboolean

Defaults to false. When true, returns properly typed values (boolean, number, array, object) instead of strings

Response

Successful response

idinteger

Resource ID

namestring

Name of the resource

valuestring

Value of the resource. By default a string representation; use typed_value=true for properly typed values

team_idinteger

ID of team to which the resource belongs

folder_idinteger nullable

ID of folder to which the resource belongs

user_idinteger

ID of user associated with the resource

read_accessstring

Where this resource can be used (TEAM, GLOBAL, SPECIFIC_TEAMS)

shared_team_slugsstring[]

Teams' slugs where this resource can be used when read_access is SPECIFIC_TEAMS, otherwise empty

slugstring

An underscored representation of the resource name

created_atstring

When the resource was created

updated_atstring

When the resource was last updated

descriptionstring

Description of the resource

test_resource_enabledboolean

Whether the resource is enabled for using a test resource

test_resourceobject nullable

The test resource (value, created_at, updated_at), present only when test_resource_enabled is true

referencing_action_idsinteger[]

IDs of actions that reference the resource. Excluded when include_referencing_action_ids is false

Changes

No recorded changes to this operation across all 1 revision of this API.