Sign in
Resources

Replace Resource

Replaces the resource definition, or creates it if it doesn't exist.

  • If some actions are removed or renamed from the resource definition, role and permissions assignments for these actions will be revoked.
put/v2/schema/{proj_id}/{env_id}/resources/{resource_id}

Path parameters

resource_idstring required

Either the unique id of the resource, or the URL-friendly key of the resource (i.e: the "slug").

Either the unique id of the resource, or the URL-friendly key of the resource (i.e: the "slug").

proj_idstring required

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

env_idstring required

Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

Request body

namestring required

The name of the resource

urnstring

The URN (Uniform Resource Name) of the resource

descriptionstring

An optional longer description of what this resource respresents in your system

actionsobject required
    A actions definition block, typically contained within a resource type definition block.
    The actions represents the ways you can interact with a protected resource.
type_attributesobject

optional dictionary of key-value pairs that can be used to store arbitrary metadata about this resource. This metadata can be used to filter resource using query parameters with attr_ prefix

attributesobject

Attributes that each resource of this type defines, and can be used in your ABAC policies.

rolesobject

Roles defined on this resource. The key is the role name, and the value contains the role properties such as granted permissions, base roles, etc.

relationsobject

Relations to other resources. The key is the relation key, and the value is the related resource.

v1compat_pathstring
v1compat_typestring
v1compat_namestring

Response

Successful Response

keystring required

A URL-friendly name of the resource (i.e: slug). You will be able to query later using this key instead of the id (UUID) of the resource.

idstring uuid required

Unique id of the resource

organization_idstring uuid required

Unique id of the organization that the resource belongs to.

project_idstring uuid required

Unique id of the project that the resource belongs to.

environment_idstring uuid required

Unique id of the environment that the resource belongs to.

created_atstring date-time required

Date and time when the resource was created (ISO_8601 format).

updated_atstring date-time required

Date and time when the resource was last updated/modified (ISO_8601 format).

namestring required

The name of the resource

urnstring

The URN (Uniform Resource Name) of the resource

descriptionstring

An optional longer description of what this resource respresents in your system

actionsobject 
    A actions definition block, typically contained within a resource type definition block.
    The actions represents the ways you can interact with a protected resource.
type_attributesobject

optional dictionary of key-value pairs that can be used to store arbitrary metadata about this resource. This metadata can be used to filter resource using query parameters with attr_ prefix

attributesobject

Attributes that each resource of this type defines, and can be used in your ABAC policies.

rolesobject

Roles defined on this resource. The key is the role name, and the value contains the role properties such as granted permissions, etc.

relationsobject 
    A relations definition block, typically contained within a resource type definition block.
    The relations represents the ways you can interact with a protected resource.
v1compat_pathstring
v1compat_typestring
v1compat_namestring
action_groupsobject

Example response

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
  "environment_id": "40ef0e48-a11f-4963-a229-e396c9f7e7c4",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "key": "repository",
  "name": "Repository",
  "urn": "prn:github:scm:repository",
  "description": "a git repository stored on github",
  "actions": {
    "clone": {
      "id": "90e21d70-2b1b-42f0-b492-8fd69c1d79d1"
    },
    "read": {
      "id": "2bc27751-6115-43c0-b68c-928cb46e34bc"
    },
    "push": {
      "id": "e06da336-6e03-41d6-a495-40b0d7537b2a"
    }
  },
  "roles": {
    "maintainer": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "key": "maintainer",
      "name": "Maintainer",
      "description": "the maintainer role can read from the repo and push changes",
      "permissions": [
        "push"
      ],
      "extends": [
        "contributor"
      ],
      "resource": "repo",
      "granted_to": {
        "id": "457c1631-ebb1-49ec-8081-298dd9b13e85",
        "users_with_role": [
          {
            "role": "Admin",
            "on_resource": "organization",
            "linked_by_relation": "owner",
            "role_id": "eb139d88-5823-4236-95d8-218bdbc18b4c",
            "resource_id": "21c27e31-adbe-478e-95c3-5dc89303578a",
            "relation_id": "816586bb-3733-45b9-ae97-d40507d03664"
          }
        ]
      },
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
      "environment_id": "40ef0e48-a11f-4963-a229-e396c9f7e7c4",
      "resource_id": "40ef0e48-a11f-4963-a229-e396c9f7e7dd",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  },
  "relations": {
    "parent": {
      "resource_id": "01dc1396-4b1c-4294-889a-e6517d11e835",
      "relation_name": "parent",
      "resource": "parent-resource"
    }
  },
  "attributes": {
    "created": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f11",
      "type": "time",
      "description": "the time (timestamp) the repository was created"
    },
    "private": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f22",
      "type": "bool",
      "description": "whether the repo is private (if false, the repo is public)"
    }
  }
}

Changes

No recorded changes to this endpoint across all 10 revisions of this API.