New APIs to manage object relations

You can now create, query, and delete relations between objects via the API. Relations can represent aliases or dependencies between boards and dashboards.

Query

• object_relations — retrieve relations for an object, filterable by kind (ALIAS or DEPENDENCY) and direction (OUTGOING or INCOMING)

query {
  object_relations(
    object_id: "123456"
    kind: DEPENDENCY
    direction: OUTGOING
  ) {
    id
    source_object_id
    target_id
    target_object_type
    kind
  }
}

Mutations

• create_object_relations — create one or more relations for a source object
• delete_object_relation — delete a specific relation or all relations for a source object

mutation {
  create_object_relations(
    source_object_id: "123456"
    relations: [
      { kind: DEPENDENCY, target_id: "789012", target_object_type: BOARD }
    ]
  ) {
    id
    kind
    target_id
  }
}

Additionally, the create_object mutation now accepts an optional relations argument to create relations at the same time as the object.