Create components using the API

You can create components using the Compass GraphQL API by:

1. Logging into the GraphQL API explorer
2. Looking up the unique cloudId for your Atlassian site
3. Creating the new component using the cloudId

Log in to the GraphQL API explorer

1. Go to the GraphQL API explorer.
2. Log in with your Atlassian account if you are prompted to do so.

Look up the unique cloudId for your Atlassian site

1. In the GraphQL API explorer, enter this code into the query area on the left side:

   1
   2
   query getCloudId($hostName: String!) {
     tenantContexts(hostNames: [$hostName]) {
       cloudId
     }
   }
   

2. From the bottom left corner of the screen, select Query variables and enter this code, substituting the hostName value with your Atlassian site hostname:

   1
   2
   { "hostName": "your-site-hostname.atlassian.net" }
   

3. From the top navigation of the GraphQL API explorer, select Execute query
   • The cloudId for your site appears in the results area on the right side.
4. Copy the value of the cloudId to your clipboard.

Create a new component

Use the createComponent mutation to create the new component.

1. In the GraphQL API explorer, enter this code into the query area on the left side:

   1
   2
   mutation createComponent($cloudId: ID!, $componentDetails: CreateCompassComponentInput!) {
     compass {
       createComponent(cloudId: $cloudId, input: $componentDetails) {
         success
         componentDetails {
           id
           name
           typeId
         }
       }
     }
   }
   

2. From the bottom left corner of the screen, select Query variables and enter this code:

   1
   2
   {
     "cloudId": "your-cloudid",
     "componentDetails": {
       "name": "your-component-name",
       "typeId": "your-component-type"
     }
   }
   

3. Substitute your cloudId and the name of the new component.
4. Substitute the typeId with your component’s type. The valid values are SERVICE, LIBRARY, APPLICATION, CAPABILITY, CLOUD RESOURCE, DATA PIPELINE, MACHINE LEARNING MODEL, UI ELEMENT, WEBSITE, OTHER.
5. From the top navigation of the GraphQL API explorer, select Execute query
   • You'll see the id, name and typeId of your newly created component in the results area on the right side.

Troubleshooting

If you get an error when attempting to create the component, make sure you’ve provided:

• the entire cloudId for your Atlassian site and there are no typos
• values for name and typeId, which are both mandatory
• a valid option (SERVICE, LIBRARY, APPLICATION, CAPABILITY, CLOUD RESOURCE, DATA PIPELINE, MACHINE LEARNING MODEL, UI ELEMENT, WEBSITE, OTHER) for typeId

Learn more

You can perform numerous other operations using the Compass GraphQL API. To learn more, see the following resources:

• GraphQL API reference
• Get started building Compass apps