Download OpenAPI specification:Download
Welcome to the CloudQuery API documentation! This API can be used to interact with the CloudQuery platform. The API allows you to manage your teams, usage, spend limits, plugins, addons, cloud syncs, and much more.
The API is secured using bearer tokens. To get started, you can generate an API key from the CloudQuery dashboard. For a step-by-step guide, see: https://docs.cloudquery.io/docs/deployment/generate-api-key.
The base URL for the API is https://api.cloudquery.io
.
Get the current authenticated user from the OAuth token
{- "created_at": "2017-07-14T16:53:42Z",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "email": "user@example.com",
- "name": "Sarah O'Connor",
- "updated_at": "2017-07-14T16:53:42Z",
- "profile_image_url": "string"
}
Update attributes for the current authenticated user from the OAuth token
name | string (UserName) [ 1 .. 255 ] characters ^[a-zA-Z\p{L}][a-zA-Z\p{L} \-']*$ The unique name for the user. |
{- "name": "Sarah O'Connor"
}
{- "created_at": "2017-07-14T16:53:42Z",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "email": "user@example.com",
- "name": "Sarah O'Connor",
- "updated_at": "2017-07-14T16:53:42Z",
- "profile_image_url": "string"
}
Start a session using ID token
id_token required | string |
{- "id_token": "string"
}
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
Reset user password from email
email required | string <email> Email address to reset |
subdomain | string^[a-zA-Z0-9-]+$ Subdomain to use in the URL |
{- "email": "user@example.com",
- "subdomain": "string"
}
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
List of the current user's unaccepted invitations
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "team_name": "cloudquery",
- "email": "user@example.com",
- "role": "admin",
- "created_at": "2017-07-14T16:53:42Z",
- "token": "b5507016-7da2-4777-a161-1e8042a6a377"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Get memberships that the user has accepted.
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "role": "admin",
- "team": {
- "created_at": "2017-07-14T16:53:42Z",
- "name": "cloudquery",
- "display_name": "CloudQuery",
- "plan": "free",
- "is_trial_active": false,
- "internal": false
}
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
List all teams
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "created_at": "2017-07-14T16:53:42Z",
- "name": "cloudquery",
- "plan": "free",
- "plan_end_time": "2017-07-14T16:53:42Z",
- "is_trial_active": false,
- "trial_end_time": "2017-07-14T16:53:42Z",
- "display_name": "CloudQuery",
- "internal": false
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create a team owned by the current user.
name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the team. |
display_name required | string [ 1 .. 255 ] characters The team's display name |
{- "name": "cloudquery",
- "display_name": "string"
}
{- "created_at": "2017-07-14T16:53:42Z",
- "name": "cloudquery",
- "plan": "free",
- "plan_end_time": "2017-07-14T16:53:42Z",
- "is_trial_active": false,
- "trial_end_time": "2017-07-14T16:53:42Z",
- "display_name": "CloudQuery",
- "internal": false
}
Get a team by name
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
{- "created_at": "2017-07-14T16:53:42Z",
- "name": "cloudquery",
- "plan": "free",
- "plan_end_time": "2017-07-14T16:53:42Z",
- "is_trial_active": false,
- "trial_end_time": "2017-07-14T16:53:42Z",
- "display_name": "CloudQuery",
- "internal": false
}
Update team attributes
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
display_name | string The team's display name |
{- "display_name": "string"
}
{- "created_at": "2017-07-14T16:53:42Z",
- "name": "cloudquery",
- "plan": "free",
- "plan_end_time": "2017-07-14T16:53:42Z",
- "is_trial_active": false,
- "trial_end_time": "2017-07-14T16:53:42Z",
- "display_name": "CloudQuery",
- "internal": false
}
Get URLs to upload images for a given team
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
required | Array of objects (Create Team Image Request) non-empty |
{- "images": [
- {
- "name": "string",
- "checksum": "stringstringstringstringstringstringstri",
- "content_type": "image/png"
}
]
}
{- "items": [
- {
- "name": "string",
- "checksum": "string",
- "url": "string",
- "upload_url": "string",
- "required_headers": {
- "property1": [
- "string"
], - "property2": [
- "string"
]
}
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Get memberships to the team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "role": "admin",
- "user": {
- "created_at": "2017-07-14T16:53:42Z",
- "email": "user@example.com",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "name": "Sarah O'Connor",
- "updated_at": "2017-07-14T16:53:42Z"
}
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Remove a user from the team
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
email required | string |
{- "email": "string"
}
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
Remove a user from the team
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
email required | string Example: user@example.com |
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
Get monthly spending limit for team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
{- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "usd": 1000
}
Create a spending limit for a team
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
usd required | integer [ 0 .. 1000000000 ] The maximum USD amount the team is allowed to use within a calendar month. |
{- "usd": 1000
}
{- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "usd": 1000
}
Update a spending limit for a team
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
usd required | integer [ 0 .. 1000000000 ] The maximum USD amount the team is allowed to use within a calendar month. |
{- "usd": 1000
}
{- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "usd": 1000
}
Delete a spending limit for a team
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
{- "message": "string",
- "status": 0
}
List all past invoices for the team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "created_at": "2017-07-14T16:53:42Z",
- "amount_due": 1000,
- "currency": "usd",
- "paid": true
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
List plugin usage for the current calendar month.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws-source",
- "rows": 1000000,
- "usd": "43.95",
- "remaining_usd": "56.05",
- "remaining_rows": 1
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Increase the usage of a plugin. This can incur billing costs and should be used only by plugin SDKs.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_team required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the plugin. |
Array of objects | |
rows required | integer >= 0 The total number of additional rows used by the plugin. |
request_id required | string <uuid> A unique ID associated with the usage increase. |
{- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws-source",
- "tables": [
- {
- "name": "my_table",
- "rows": 100
}
], - "rows": 1000000,
- "request_id": "123e4567-e89b-12d3-a456-426614174000"
}
{- "message": "string",
- "status": 0
}
Get plugin usage for the current calendar month.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_team required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
{- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws-source",
- "rows": 1000000,
- "usd": "43.95",
- "remaining_usd": "56.05",
- "remaining_rows": 1
}
Get a summary of usage for the specified time range.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
metrics | Array of strings Default: "paid_rows" Items Enum: "paid_rows" "cloud_vcpu_seconds" "cloud_vram_byte_seconds" "network_egress_bytes" A list of metrics to include in the response. Each metric must be one of the predefined valid values. If not provided, only |
start | string <date-time> A valid ISO-8601-formatted date and time, indicating the inclusive start of the query time range. Defaults to 30 days ago. |
end | string <date-time> A valid ISO-8601-formatted date and time, indicating the exclusive end of the query time range. Defaults to the current time. |
aggregation_period | string Default: "day" Enum: "day" "month" An aggregation period to sum data over. In other words, data will be returned at this granularity. Currently only supports day and month. |
{- "groups": [
- {
- "name": "plugin",
- "value": "cloudquery/source/aws"
}, - {
- "name": "plugin",
- "value": "cloudquery/source/gcp"
}
], - "values": [
- {
- "timestamp": "2021-01-01T00:00:00Z",
- "paid_rows": [
- 100,
- 200
]
}, - {
- "timestamp": "2021-01-02T00:00:00Z",
- "paid_rows": [
- 150,
- 300
]
}
], - "metadata": {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z",
- "aggregation_period": "day",
- "metrics": [
- "paid_rows"
]
}
}
Get a grouped summary of usage for the specified time range.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
group_by required | string Enum: "price_category" "plugin" "sync_id" Group by usage summary. |
metrics | Array of strings Default: "paid_rows" Items Enum: "paid_rows" "cloud_vcpu_seconds" "cloud_vram_byte_seconds" "network_egress_bytes" A list of metrics to include in the response. Each metric must be one of the predefined valid values. If not provided, only |
start | string <date-time> A valid ISO-8601-formatted date and time, indicating the inclusive start of the query time range. Defaults to 30 days ago. |
end | string <date-time> A valid ISO-8601-formatted date and time, indicating the exclusive end of the query time range. Defaults to the current time. |
aggregation_period | string Default: "day" Enum: "day" "month" An aggregation period to sum data over. In other words, data will be returned at this granularity. Currently only supports day and month. |
{- "groups": [
- {
- "name": "plugin",
- "value": "cloudquery/source/aws"
}, - {
- "name": "plugin",
- "value": "cloudquery/source/gcp"
}
], - "values": [
- {
- "timestamp": "2021-01-01T00:00:00Z",
- "paid_rows": [
- 100,
- 200
]
}, - {
- "timestamp": "2021-01-02T00:00:00Z",
- "paid_rows": [
- 150,
- 300
]
}
], - "metadata": {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z",
- "aggregation_period": "day",
- "metrics": [
- "paid_rows"
]
}
}
Get team spend for defined period.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
start | string <date-time> A valid ISO 8601 date string representing the inclusive start of the period. |
end | string <date-time> A valid ISO 8601 date string representing the exclusive end of the period. |
{- "values": [
- {
- "date": "2019-08-24T14:15:22Z",
- "by_category": [
- {
- "category": "api",
- "total": "string"
}
], - "total": "string"
}
], - "metadata": {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z"
}
}
List of open invitations to the team
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "team_name": "cloudquery",
- "email": "user@example.com",
- "role": "admin",
- "created_at": "2017-07-14T16:53:42Z"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Invite a user to join a team with their email address
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
email required | string <email> |
role required | string Enum: "admin" "member" |
{- "email": "user@example.com",
- "role": "admin"
}
{- "team_name": "cloudquery",
- "email": "user@example.com",
- "role": "admin",
- "created_at": "2017-07-14T16:53:42Z"
}
Delete an invitation to the team, preventing the user becoming a team member
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
email required | string <email> |
{- "email": "user@example.com"
}
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
Accept an invitation to the team, creating a user membership
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
token required | string <uuid> |
{- "token": "b5507016-7da2-4777-a161-1e8042a6a377"
}
{- "role": "admin",
- "team": {
- "created_at": "2017-07-14T16:53:42Z",
- "name": "cloudquery",
- "plan": "free",
- "plan_end_time": "2017-07-14T16:53:42Z",
- "is_trial_active": false,
- "trial_end_time": "2017-07-14T16:53:42Z",
- "display_name": "CloudQuery",
- "internal": false
}
}
Cancel an invitation to the team, preventing the user becoming a team member
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
email required | string Example: user@example.com |
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
List all subscription orders for the team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "id": "12345678-1234-1234-1234-1234567890ab",
- "team_name": "cloudquery",
- "plan": "free",
- "status": "pending",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Start the checkout process for a subscription order.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plan required | string (TeamPlan) Enum: "free" "paid" "enterprise" "trial" The plan the team is on (trial is deprecated) |
success_url required | string URL to redirect to after successful order completion |
cancel_url required | string URL to redirect to after order cancellation |
{- "plan": "free",
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "team_name": "cloudquery",
- "plan": "free",
- "status": "pending",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
}
Get a subscription order for the team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
subscription_order_id required | string <uuid> (TeamSubscriptionOrderID) Example: 12345678-1234-1234-1234-1234567890ab ID of the team subscription order |
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "team_name": "cloudquery",
- "plan": "free",
- "status": "pending",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
}
List all users in the current team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "created_at": "2017-07-14T16:53:42Z",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "email": "user@example.com",
- "name": "Sarah O'Connor",
- "updated_at": "2017-07-14T16:53:42Z",
- "profile_image_url": "string"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
List all team API Keys
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "name": "cli-api-key",
- "created_by": "user@example.com",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "key": "1234567890abcdef1234567890abcdef",
- "created_at": "2017-07-14T16:53:42Z",
- "expires_at": "2017-07-14T16:53:42Z",
- "last_access_at": "2017-07-14T16:53:42Z",
- "expired": false,
- "scope": "read-and-write"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create new team API Key.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
name required | string (APIKeyName) [ 1 .. 255 ] characters ^(?:[a-zA-Z0-9][a-zA-Z0-9- ]*)?[a-zA-Z0-9]$ Name of the API key |
expires_at required | string <date-time> |
{- "name": "cli-api-key",
- "expires_at": "2019-08-24T14:15:22Z"
}
{- "name": "cli-api-key",
- "created_by": "user@example.com",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "key": "1234567890abcdef1234567890abcdef",
- "created_at": "2017-07-14T16:53:42Z",
- "expires_at": "2017-07-14T16:53:42Z",
- "last_access_at": "2017-07-14T16:53:42Z",
- "expired": false,
- "scope": "read-and-write"
}
Delete API Key. This will remove any future access by this API Key.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
apikey_id required | string <uuid> (APIKeyID) Example: 12345678-1234-1234-1234-1234567890ab ID of the API key |
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
List all plugin notification requests
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws-source",
- "created_at": "2017-07-14T16:53:42Z",
- "sent_at": "2017-07-14T16:53:42Z",
- "status": "pending"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create a new plugin notification request.
plugin_team required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the plugin. |
{- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws-source"
}
{- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws-source",
- "created_at": "2017-07-14T16:53:42Z",
- "sent_at": "2017-07-14T16:53:42Z",
- "status": "pending"
}
Query plugin notification request for a given plugin.
plugin_team required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
{- "items": [
- {
- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws-source",
- "created_at": "2017-07-14T16:53:42Z",
- "sent_at": "2017-07-14T16:53:42Z",
- "status": "pending"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Remove plugin notification request for a given plugin.
plugin_team required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
{- "message": "string",
- "status": 0
}
List all plugins
sort_by | string Enum: "created_at" "updated_at" "name" "downloads" The field to sort by |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "name": "aws",
- "kind": "source",
- "team_name": "cloudquery",
- "display_name": "AWS Source Plugin",
- "category": "cloud-infrastructure",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "official": true,
- "short_description": "Sync data from AWS to any destination",
- "tier": "paid",
- "usd_per_row": "0.00123",
- "free_rows_per_month": 10000,
- "release_stage": "preview"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create a plugin owned by the specified team. User must be part of that team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the team. |
kind required | string (PluginKind) Enum: "source" "destination" "transformer" The kind of plugin, ie. source or destination. |
name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the plugin. |
category required | string (PluginCategory) Enum: "cloud-infrastructure" "databases" "sales-marketing" "engineering-analytics" "marketing-analytics" "shipment-tracking" "product-analytics" "cloud-finops" "project-management" "fleet-management" "security" "data-warehouses" "human-resources" "finance" "customer-support" "other" Supported categories for plugins |
price_category | string (PluginPriceCategory) Enum: "api" "database" "free" Supported price categories for billing |
tier | string (PluginTier) Deprecated Enum: "free" "paid" "open-core" This field is deprecated, refer to
|
display_name required | string [ 1 .. 50 ] characters The plugin's display name, as shown in the CloudQuery Hub. |
short_description required | string [ 1 .. 512 ] characters Short description of the plugin. This will be shown in the CloudQuery Hub. |
homepage | string |
public required | boolean Whether the plugin is listed in the CloudQuery Hub. If false, the plugin will not be shown in the CloudQuery Hub and will only be visible to members of the team. |
repository | string |
release_stage | string (PluginReleaseStageCreate) Enum: "coming-soon" "preview" "ga" Official plugins can go through three release stages: Coming Soon, Preview, and GA. The Coming Soon stage is for plugins that are not yet ready for Preview, but users can subscribe to be notified when they are ready. Both Preview and GA plugins follow semantic versioning. The main differences between the two stages are: Preview plugins are still experimental and may have frequent breaking changes. Preview plugins might get deprecated due to lack of usage. Long Term Support with community Discord and bug fixes is only guaranteed for GA plugins. Premium plugins are often discounted or free during the Preview stage. |
logo | string^https:\/\/storage\.googleapis\.com\/cq-cloud... URL to the plugin's logo. This will be shown in the CloudQuery Hub. |
usd_per_row | string^\d+(?:\.\d{1,10})?$ Deprecated Deprecated. Use |
free_rows_per_month | integer <int64> Deprecated Deprecated. Use |
{- "team_name": "cloudquery",
- "kind": "source",
- "name": "aws-source",
- "category": "cloud-infrastructure",
- "price_category": "api",
- "tier": "free",
- "display_name": "AWS Source Plugin",
- "short_description": "Sync data from AWS to any destination",
- "public": true,
- "release_stage": "coming-soon",
- "usd_per_row": "0.00001",
- "free_rows_per_month": 10000
}
{- "team_name": "cloudquery",
- "name": "aws-source",
- "kind": "source",
- "category": "cloud-infrastructure",
- "price_category": "api",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "display_name": "AWS Source Plugin",
- "official": true,
- "release_stage": "coming-soon",
- "short_description": "Sync data from AWS to any destination",
- "tier": "free",
- "public": true,
- "usd_per_row": "0.0001",
- "free_rows_per_month": 1000,
- "minimum_cloud_version": "v1.2.3"
}
Get details about a given plugin.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
{- "team_name": "cloudquery",
- "name": "aws-source",
- "kind": "source",
- "category": "cloud-infrastructure",
- "price_category": "api",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "display_name": "AWS Source Plugin",
- "official": true,
- "release_stage": "coming-soon",
- "short_description": "Sync data from AWS to any destination",
- "tier": "free",
- "public": true,
- "usd_per_row": "0.0001",
- "free_rows_per_month": 1000,
- "minimum_cloud_version": "v1.2.3",
- "latest_version": "string"
}
Update a plugin
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
category | string (PluginCategory) Enum: "cloud-infrastructure" "databases" "sales-marketing" "engineering-analytics" "marketing-analytics" "shipment-tracking" "product-analytics" "cloud-finops" "project-management" "fleet-management" "security" "data-warehouses" "human-resources" "finance" "customer-support" "other" Supported categories for plugins |
price_category | string (PluginPriceCategory) Enum: "api" "database" "free" Supported price categories for billing |
tier | string (PluginTier) Deprecated Enum: "free" "paid" "open-core" This field is deprecated, refer to
|
display_name | string [ 1 .. 50 ] characters The plugin's display name, as shown in the CloudQuery Hub. |
short_description | string [ 1 .. 512 ] characters Short description of the plugin. This will be shown in the CloudQuery Hub. |
homepage | string |
repository | string |
logo | string^(https:\/\/storage\.googleapis\.com\/cq-clou... URL to the plugin's logo. This will be shown in the CloudQuery Hub. |
public | boolean If plugin is not public, it won't be visible to other teams in the CloudQuery Hub. |
release_stage | string (PluginReleaseStageUpdate) Enum: "coming-soon" "preview" "ga" Official plugins can go through three release stages: Coming Soon, Preview, and GA. The Coming Soon stage is for plugins that are not yet ready for Preview, but users can subscribe to be notified when they are ready. Both Preview and GA plugins follow semantic versioning. The main differences between the two stages are: Preview plugins are still experimental and may have frequent breaking changes. Preview plugins might get deprecated due to lack of usage. Long Term Support with community Discord and bug fixes is only guaranteed for GA plugins. Premium plugins are often discounted or free during the Preview stage. |
usd_per_row | string^\d+(?:\.\d{1,10})?$ Deprecated Deprecated. Update |
free_rows_per_month | integer <int64> Deprecated Deprecated. Update |
{- "category": "cloud-infrastructure",
- "price_category": "api",
- "tier": "free",
- "display_name": "AWS Source Plugin",
- "short_description": "Sync data from AWS to any destination",
- "public": true,
- "release_stage": "coming-soon",
- "usd_per_row": "0.0001",
- "free_rows_per_month": 1000
}
{- "team_name": "cloudquery",
- "name": "aws-source",
- "kind": "source",
- "category": "cloud-infrastructure",
- "price_category": "api",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "display_name": "AWS Source Plugin",
- "official": true,
- "release_stage": "coming-soon",
- "short_description": "Sync data from AWS to any destination",
- "tier": "free",
- "public": true,
- "usd_per_row": "0.0001",
- "free_rows_per_month": 1000,
- "minimum_cloud_version": "v1.2.3"
}
Delete plugin by team and plugin name
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
DEPRECATED. Plugin prices are now managed by category. This endpoint will be removed in the near future and currently returns only empty data.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
{- "items": [
- {
- "id": "12345678-1234-1234-1234-1234567890ab",
- "usd_per_row": "0.0001",
- "free_rows_per_month": 1000,
- "effective_from": "2024-01-02T00:00:00Z"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
DEPRECATED. Plugin prices are now managed by category. This endpoint will be removed in the near future and currently returns only empty data.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
usd_per_row required | string^\d+(?:\.\d{1,10})?$ The price per row in USD. This is used to calculate the price of a sync. |
free_rows_per_month required | integer <int64> The number of rows that can be synced for free each month. |
effective_from required | string <date-time> The date and time the price came (or will come) into effect. |
{- "usd_per_row": "0.0001",
- "free_rows_per_month": 1000,
- "effective_from": "2024-01-02T00:00:00Z"
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "usd_per_row": "0.0001",
- "free_rows_per_month": 1000,
- "effective_from": "2024-01-02T00:00:00Z"
}
DEPRECATED. Plugin prices are now managed by category. This endpoint will be removed in the near future and currently returns only empty data.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
{- "message": "string",
- "status": 0
}
List all versions for a given plugin
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
sort_by | string Value: "created_at" The field to sort by |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
include_drafts | boolean Whether to include draft versions |
include_prereleases | boolean Whether to include prerelease versions |
{- "items": [
- {
- "created_at": "2017-07-14T16:53:42Z",
- "published_at": "2017-07-14T16:53:42Z",
- "name": "string",
- "message": "- Added support for AWS S3 - Added support for AWS EC2",
- "draft": true,
- "retracted": true,
- "protocols": [
- 3
], - "supported_targets": [
- "linux_arm64",
- "darwin_amd64",
- "windows_amd64"
], - "checksums": [
- "string"
], - "package_type": "native"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Get details about a given plugin version.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
{- "created_at": "2017-07-14T16:53:42Z",
- "published_at": "2017-07-14T16:53:42Z",
- "name": "string",
- "message": "- Added support for AWS S3 - Added support for AWS EC2",
- "draft": true,
- "retracted": true,
- "protocols": [
- 3
], - "supported_targets": [
- "linux_arm64",
- "darwin_amd64",
- "windows_amd64"
], - "checksums": [
- "string"
], - "package_type": "native",
- "spec_json_schema": "string",
- "connector_required": true,
- "connector_types": [
- "string"
], - "example_config": "string",
- "ui_base_url": "string"
}
Create a new plugin version, or update a draft version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
message required | string [ 1 .. 30000 ] characters A message describing what's new or changed in this version. This message will be displayed to users in the plugin's changelog. Supports limited markdown syntax. |
protocols required | Array of integers (PluginProtocols) Items Value: 3 The CloudQuery protocols supported by this plugin version (only protocol 3 is supported by new plugins). |
supported_targets required | Array of strings The targets supported by this plugin version, formatted as |
checksums required | Array of strings List of SHA-256 checksums for this plugin version, one for each supported target. |
package_type required | string (PluginPackageType) Enum: "native" "docker" The package type of the plugin assets |
spec_json_schema | string (PluginSpecJSONSchema) The specification of the plugin. This is a JSON schema that describes the configuration of the plugin. |
{- "message": "string",
- "protocols": [
- 3
], - "supported_targets": [
- "linux_arm64",
- "darwin_amd64",
- "windows_amd64"
], - "checksums": [
- "string"
], - "package_type": "native",
- "spec_json_schema": "string"
}
{- "created_at": "2017-07-14T16:53:42Z",
- "published_at": "2017-07-14T16:53:42Z",
- "name": "string",
- "message": "- Added support for AWS S3 - Added support for AWS EC2",
- "draft": true,
- "retracted": true,
- "protocols": [
- 3
], - "supported_targets": [
- "linux_arm64",
- "darwin_amd64",
- "windows_amd64"
], - "checksums": [
- "string"
], - "package_type": "native",
- "spec_json_schema": "string",
- "connector_required": true,
- "connector_types": [
- "string"
]
}
Update a given plugin version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
message | string Description of what's new or changed in this version (supports markdown) |
draft | boolean If a plugin version is in draft, it will not show to members outside the team or be counted as the latest version. Once draft is set to false, only certain fields can be updated. |
retracted | boolean If a plugin version is retracted, assets will still be available for download, but the version will be marked as retracted to discourage use. |
protocols | Array of integers (PluginProtocols) Items Value: 3 The CloudQuery protocols supported by this plugin version (only protocol 3 is supported by new plugins). |
supported_targets | Array of strings |
checksums | Array of strings The SHA-256 checksums of the plugin binaries, one per supported target. |
package_type | string The package type of the plugin binaries |
spec_json_schema | string (PluginSpecJSONSchema) The specification of the plugin. This is a JSON schema that describes the configuration of the plugin. |
{- "message": "- Added support for *AWS S3* - Added support for *AWS EC2*",
- "draft": true,
- "retracted": true,
- "protocols": [
- 3
], - "supported_targets": [
- "string"
], - "checksums": [
- "string"
], - "package_type": "string",
- "spec_json_schema": "string"
}
{- "created_at": "2017-07-14T16:53:42Z",
- "published_at": "2017-07-14T16:53:42Z",
- "name": "string",
- "message": "- Added support for AWS S3 - Added support for AWS EC2",
- "draft": true,
- "retracted": true,
- "protocols": [
- 3
], - "supported_targets": [
- "linux_arm64",
- "darwin_amd64",
- "windows_amd64"
], - "checksums": [
- "string"
], - "package_type": "native",
- "spec_json_schema": "string",
- "connector_required": true,
- "connector_types": [
- "string"
]
}
List all documentation pages for a given plugin version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "name": "overview",
- "content": "# Getting Started\n\nThis is the getting started page."
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create or update one or more plugin version docs pages
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
required | Array of objects (CloudQuery Plugin Documentation Page) |
{- "pages": [
- {
- "name": "overview",
- "content": "# Getting Started\n\nThis is the getting started page."
}
]
}
{- "names": [
- "overview"
]
}
Replace (override) multiple plugin version docs pages
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
required | Array of objects (CloudQuery Plugin Documentation Page) |
{- "pages": [
- {
- "name": "overview",
- "content": "# Getting Started\n\nThis is the getting started page."
}
]
}
{- "names": [
- "overview"
]
}
Delete one or more plugin version docs pages.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
names required | Array of strings (PluginDocsPageName) [^[\w,\s-]+$] |
{- "names": [
- "overview"
]
}
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
List tables for a given plugin version. This only applies to source plugins.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "description": "AWS S3 Buckets",
- "is_incremental": true,
- "name": "aws_ec2_instances",
- "parent": "nil",
- "relations": [
- "aws_s3_bucket_cors_rules"
], - "title": "AWS S3 Buckets",
- "is_paid": true
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create or update one or more plugin version tables. This only applies to source plugins, and can only be done if the plugin version is in draft.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
required | Array of objects (CloudQuery Plugin Table) |
{- "tables": [
- {
- "description": "AWS S3 Buckets",
- "is_incremental": true,
- "name": "aws_ec2_instances",
- "parent": "nil",
- "relations": [
- "aws_s3_bucket_cors_rules"
], - "permissions_needed": [
- "storage.buckets.list"
], - "title": "AWS S3 Buckets",
- "is_paid": true,
- "columns": [
- {
- "description": "string",
- "incremental_key": true,
- "name": "string",
- "not_null": true,
- "primary_key": true,
- "type": "string",
- "type_schema": "string",
- "unique": true
}
]
}
]
}
{- "names": [
- "aws_ec2_instances"
]
}
Delete one or more plugin version tables.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
names required | Array of strings (PluginTableName) [^[a-z](_?[a-z0-9]+)+$] |
{- "names": [
- "aws_ec2_instances"
]
}
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
Get schema for a given table and plugin version. This only applies to source plugins.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
table_name required | string |
{- "columns": [
- {
- "description": "string",
- "incremental_key": true,
- "name": "string",
- "not_null": true,
- "primary_key": true,
- "type": "string",
- "type_schema": "string",
- "unique": true
}
], - "description": "string",
- "is_incremental": true,
- "name": "string",
- "parent": "string",
- "relations": [
- "string"
], - "title": "string",
- "is_paid": true,
- "permissions_needed": [
- "storage.buckets.list"
]
}
Download an asset for a given plugin version and target
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
target_name required | string |
Accept | string |
{- "checksum": "string",
}
Get a URL to upload an asset for a given plugin version and target
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
target_name required | string |
{- "url": "string"
}
Get URLs to upload UI assets for a given plugin version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
required | Array of objects (CloudQuery Plugin UI Asset Upload Request) |
{- "assets": [
- {
- "name": "scripts/main.js",
- "content_type": "application/json"
}
]
}
{- "ui_id": "string",
- "assets": [
- {
- "name": "string",
- "upload_url": "string"
}
]
}
Finalize UI asset upload
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
ui_id required | string ID representing the finished upload |
{- "ui_id": "string"
}
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
Remove UI assets for a given plugin version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
List all plugins for the team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
include_private | boolean Whether to include private plugins |
{- "items": [
- {
- "name": "aws-source",
- "kind": "source",
- "team_name": "cloudquery",
- "display_name": "AWS Source Plugin",
- "category": "cloud-infrastructure",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "official": true,
- "short_description": "Sync data from AWS to any destination",
- "tier": "paid",
- "usd_per_row": "0.00123",
- "free_rows_per_month": 10000,
- "release_stage": "preview"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Download an asset for a given plugin version as the current team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_team required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
plugin_kind required | string (PluginKind) Enum: "source" "destination" "transformer" Example: source The kind of plugin, ie. source or destination. |
plugin_name required | string (PluginName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-source The unique name for the plugin. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
target_name required | string |
Accept | string |
{- "checksum": "string",
}
Get a URL to upload image that will be publicly accessible
content_type required | string (ContentType) Enum: "image/jpeg" "image/png" "image/webp" The HTTP Content-Type of the image or asset |
{- "content_type": "image/png"
}
{- "required_headers": {
- "property1": [
- "string"
], - "property2": [
- "string"
]
}
}
List all addons
sort_by | string Enum: "created_at" "updated_at" "name" "downloads" The field to sort by |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "name": "aws-policies",
- "team_name": "cloudquery",
- "display_name": "AWS Policies",
- "category": "cloud-infrastructure",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "official": true,
- "short_description": "Sync data from AWS to any destination",
- "tier": "free",
- "price_usd": "50",
- "addon_type": "visualization",
- "addon_format": "zip"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create an addon owned by the specified team. User must be part of that team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the team. |
name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the addon. |
category required | string (AddonCategory) Enum: "cloud-infrastructure" "databases" "sales-marketing" "engineering-analytics" "other" Supported categories for addons |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_format required | string (AddonFormat) Value: "zip" Supported formats for addons |
tier required | string (AddonTier) Enum: "free" "paid" Supported tiers for addons |
price_usd | string^\d+(?:\.\d{1,10})?$ The price for 6 months |
short_description required | string [ 1 .. 512 ] characters |
display_name required | string [ 1 .. 50 ] characters The addon's display name |
homepage | string |
repository | string |
logo | string^https:\/\/storage\.googleapis\.com\/cq-cloud... |
public required | boolean Whether the plugin is listed in the CloudQuery Hub. If false, the plugin will not be shown in the CloudQuery Hub and will only be visible to members of the plugin's team. |
{- "team_name": "cloudquery",
- "name": "aws-policy",
- "category": "cloud-infrastructure",
- "addon_type": "transformation",
- "addon_format": "zip",
- "tier": "free",
- "price_usd": "50",
- "short_description": "AWS Asset inventory dashboard for grafana",
- "display_name": "AWS Asset inventory",
- "public": true
}
{- "team_name": "cloudquery",
- "name": "aws-policy",
- "official": true,
- "category": "cloud-infrastructure",
- "addon_type": "transformation",
- "addon_format": "zip",
- "tier": "free",
- "price_usd": "50",
- "short_description": "AWS Asset inventory dashboard for grafana",
- "display_name": "AWS Asset inventory",
- "public": true,
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z"
}
Get details about a given addon.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
{- "team_name": "cloudquery",
- "name": "aws-policy",
- "official": true,
- "category": "cloud-infrastructure",
- "addon_type": "transformation",
- "addon_format": "zip",
- "tier": "free",
- "price_usd": "50",
- "short_description": "AWS Asset inventory dashboard for grafana",
- "display_name": "AWS Asset inventory",
- "public": true,
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "latest_version": "string"
}
Update an Addon
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
category | string (AddonCategory) Enum: "cloud-infrastructure" "databases" "sales-marketing" "engineering-analytics" "other" Supported categories for addons |
addon_format | string (AddonFormat) Value: "zip" Supported formats for addons |
tier | string (AddonTier) Enum: "free" "paid" Supported tiers for addons |
price_usd | string^\d+(?:\.\d{1,10})?$ The price for 6 months in USD |
short_description | string [ 1 .. 512 ] characters |
display_name | string [ 1 .. 50 ] characters The addon's display name |
homepage | string |
repository | string |
logo | string^(https:\/\/storage\.googleapis\.com\/cq-clou... |
public | boolean Whether the plugin is listed in the CloudQuery Hub. If false, the plugin will not be shown in the CloudQuery Hub and will only be visible to members of the plugin's team. |
created_at | string <date-time> |
{- "category": "cloud-infrastructure",
- "addon_format": "zip",
- "tier": "free",
- "price_usd": "50",
- "short_description": "AWS Asset inventory dashboard for grafana",
- "display_name": "AWS Asset inventory",
- "public": true,
- "created_at": "2017-07-14T16:53:42Z"
}
{- "team_name": "cloudquery",
- "name": "aws-policy",
- "official": true,
- "category": "cloud-infrastructure",
- "addon_type": "transformation",
- "addon_format": "zip",
- "tier": "free",
- "price_usd": "50",
- "short_description": "AWS Asset inventory dashboard for grafana",
- "display_name": "AWS Asset inventory",
- "public": true,
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z"
}
List all versions for a given addon
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
sort_by | string Value: "created_at" The field to sort by |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
include_drafts | boolean Whether to include draft versions |
{- "items": [
- {
- "created_at": "2017-07-14T16:53:42Z",
- "published_at": "2017-07-14T16:53:42Z",
- "name": "string",
- "message": "- Added support for *AWS S3* - Added support for *AWS EC2*",
- "doc": "string",
- "draft": true,
- "plugin_deps": [
- "string"
], - "addon_deps": [
- "string"
], - "retracted": true,
- "checksum": "string"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Get details about a given addon version.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
{- "created_at": "2017-07-14T16:53:42Z",
- "published_at": "2017-07-14T16:53:42Z",
- "name": "string",
- "message": "- Added support for *AWS S3* - Added support for *AWS EC2*",
- "doc": "string",
- "draft": true,
- "plugin_deps": [
- "string"
], - "addon_deps": [
- "string"
], - "retracted": true,
- "checksum": "string"
}
Create a new addon version, or update a draft version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
message required | string [ 1 .. 30000 ] characters A message describing what's new or changed in this version. This message will be displayed to users in the addon's changelog. Supports limited markdown syntax. |
doc required | string Main README in MD format |
plugin_deps | Array of strings plugin dependencies in the format of ['team_name/kind/plugin_name@version'] |
addon_deps | Array of strings addon dependencies in the format of ['team_name/type/addon_name@version'] |
checksum required | string SHA-256 checksum for the addon asset |
{- "message": "string",
- "doc": "string",
- "plugin_deps": [
- "string"
], - "addon_deps": [
- "string"
], - "checksum": "string"
}
{- "created_at": "2017-07-14T16:53:42Z",
- "published_at": "2017-07-14T16:53:42Z",
- "name": "string",
- "message": "- Added support for *AWS S3* - Added support for *AWS EC2*",
- "doc": "string",
- "draft": true,
- "plugin_deps": [
- "string"
], - "addon_deps": [
- "string"
], - "retracted": true,
- "checksum": "string"
}
Update a given addon version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
message | string Description of what's new or changed in this version (supports markdown) |
doc | string Main README in MD format |
draft | boolean If a plugin version is in draft, it will not show to members outside the team or be counted as the latest version. |
plugin_deps | Array of strings list of plugins the addon depends on in the format of team_name/kind/name@version |
addon_deps | Array of strings list of other addons this addon depends on in the format of team_name/type/name@version |
retracted | boolean If a plugin version is retracted, assets will still be available for download, but the version will be marked as retracted to discourage use. |
checksum | string The checksum of the addon asset |
{- "message": "- Added support for *AWS S3* - Added support for *AWS EC2*",
- "doc": "string",
- "draft": true,
- "plugin_deps": [
- "string"
], - "addon_deps": [
- "string"
], - "retracted": true,
- "checksum": "string"
}
{- "created_at": "2017-07-14T16:53:42Z",
- "published_at": "2017-07-14T16:53:42Z",
- "name": "string",
- "message": "- Added support for *AWS S3* - Added support for *AWS EC2*",
- "doc": "string",
- "draft": true,
- "plugin_deps": [
- "string"
], - "addon_deps": [
- "string"
], - "retracted": true,
- "checksum": "string"
}
Download an asset for a given version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
Accept | string |
{- "checksum": "string",
}
Get a URL to upload an asset for a given addon version
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
{- "url": "string"
}
List all addons for the team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
include_private | boolean Whether to include private plugins |
{- "items": [
- {
- "name": "aws-policies",
- "team_name": "cloudquery",
- "display_name": "AWS Policies",
- "category": "cloud-infrastructure",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "official": true,
- "short_description": "AWS policies",
- "tier": "paid",
- "price_usd": "50",
- "addon_type": "visualization",
- "addon_format": "zip"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
List all addon orders for the team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
{- "items": [
- {
- "id": "12345678-1234-1234-1234-1234567890ab",
- "team_name": "cloudquery",
- "addon_team": "cloudquery",
- "addon_type": "transformation",
- "addon_name": "aws-policy",
- "status": "pending",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Start the checkout process for an addon order.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_team required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ The unique name for the addon. |
success_url required | string URL to redirect to after successful order completion |
cancel_url required | string URL to redirect to after order cancellation |
{- "addon_team": "cloudquery",
- "addon_type": "transformation",
- "addon_name": "aws-policy",
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "team_name": "cloudquery",
- "addon_team": "cloudquery",
- "addon_type": "transformation",
- "addon_name": "aws-policy",
- "status": "pending",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
}
Get an addon order for the team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_order_id required | string <uuid> (AddonOrderID) Example: 12345678-1234-1234-1234-1234567890ab ID of the addon order |
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "team_name": "cloudquery",
- "addon_team": "cloudquery",
- "addon_type": "transformation",
- "addon_name": "aws-policy",
- "status": "pending",
- "created_at": "2017-07-14T16:53:42Z",
- "updated_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
}
Download an asset for a given addon version as the current team.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_team required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
addon_type required | string (AddonType) Enum: "transformation" "visualization" Supported types for addons |
addon_name required | string (AddonName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: aws-policy The unique name for the addon. |
version_name required | string (VersionName) ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z-]+(\.[0-... The version in semantic version format. |
Accept | string |
{- "checksum": "string",
}
Performs authentication and authorization for our image registry.
account | string Username used for |
service | string Service requesting the JWT token |
scope | string Multi-value string containing the repository being access and the operation type (push/pull) |
X-Meta-Plugin-Version | string Example: v1.0.0 Plugin version name |
X-Meta-User-Team-Name | string User's team name |
{- "access_token": "string",
- "token": "string"
}
Create a test source connection.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
path required | string (SyncPluginPath) ^cloudquery/[^/]+ Plugin path in CloudQuery registry |
source_name | string Name of an existing source |
version required | string Version of the plugin |
object <Plugin parameters, specific to each plugin> | |
Array of objects (SyncEnvCreate) Environment variables for the plugin. All environment variables will be stored as secrets. | |
connector_id | string <uuid> (ConnectorID) ID of the connector that will be used to authenticate the destination. |
{- "path": "string",
- "source_name": "string",
- "version": "v1.2.3",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "connector_id": "12345678-1234-1234-1234-1234567890ab"
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "plugin_path": "string",
- "plugin_version": "string"
}
Get a sync source test connection.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_source_test_connection_id required | string <uuid> (SyncSourceTestConnectionID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Sync Source Test Connection |
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "plugin_path": "string",
- "plugin_version": "string"
}
Update a sync source test connection.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_source_test_connection_id required | string <uuid> (SyncSourceTestConnectionID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Sync Source Test Connection |
status required | string (SyncTestConnectionStatus) Enum: "completed" "failed" "started" "created" The status of the sync run |
failure_reason | string Reason for failure |
failure_code | string Code for failure |
{- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS"
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "plugin_path": "string",
- "plugin_version": "string"
}
Promote a sync source test connection to a sync source.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_source_test_connection_id required | string <uuid> (SyncSourceTestConnectionID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Sync Source Test Connection |
name required | string^[a-zA-Z0-9_-]+$ Descriptive, unique name for the source. The name can only contain ASCII letters, digits, - and _. |
display_name | string (DisplayName) [ 1 .. 255 ] characters ^[a-zA-Z\p{L}\p{N}_][a-zA-Z\p{L}\p{N}_ \-']*$... A human-readable display name |
tables required | Array of strings Tables to sync. Wildcards are supported. Note that child tables are excluded by default, and need to be explicitly specified. |
skip_tables | Array of strings Tables matched by |
overwrite_source | boolean |
{- "name": "my-source-definition",
- "display_name": "Human Readable Name",
- "tables": [
- "string"
], - "skip_tables": [
- "string"
], - "overwrite_source": true
}
{- "name": "my-source-definition",
- "display_name": "Human Readable Name",
- "path": "string",
- "version": "v1.2.3",
- "tables": [
- "string"
], - "skip_tables": [
- "string"
], - "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "last_update_source": "yaml",
- "connector_id": "12345678-1234-1234-1234-1234567890ab",
- "created_at": "2023-07-14T16:53:42Z",
- "updated_at": "2023-07-14T16:53:42Z",
- "draft": true
}
Create a test destination connection.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
path required | string (SyncPluginPath) ^cloudquery/[^/]+ Plugin path in CloudQuery registry |
destination_name | string Name of an existing destination |
version required | string Version of the plugin |
write_mode | string (SyncDestinationWriteMode) Enum: "append" "overwrite" "overwrite-delete-stale" Write mode for the destination |
migrate_mode | string (SyncDestinationMigrateMode) Enum: "safe" "forced" Migrate mode for the destination |
object <Plugin parameters, specific to each plugin> | |
Array of objects (SyncEnvCreate) Environment variables for the plugin. All environment variables will be stored as secrets. | |
connector_id | string <uuid> (ConnectorID) ID of the connector that will be used to authenticate the destination. |
{- "path": "string",
- "destination_name": "string",
- "version": "v1.2.3",
- "write_mode": "append",
- "migrate_mode": "safe",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "connector_id": "12345678-1234-1234-1234-1234567890ab"
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "plugin_path": "string",
- "plugin_version": "string"
}
Get a sync destination test connection.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_destination_test_connection_id required | string <uuid> (SyncDestinationTestConnectionID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Sync Destination Test Connection |
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "plugin_path": "string",
- "plugin_version": "string"
}
Update a sync destination test connection.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_destination_test_connection_id required | string <uuid> (SyncDestinationTestConnectionID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Sync Destination Test Connection |
status required | string (SyncTestConnectionStatus) Enum: "completed" "failed" "started" "created" The status of the sync run |
failure_reason | string Reason for failure |
failure_code | string Code for failure |
{- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS"
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "plugin_path": "string",
- "plugin_version": "string"
}
Promote a sync destination test connection to a sync destination.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_destination_test_connection_id required | string <uuid> (SyncDestinationTestConnectionID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Sync Destination Test Connection |
name required | string^[a-zA-Z0-9_-]+$ Descriptive, unique name for the destination. The name can only contain ASCII letters, digits, - and _. |
display_name | string (DisplayName) [ 1 .. 255 ] characters ^[a-zA-Z\p{L}\p{N}_][a-zA-Z\p{L}\p{N}_ \-']*$... A human-readable display name |
write_mode | string (SyncDestinationWriteMode) Enum: "append" "overwrite" "overwrite-delete-stale" Write mode for the destination |
migrate_mode | string (SyncDestinationMigrateMode) Enum: "safe" "forced" Migrate mode for the destination |
overwrite_destination | boolean |
{- "name": "my-destination-definition",
- "display_name": "Human Readable Name",
- "write_mode": "append",
- "migrate_mode": "safe",
- "overwrite_destination": true
}
{- "name": "my-destination-definition",
- "display_name": "Human Readable Name",
- "path": "string",
- "version": "v1.2.3",
- "write_mode": "append",
- "migrate_mode": "safe",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "last_update_source": "yaml",
- "connector_id": "12345678-1234-1234-1234-1234567890ab",
- "created_at": "2023-07-14T16:53:42Z",
- "updated_at": "2023-07-14T16:53:42Z",
- "draft": true
}
List all sync source definitions.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "name": "my-source-definition",
- "display_name": "Human Readable Name",
- "path": "string",
- "version": "v1.2.3",
- "tables": [
- "string"
], - "skip_tables": [
- "string"
], - "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "last_update_source": "yaml",
- "connector_id": "12345678-1234-1234-1234-1234567890ab",
- "created_at": "2023-07-14T16:53:42Z",
- "updated_at": "2023-07-14T16:53:42Z",
- "draft": true
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Get a single sync source definition.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_source_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync source |
{- "name": "my-source-definition",
- "display_name": "Human Readable Name",
- "path": "string",
- "version": "v1.2.3",
- "tables": [
- "string"
], - "skip_tables": [
- "string"
], - "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "last_update_source": "yaml",
- "connector_id": "12345678-1234-1234-1234-1234567890ab",
- "created_at": "2023-07-14T16:53:42Z",
- "updated_at": "2023-07-14T16:53:42Z",
- "draft": true
}
Update a Sync Source definition.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_source_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync source |
display_name | string (DisplayName) [ 1 .. 255 ] characters ^[a-zA-Z\p{L}\p{N}_][a-zA-Z\p{L}\p{N}_ \-']*$... A human-readable display name |
tables | Array of strings Tables to sync. Wildcards are supported. Note that child tables are excluded by default, and need to be explicitly specified. |
skip_tables | Array of strings Tables matched by |
last_update_source | string (SyncLastUpdateSource) Enum: "yaml" "ui" How was the source or destination been created or updated last |
{- "display_name": "Human Readable Name",
- "tables": [
- "string"
], - "skip_tables": [
- "string"
], - "last_update_source": "yaml"
}
{- "name": "my-source-definition",
- "display_name": "Human Readable Name",
- "path": "string",
- "version": "v1.2.3",
- "tables": [
- "string"
], - "skip_tables": [
- "string"
], - "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "last_update_source": "yaml",
- "connector_id": "12345678-1234-1234-1234-1234567890ab",
- "created_at": "2023-07-14T16:53:42Z",
- "updated_at": "2023-07-14T16:53:42Z",
- "draft": true
}
Delete a Sync Source definition. Any syncs relying on this source must be deleted first.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_source_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync source |
{- "message": "string",
- "status": 0
}
Get test connection details for sync source.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_source_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync source |
sync_test_connection_id required | string <uuid> (SyncTestConnectionID) Example: 12345678-1234-1234-1234-1234567890ab unique ID of the test connection |
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "plugin_path": "string",
- "plugin_version": "string",
- "plugin_kind": "source"
}
List all Syncs for a given sync source.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_source_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync source |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "name": "string",
- "display_name": "Human Readable Name",
- "source": "string",
- "destinations": [
- "string"
], - "disabled": true,
- "schedule": "string",
- "cpu": "1",
- "memory": "2Gi",
- "incremental": {
- "table": "string",
- "destination": "string"
}, - "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "created_by": "string"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
List all sync destination definitions.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "name": "my-destination-definition",
- "display_name": "Human Readable Name",
- "path": "string",
- "version": "v1.2.3",
- "write_mode": "append",
- "migrate_mode": "safe",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "last_update_source": "yaml",
- "connector_id": "12345678-1234-1234-1234-1234567890ab",
- "created_at": "2023-07-14T16:53:42Z",
- "updated_at": "2023-07-14T16:53:42Z",
- "draft": true
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Get a single sync destination definition.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_destination_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync destination |
{- "name": "my-destination-definition",
- "display_name": "Human Readable Name",
- "path": "string",
- "version": "v1.2.3",
- "write_mode": "append",
- "migrate_mode": "safe",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "last_update_source": "yaml",
- "connector_id": "12345678-1234-1234-1234-1234567890ab",
- "created_at": "2023-07-14T16:53:42Z",
- "updated_at": "2023-07-14T16:53:42Z",
- "draft": true
}
Update a Sync Destination definition.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_destination_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync destination |
display_name | string (DisplayName) [ 1 .. 255 ] characters ^[a-zA-Z\p{L}\p{N}_][a-zA-Z\p{L}\p{N}_ \-']*$... A human-readable display name |
write_mode | string (SyncDestinationWriteMode) Enum: "append" "overwrite" "overwrite-delete-stale" Write mode for the destination |
migrate_mode | string (SyncDestinationMigrateMode) Enum: "safe" "forced" Migrate mode for the destination |
last_update_source | string (SyncLastUpdateSource) Enum: "yaml" "ui" How was the source or destination been created or updated last |
{- "display_name": "Human Readable Name",
- "write_mode": "append",
- "migrate_mode": "safe",
- "last_update_source": "yaml"
}
{- "name": "my-destination-definition",
- "display_name": "Human Readable Name",
- "path": "string",
- "version": "v1.2.3",
- "write_mode": "append",
- "migrate_mode": "safe",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "last_update_source": "yaml",
- "connector_id": "12345678-1234-1234-1234-1234567890ab",
- "created_at": "2023-07-14T16:53:42Z",
- "updated_at": "2023-07-14T16:53:42Z",
- "draft": true
}
Delete a Sync Destination definition. Any syncs relying on this destination must be deleted first.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_destination_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync destination |
{- "message": "string",
- "status": 0
}
Get test connection details for sync destination.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_destination_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync destination |
sync_test_connection_id required | string <uuid> (SyncTestConnectionID) Example: 12345678-1234-1234-1234-1234567890ab unique ID of the test connection |
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "failure_reason": "password authentication failed for user \"exampleuser\"",
- "failure_code": "INVALID_CREDENTIALS",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "plugin_path": "string",
- "plugin_version": "string",
- "plugin_kind": "source"
}
List all Syncs for a given sync destination.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_destination_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync destination |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "name": "string",
- "display_name": "Human Readable Name",
- "source": "string",
- "destinations": [
- "string"
], - "disabled": true,
- "schedule": "string",
- "cpu": "1",
- "memory": "2Gi",
- "incremental": {
- "table": "string",
- "destination": "string"
}, - "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "created_by": "string"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
List all Syncs.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "name": "string",
- "display_name": "Human Readable Name",
- "source": "string",
- "destinations": [
- "string"
], - "disabled": true,
- "schedule": "string",
- "cpu": "1",
- "memory": "2Gi",
- "incremental": {
- "table": "string",
- "destination": "string"
}, - "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "created_by": "string"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create new Sync definition. Sync runs can be scheduled automatically, or triggered manually after sync is created.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
name required | string^[a-zA-Z0-9_-]+$ Descriptive, unique name for the sync. The name can only contain ASCII letters, digits, - and _. |
display_name | string (DisplayName) [ 1 .. 255 ] characters ^[a-zA-Z\p{L}\p{N}_][a-zA-Z\p{L}\p{N}_ \-']*$... A human-readable display name |
source required | string^[a-zA-Z0-9_-]+$ Unique name of the source |
destinations required | Array of strings non-empty [^[a-zA-Z0-9_-]+$] |
schedule | string Cron schedule for the sync |
disabled | boolean Default: false Whether the sync is disabled |
cpu | string Default: "1" CPU quota for the sync |
memory | string Default: "2Gi" Memory quota for the sync |
object (SyncIncremental) Managed Sync Incremental Options definition |
{- "name": "string",
- "display_name": "Human Readable Name",
- "source": "string",
- "destinations": [
- "string"
], - "schedule": "string",
- "disabled": false,
- "cpu": "1",
- "memory": "2Gi",
- "incremental": {
- "table": "string",
- "destination": "string"
}
}
{- "name": "string",
- "display_name": "Human Readable Name",
- "source": "string",
- "destinations": [
- "string"
], - "disabled": true,
- "schedule": "string",
- "cpu": "1",
- "memory": "2Gi",
- "incremental": {
- "table": "string",
- "destination": "string"
}, - "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "created_by": "string"
}
Get a Sync
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync |
{- "name": "string",
- "display_name": "Human Readable Name",
- "source": "string",
- "destinations": [
- "string"
], - "disabled": true,
- "schedule": "string",
- "cpu": "1",
- "memory": "2Gi",
- "incremental": {
- "table": "string",
- "destination": "string"
}, - "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "created_by": "string"
}
Update a Sync
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync |
display_name | string (DisplayName) [ 1 .. 255 ] characters ^[a-zA-Z\p{L}\p{N}_][a-zA-Z\p{L}\p{N}_ \-']*$... A human-readable display name |
source | string^[a-zA-Z0-9_-]+$ Unique name of the source |
destinations | Array of strings non-empty [^[a-zA-Z0-9_-]+$] |
schedule | string Cron schedule for the sync |
disabled | boolean Default: false Whether the sync is disabled |
Array of objects (SyncEnv) Environment variables for the sync | |
cpu | string Default: "1" CPU quota for the sync |
memory | string Default: "2Gi" Memory quota for the sync |
object (SyncIncrementalUpdate) Managed Sync Incremental Options Update definition |
{- "display_name": "Human Readable Name",
- "source": "string",
- "destinations": [
- "string"
], - "schedule": "string",
- "disabled": false,
- "env": [
- {
- "name": "string"
}
], - "cpu": "1",
- "memory": "2Gi",
- "incremental": {
- "table": "string",
- "destination": "string"
}
}
{- "name": "string",
- "display_name": "Human Readable Name",
- "source": "string",
- "destinations": [
- "string"
], - "disabled": true,
- "schedule": "string",
- "cpu": "1",
- "memory": "2Gi",
- "incremental": {
- "table": "string",
- "destination": "string"
}, - "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "created_by": "string"
}
Delete Sync. This will delete Sync configuration and all associated sync runs, but will not delete the associated source and destination(s). These will need to be deleted separately.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync |
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
List all Sync Runs.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
{- "items": [
- {
- "sync_name": "string",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "status_reason": "error",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "total_rows": 0,
- "warnings": 0,
- "errors": 0
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create new SyncRun. This will trigger a manual job run.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync |
{- "sync_name": "string",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "status_reason": "error",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "total_rows": 0,
- "warnings": 0,
- "errors": 0
}
Get a Sync Run.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync |
sync_run_id required | string <uuid> (SyncRunID) Example: 12345678-1234-1234-1234-1234567890ab ID of the SyncRun |
{- "sync_name": "string",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "status_reason": "error",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "total_rows": 0,
- "warnings": 0,
- "errors": 0,
- "cpu_seconds": 0.1,
- "memory_byte_seconds": 0.1,
- "network_egress_bytes": 0.1
}
Update a SyncRun
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync |
sync_run_id required | string <uuid> (SyncRunID) Example: 12345678-1234-1234-1234-1234567890ab ID of the SyncRun |
status | string (SyncRunStatus) Enum: "completed" "failed" "started" "cancelled" "created" The status of the sync run |
status_reason | string (SyncRunStatusReason) Enum: "error" "oom_killed" The reason for the status |
{- "status": "completed",
- "status_reason": "error"
}
{- "sync_name": "string",
- "id": "12345678-1234-1234-1234-1234567890ab",
- "status": "completed",
- "status_reason": "error",
- "created_at": "2017-07-14T16:53:42Z",
- "completed_at": "2017-07-14T16:53:42Z",
- "total_rows": 0,
- "warnings": 0,
- "errors": 0
}
Get logs for a sync run.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
sync_name required | string^[a-zA-Z0-9_-]+$ Unique name of the sync |
sync_run_id required | string <uuid> (SyncRunID) Example: 12345678-1234-1234-1234-1234567890ab ID of the SyncRun |
Accept | string |
{
}
List all configured connectors
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
per_page | integer <int64> [ 1 .. 1000 ] Default: 100 The number of results per page (max 1000). |
page | integer <int64> >= 1 Default: 1 Page number of the results to fetch |
filter_type | string Filter connectors by a given type. |
filter_plugin | string Example: filter_plugin=cloudquery/source/googleanalytics Filter connectors by a given plugin reference. Mutually exclusive with |
{- "items": [
- {
- "id": "12345678-1234-1234-1234-1234567890ab",
- "type": "string",
- "name": "string",
- "status": "created",
- "created_at": "2017-07-14T16:53:42Z"
}
], - "metadata": {
- "total_count": 0,
- "last_page": 0
}
}
Create new connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
type required | string Type of the connector |
name required | string Name of the connector |
{- "type": "string",
- "name": "string"
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "type": "string",
- "name": "string",
- "status": "created",
- "created_at": "2017-07-14T16:53:42Z"
}
Get a configured connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "type": "string",
- "name": "string",
- "status": "created",
- "created_at": "2017-07-14T16:53:42Z"
}
Update a connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
name | string Name of the connector |
{- "name": "string"
}
{- "id": "12345678-1234-1234-1234-1234567890ab",
- "type": "string",
- "name": "string",
- "status": "created",
- "created_at": "2017-07-14T16:53:42Z"
}
Revoke authentication for a given connector. Any syncs relying on this connector will stop running until the connector is reauthenticated or sync references are updated.
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
{- "message": "string",
- "status": 0
}
Get authentication status for the given AWS connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
{- "role_arn": "string",
- "external_id": "string"
}
Authenticate or reauthenticate the given AWS connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
plugin_team required | string Team that owns the plugin we are authenticating the connector for |
plugin_kind required | string Kind of the plugin |
plugin_name required | string Name of the plugin |
plugin_version | string Version of the plugin |
object <Plugin parameters, specific to each plugin> | |
Array of objects (SyncEnvCreate) Environment variables used in the spec. | |
tables | Array of strings Tables to authenticate, setting from the outer spec |
skip_tables | Array of strings Tables to skip authentication, setting from the outer spec |
skip_dependent_tables | boolean Whether to skip dependent tables, setting from the outer spec |
{- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws",
- "plugin_version": "v27.1.0",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "tables": [
- "aws_s3_buckets"
], - "skip_tables": [
- "aws_s3_buckets"
], - "skip_dependent_tables": true
}
{- "redirect_url": "string",
- "role_template_url": "string",
- "suggested_external_id": "string",
- "suggested_policy_arns": [
- "string"
]
}
Complete authentication for the given AWS connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
role_arn required | string ARN of role created by the user |
external_id | string External ID in the role definition. Optional. If not provided the previously suggested external ID will be used. Empty string will remove the external ID. |
{- "role_arn": "string",
- "external_id": "string"
}
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
Get authentication status for the given GCP connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
{- "service_account": "string"
}
Authenticate or reauthenticate the given GCP connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
plugin_team required | string Team that owns the plugin we are authenticating the connector for |
plugin_kind required | string Kind of the plugin |
plugin_name required | string Name of the plugin |
{- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "aws"
}
{- "service_account": "string"
}
Complete authentication for the given GCP connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
{- "message": "string",
- "status": 0,
- "errors": [
- "string"
], - "field_errors": {
- "property1": "string",
- "property2": "string"
}
}
Authenticate or reauthenticate the given OAuth connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
plugin_team required | string Team that owns the plugin we are authenticating the connector for |
plugin_kind required | string Kind of the plugin |
plugin_name required | string Name of the plugin |
plugin_version | string Version of the plugin |
base_url required | string Base of the URL the callback url will be constructed from |
object <Plugin parameters, specific to each plugin> | |
Array of objects (SyncEnvCreate) Environment variables used in the spec. | |
tables | Array of strings Tables to authenticate, setting from the outer spec |
skip_tables | Array of strings Tables to skip authentication, setting from the outer spec |
skip_dependent_tables | boolean Whether to skip dependent tables, setting from the outer spec |
flavor | string Override default flavor |
{- "plugin_team": "cloudquery",
- "plugin_kind": "source",
- "plugin_name": "googleanalytics",
- "plugin_version": "v3.0.0",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
], - "tables": [
- "github_organizations"
], - "skip_tables": [
- "github_organizations"
], - "skip_dependent_tables": true,
- "flavor": "string"
}
{- "redirect_url": "string"
}
Complete authentication for the given OAuth connector
team_name required | string (TeamName) <= 255 characters ^[a-z](-?[a-z0-9]+)+$ Example: cloudquery The unique name for the team. |
connector_id required | string <uuid> (ConnectorID) Example: 12345678-1234-1234-1234-1234567890ab ID of the Connector |
return_url required | string URL the user was redirected to (including new parameter values) after the OAuth flow is complete |
base_url required | string Base of the URL the callback url was constructed from |
object <Plugin parameters, specific to each plugin> | |
Array of objects (SyncEnvCreate) Environment variables used in the spec. |
{- "return_url": "string",
- "spec": { },
- "env": [
- {
- "name": "string",
- "value": "string"
}
]
}
{- "redirect_url": "string"
}