Sign in

v4

latestOpenAPI 3.1.02026-08-02261331761.5 KB
Resource Actions

List Resource Actions

Lists all the actions defined on the resource.

get/v2/schema/{proj_id}/{env_id}/resources/{resource_id}/actions

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").

Query parameters

pageinteger

Page number of the results to fetch, starting at 1.

Page number of the results to fetch, starting at 1.

per_pageinteger

The number of results per page (max 100).

The number of results per page (max 100).

Response

Successful Response

namestring required

The name of the action

descriptionstring

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

attributesobject

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

v1compat_pathstring
v1compat_is_built_inboolean
v1compat_namestring
keystring required

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

idstring uuid required

Unique id of the action

permission_namestring required

The name of the action, prefixed by the resource the action is acting upon.

organization_idstring uuid required

Unique id of the organization that the action belongs to.

project_idstring uuid required

Unique id of the project that the action belongs to.

environment_idstring uuid required

Unique id of the environment that the action belongs to.

resource_idstring uuid required

Unique id of the resource that the action belongs to.

created_atstring date-time required

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

updated_atstring date-time required

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

Example response

[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "key": "read",
    "name": "read",
    "permission_name": "document:read",
    "description": "read a document",
    "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"
  }
]