Release 19.0 240419.19.0

This update brings more power to integrations by adding new endpoints for integration management and unlocks new integration features in the Skylark UI.

Features

Upsert request

An optional upsert argument has been added to the update mutation.

mutation upsertMutation {
  updateMovie(external_id: "movie1", upsert: true, movie: {
    title: "Upserted movie",
    synopsis: "This movie will be upserted"
  }) {
    uid
  }
}

If a movie with the matching external_id is found, it will be updated. If not, then a new movie will be created.

Integration updates

We've added new features to our integration service to help manage your integrations. These new features include:

View available integrations

Fetch a list of all the potential integrations available to you, including information on whats required to enable that integration.

Example response:

{
    "image": {
        "cloudinary": [
            {
                "additional_required_fields": [
                    "cloud_name"
                ],
                "description": "Cloudinary image integration",
                "documentation_link": "https://docs.skylarkplatform.com/docs/cloudinary-integration"
            }
        ]
    },
    "video": {
        "mux": [
            {
                "additional_required_fields": [
                    "mux_api_access_key",
                    "mux_api_secret_key"
                ],
                "description": "Mux video integration",
                "documentation_link": "https://docs.skylarkplatform.com/docs/mux-integration"
            }
        ]
    }
}

View enabled integrations, including fetching your webhook token

Fetch a list of all integrations you've configured. This will show whether the integration is enabled and show the token to use in your webhook urls.

Example:

{
    "image": {
        "cloudinary": {
            "created": "2024-04-19T09:39:06.714945",
            "enabled": true,
            "modified": "2024-04-19T09:39:06.714961",
            "token": "d9b9b0d8-71c3-4e11-8e0c-be41475d0b0b"
        }
    },
    "video": {
        "mux": {
            "created": "2024-04-19T09:42:49.285081",
            "enabled": true,
            "modified": "2024-04-19T09:42:49.285093",
            "token": "3bbc467d-bb4d-4427-b827-615291b7e508"
        }
    }
}

Delete or disable integrations

Sending a DELETE request to the path /<integration_type>/<provider> (for example /video/mux) allows you to disable that integration. When an integration is disabled, any incoming webhooks from that provider will be ignored.

Sending the same request again to a disabled integration will delete it entirely.