ByCloud Docs
GuidesCLIAPISDK
post/v1/iam/policies

Create policy

Create a new policy in the current organization

Request Body

required

Content-Type: application/json

name

stringrequired

description

stringoptional

document

objectrequired

IAM-style policy document

Responses

201

Policy created

Content-Type: application/json

policy

objectoptional
400

Invalid request parameters

Content-Type: application/json

error

objectrequired
401

Authentication required or token invalid

Content-Type: application/json

error

objectrequired
403

Insufficient permissions

Content-Type: application/json

error

objectrequired
409

Resource conflict (e.g., already exists, invalid state)

Content-Type: application/json

error

objectrequired
500

Internal server error

Content-Type: application/json

error

objectrequired
curl -X POST "https://api.spo1.mycloud.com/v1/iam/policies" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "S3BucketAccess",
"description": "string",
"document": {
"version": "2024-01-01",
"statements": [
{
"sid": "AllowS3Read",
"effect": "allow",
"actions": [
"s3:GetObject",
"s3:ListBucket"
],
"resources": [
"my-bucket/*",
"my-bucket"
],
"conditions": [
{
"operator": "equals",
"key": "s3:prefix",
"values": [
"home/",
"shared/"
]
}
]
}
]
}
}'