Update role

Update a role title, description and permissions.

Path Parameters

id string required

The role id to update.

application/json

Request Body required

name string
permissions string[]
metadata object
title string
scopes string[]

Responses

• 200
• 400
• 401
• 403
• 404
• 500
• default

---

A successful response.

application/json

Schema

Example (from schema)

---

Schema

role object
id string
name string
permissions string[]
title string
metadata object
created_at date-time
The time the role was created.
updated_at date-time
The time the role was last updated.
org_id string
state string
scopes string[]

{
  "role": {
    "id": "string",
    "name": "string",
    "permissions": [
      "string"
    ],
    "title": "string",
    "metadata": {},
    "created_at": "2023-06-07T05:39:56.961Z",
    "updated_at": "2023-06-07T05:39:56.961Z",
    "org_id": "string",
    "state": "string",
    "scopes": [
      "string"
    ]
  }
}

Bad Request - The request was malformed or contained invalid parameters.

application/json

Schema

Example (from schema)

---

Schema

code int32
message string
details object[]
Array [
@type string
]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

Unauthorized - Authentication is required

application/json

Schema

Example (from schema)

---

Schema

code int32
message string
details object[]
Array [
@type string
]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

Forbidden - User does not have permission to access the resource

application/json

Schema

Example (from schema)

---

Schema

code int32
message string
details object[]
Array [
@type string
]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

Not Found - The requested resource was not found

application/json

Schema

Example (from schema)

---

Schema

code int32
message string
details object[]
Array [
@type string
]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

Internal Server Error. Returned when theres is something wrong with Frontier server.

application/json

Schema

Example (from schema)

---

Schema

code int32
message string
details object[]
Array [
@type string
]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

An unexpected error response.

application/json

Schema

Example (from schema)

---

Schema

code int32
message string
details object[]
Array [
@type string
]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

PUT /v1beta1/roles/:id

Authorization

name: Basic type: httpdescription: use Client ID as username and Client Secret as passwordin: headerscheme: basic

Request

Base URL

http://127.0.0.1:7400

Security Scheme

BasicBearer

Username

Password

id — path required

Body required

{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}

curl / cURL

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'

python / requests

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'

go / native

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'

nodejs / axios

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'

ruby / Net::HTTP

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'

csharp / RestSharp

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'

php / cURL

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'

java / OkHttp

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'

powershell / RestMethod

curl -L -X PUT 'http://127.0.0.1:7400/v1beta1/roles/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "permissions": [
    "string"
  ],
  "metadata": {},
  "title": "string",
  "scopes": [
    "string"
  ]
}'