Harness

Project Role Assignments [Beta]

This contains APIs for Project-scoped Role Assignments.

List role assignments

Retrieves the information of the role assignments

Securityx-api-key
Request
path Parameters
org
required
string

Organization identifier

project
required
string

Project identifier

query Parameters
page
integer
Default: 0

Pagination page number strategy: Specify the page number within the paginated collection related to the number of items on each page.

limit
integer <= 100
Default: 30

Pagination: Number of items to return.

sort
string

Parameter on the basis of which sorting is done.

Enum: "identifier" "name" "created" "updated"
order
string

Order on the basis of which sorting is done.

Enum: "ASC" "DESC"
header Parameters
Harness-Account
string

Identifier field of the account the resource is scoped to.

Responses
200

Role Assignment List Response body

get/v1/orgs/{org}/projects/{project}/role-assignments
Request samples 
curl -i -X GET \
  'https://app.harness.io/v1/orgs/{org}/projects/{project}/role-assignments?page=0&limit=30&sort=identifier&order=ASC' \
  -H 'Harness-Account: string' \
  -H 'x-api-key: YOUR_API_KEY_HERE'
Response samples
[
  • {
    }
]

Create a role assignment

Create a role assignment

Securityx-api-key
Request
path Parameters
org
required
string

Organization identifier

project
required
string

Project identifier

header Parameters
Harness-Account
string

Identifier field of the account the resource is scoped to.

Request Body schema:
required

Role Request body

identifier
required
string

Role assignment identifier

resource_group
required
string

Resource group name

role
required
string

Role identifier

required
object (Principal)

Role assignment principal

disabled
boolean

Role assignment is disabled or not

managed
boolean

Role assignment is managed or not

Responses
201

Role assignment response body

post/v1/orgs/{org}/projects/{project}/role-assignments
Request samples
{
  • "identifier": "example_role_assignment",
  • "resource_group": "example_resource_group_identifier",
  • "role": "example_role_identifier",
  • "principal": {
    },
  • "disabled": false,
  • "managed": false
}
Response samples
{
  • "role-assignment": {
    },
  • "created": 1234567890,
  • "updated": 1234567890,
  • "harness_managaed": false
}

Retrieve a role assignment

Retrieves the information of the role assignment with the matching role assignment identifier.

Securityx-api-key
Request
path Parameters
role-assignment
required
string

Role assignment identifier

org
required
string

Organization identifier

project
required
string

Project identifier

header Parameters
Harness-Account
string

Identifier field of the account the resource is scoped to.

Responses
200

Role assignment response body

get/v1/orgs/{org}/projects/{project}/role-assignments/{role-assignment}
Request samples 
curl -i -X GET \
  'https://app.harness.io/v1/orgs/{org}/projects/{project}/role-assignments/{role-assignment}' \
  -H 'Harness-Account: string' \
  -H 'x-api-key: YOUR_API_KEY_HERE'
Response samples
{
  • "role-assignment": {
    },
  • "created": 1234567890,
  • "updated": 1234567890,
  • "harness_managaed": false
}

Delete a role assignment

Deletes the information of the role assignment with the matching role assignment identifier.

Securityx-api-key
Request
path Parameters
role-assignment
required
string

Role assignment identifier

org
required
string

Organization identifier

project
required
string

Project identifier

header Parameters
Harness-Account
string

Identifier field of the account the resource is scoped to.

Responses
200

Role assignment response body

delete/v1/orgs/{org}/projects/{project}/role-assignments/{role-assignment}
Request samples 
curl -i -X DELETE \
  'https://app.harness.io/v1/orgs/{org}/projects/{project}/role-assignments/{role-assignment}' \
  -H 'Harness-Account: string' \
  -H 'x-api-key: YOUR_API_KEY_HERE'
Response samples
{
  • "role-assignment": {
    },
  • "created": 1234567890,
  • "updated": 1234567890,
  • "harness_managaed": false
}
➔ Next to Accounts