Skip to main content

Use API to Retrieve IDs by Name

You can retrieve applicationId, userIds, and userGroupId object IDs (respectively) by using the applicationByName, userByName, and userGroupByName operations. Each of these queries takes a required name argument, as a string.

Below are the sample queries for each of these retrieval operations. It is followed by round-trip examples of looking up an ID by name and then passing it as an argument to a second query.

Before You Begin

Fetch Application ID by Name

Use this sample query to get the applicationId for a Harness Application.

Request

{  
applicationByName(name:"Harness Sample App") {
id
}
}

Response

{  
"data": {
"applicationByName": {
"id": "-XZGAqR6QIeBRXz-VuwIzA"
}
}
}

Fetch User ID and Details by Name

Use this sample query to retrieve the userGroupId value for a Harness User and to confirm the user's name and email verification status.

Request

{  
userByName(name:"test"){
name
id
isEmailVerified
}
}

Response

{  
"data": {
"userByName": {
"name": "test",
"id": "XlbrFu5ARfGlpxfMFgE_Tw",
"isEmailVerified": true
}
}
}

Fetch User Group ID by Name

Use this sample query to retrieve the userGroupId value for a Harness User Group and to confirm the group's name.

Request

{  
userGroupByName(name:"Account Administrator"){
name
id
}
}

Response

{  
"data": {
"userGroupByName": {
"name": "Account Administrator",
"id": "yeaF0GXZR9KzH2VViRdazg"
}
}
}

Round-Trip Example

After using one of the above queries to obtain an object's ID, you can pass this ID to queries that require an ID argument.

Use this sample query to get the applicationId .

Request

{  
applicationByName(name:"Harness Sample App") {
id
}
}

Response

{  
"data": {
"applicationByName": {
"id": "xkZzxocSQ3-ne2m92mUVQw"
}
}
}

Use the returned id as the applicationId argument in a query for fetching the list of Workflows in this Application.

Request

{  
workflows(filters: {application: {values: ["xkZzxocSQ3-ne2m92mUVQw"], operator: IN}}, limit: 5) {
nodes {
id
name
createdAt
}
}
}

Response

{  
"data": {
"workflows": {
"nodes": [
{
"id": "xqZzrmcSQ3-ne2m53mUVQw",
"name": "Verification Service-simple",
"createdAt": 1582246743673
},
{
"id": "iPLNQBZATYKEB9Lgx_JyJQ",
"name": "Redis Sentinel PR",
"createdAt": 1581945346231
}
]
}
}
}