Get Policy

curl --request GET \
  --url https://api.stackone.com/unified/iam/policies/{id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'x-account-id: <x-account-id>'

{
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "name": "Remote Contractor Policy",
    "permissions": [
      {
        "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "name": "read:users",
        "type": {
          "value": "read_write",
          "source_value": "<string>"
        },
        "resources": [
          {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "name": "Company History Records",
            "location": "s3://bucket-name/folder-name",
            "type": {
              "value": "file",
              "source_value": "<string>"
            },
            "description": "<string>",
            "created_at": "2021-01-01T01:01:01.000Z",
            "updated_at": "2021-01-01T01:01:01.000Z"
          }
        ],
        "description": "<string>",
        "created_at": "2021-01-01T01:01:01.000Z",
        "updated_at": "2021-01-01T01:01:01.000Z"
      }
    ],
    "description": "<string>",
    "created_at": "2021-01-01T01:01:01.000Z",
    "updated_at": "2021-01-01T01:01:01.000Z"
  },
  "raw": [
    {
      "method": "<string>",
      "url": "<string>",
      "body": {},
      "response": {}
    }
  ]
}

GET

unified

iam

policies

{id}

Get Policy

curl --request GET \
  --url https://api.stackone.com/unified/iam/policies/{id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'x-account-id: <x-account-id>'

{
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "name": "Remote Contractor Policy",
    "permissions": [
      {
        "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "name": "read:users",
        "type": {
          "value": "read_write",
          "source_value": "<string>"
        },
        "resources": [
          {
            "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
            "name": "Company History Records",
            "location": "s3://bucket-name/folder-name",
            "type": {
              "value": "file",
              "source_value": "<string>"
            },
            "description": "<string>",
            "created_at": "2021-01-01T01:01:01.000Z",
            "updated_at": "2021-01-01T01:01:01.000Z"
          }
        ],
        "description": "<string>",
        "created_at": "2021-01-01T01:01:01.000Z",
        "updated_at": "2021-01-01T01:01:01.000Z"
      }
    ],
    "description": "<string>",
    "created_at": "2021-01-01T01:01:01.000Z",
    "updated_at": "2021-01-01T01:01:01.000Z"
  },
  "raw": [
    {
      "method": "<string>",
      "url": "<string>",
      "body": {},
      "response": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

x-account-id

string

required

The account identifier

Path Parameters

string

required

Query Parameters

raw

boolean | null

Indicates that the raw request result should be returned in addition to the mapped result (default value is false)

proxy

object

Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key

fields

string | null

The comma separated list of fields that will be returned in the response (if empty, all fields are returned)

Example:

"id,remote_id,name,permissions,description,created_at,updated_at,unified_custom_fields"

expand

string | null

The comma separated list of fields that will be expanded in the response

Example:

"permissions"

Response

The policy with the given identifier was retrieved.

data

object

required

Show child attributes

data.id

string | null

Unique identifier

Example:

"8187e5da-dc77-475e-9949-af0f1fa4e4e3"

data.remote_id

string | null

Provider's unique identifier

Example:

"8187e5da-dc77-475e-9949-af0f1fa4e4e3"

data.name

string | null

The name of the policy.

Example:

"Remote Contractor Policy"

data.permissions

object[] | null

The set of permissions associated with the policy.

Show child attributes

data.permissions.id

string | null

Unique identifier

Example:

"8187e5da-dc77-475e-9949-af0f1fa4e4e3"

data.permissions.remote_id

string | null

Provider's unique identifier

Example:

"8187e5da-dc77-475e-9949-af0f1fa4e4e3"

data.permissions.name

string | null

The name of the permission.

Example:

"read:users"

data.permissions.type

object

Show child attributes

data.permissions.type.value

enum<string> | null

The type of the permission, e.g. read, read_write, delete, etc.

Available options:

read,

read_write,

approve,

delete,

use,

export,

unmapped_value,

Example:

"read_write"

data.permissions.type.source_value

data.permissions.resources

object[] | null

The resources that the permission applies to.

Show child attributes

data.permissions.resources.id

string | null

Unique identifier

Example:

"8187e5da-dc77-475e-9949-af0f1fa4e4e3"

data.permissions.resources.remote_id

string | null

Provider's unique identifier

Example:

"8187e5da-dc77-475e-9949-af0f1fa4e4e3"

data.permissions.resources.name

string | null

The name of the resource.

Example:

"Company History Records"

data.permissions.resources.location

string | null

The location of the resource.

Example:

"s3://bucket-name/folder-name"

data.permissions.resources.type

object

Show child attributes

data.permissions.resources.type.value

enum<string> | null

The type of the resource, e.g. user, group, permission, etc.

Available options:

project,

file,

folder,

product,

property,

user,

unmapped_value,

Example:

"file"

data.permissions.resources.type.source_value

data.permissions.resources.description

string | null

data.permissions.resources.created_at

string<date-time> | null

Example:

"2021-01-01T01:01:01.000Z"

data.permissions.resources.updated_at

string<date-time> | null

Example:

"2021-01-01T01:01:01.000Z"

data.permissions.description

string | null

data.permissions.created_at

string<date-time> | null

Example:

"2021-01-01T01:01:01.000Z"

data.permissions.updated_at

string<date-time> | null

Example:

"2021-01-01T01:01:01.000Z"

data.description

string | null

data.created_at

string<date-time> | null

Example:

"2021-01-01T01:01:01.000Z"

data.updated_at

string<date-time> | null

Example:

"2021-01-01T01:01:01.000Z"

raw

object[] | null

Show child attributes

raw.method

string

required

raw.url

string

required

raw.body

object

raw.response

List Policies

⌘I

Getting Started

API Reference

Get Policy

Authorizations

Headers

Path Parameters

Query Parameters

Response