Components

List Stack Components

get

Get a list of all stack components.

Args: component_filter_model: Filter model used for pagination, sorting, filtering. project_name_or_id: Optional name or ID of the project to filter by. hydrate: Flag deciding whether to hydrate the output model(s) by including metadata fields in the response.

Returns: List of stack components matching the filter criteria.

Authorizations

Query parameters

project_name_or_idany ofOptional

hydratebooleanOptionalDefault: false

sort_bystringOptionalDefault: created

logical_operatorstring · enumOptional

Logical Ops to use to combine filters on list methods.

Default: andAvailable options:

pageinteger · min: 1OptionalDefault: 1

sizeinteger · min: 1 · max: 10000OptionalDefault: 20

idany ofOptional

createdany ofOptional

updatedany ofOptional

scope_userany ofOptional

userany ofOptional

scope_typeany ofOptional

nameany ofOptional

flavorany ofOptional

typeany ofOptional

connector_idany ofOptional

stack_idany ofOptional

Responses

application/json

objectOptional

application/json

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/components HTTP/1.1
Host: 
Accept: */*

{
  "index": 1,
  "max_size": 1,
  "total_pages": 1,
  "total": 1,
  "items": [
    {
      "body": {
        "created": "2025-04-21T16:49:05.607Z",
        "updated": "2025-04-21T16:49:05.607Z",
        "user": {
          "body": {
            "created": "2025-04-21T16:49:05.607Z",
            "updated": "2025-04-21T16:49:05.607Z",
            "active": true,
            "activation_token": "text",
            "full_name": "text",
            "email_opted_in": true,
            "is_service_account": true,
            "is_admin": true,
            "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
          },
          "metadata": {
            "email": "text",
            "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
            "user_metadata": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          },
          "resources": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "permission_denied": true,
          "name": "text"
        },
        "type": "alerter",
        "flavor_name": "text",
        "integration": "text",
        "logo_url": "text"
      },
      "metadata": {
        "configuration": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "labels": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "connector_resource_id": "text",
        "connector": {
          "body": {
            "created": "2025-04-21T16:49:05.607Z",
            "updated": "2025-04-21T16:49:05.607Z",
            "user": {
              "body": {
                "created": "2025-04-21T16:49:05.607Z",
                "updated": "2025-04-21T16:49:05.607Z",
                "active": true,
                "activation_token": "text",
                "full_name": "text",
                "email_opted_in": true,
                "is_service_account": true,
                "is_admin": true,
                "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
              },
              "metadata": {
                "email": "text",
                "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
                "user_metadata": {
                  "ANY_ADDITIONAL_PROPERTY": "anything"
                }
              },
              "resources": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              },
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "permission_denied": true,
              "name": "text"
            },
            "description": "text",
            "connector_type": "text",
            "auth_method": "text",
            "resource_types": [
              "text"
            ],
            "resource_id": "text",
            "supports_instances": true,
            "expires_at": "2025-04-21T16:49:05.607Z",
            "expires_skew_tolerance": 1
          },
          "metadata": {
            "configuration": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            },
            "secret_id": "123e4567-e89b-12d3-a456-426614174000",
            "expiration_seconds": 1,
            "secrets": {},
            "labels": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            }
          },
          "resources": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "permission_denied": true,
          "name": "text"
        }
      },
      "resources": {
        "flavor": {
          "body": {
            "created": "2025-04-21T16:49:05.607Z",
            "updated": "2025-04-21T16:49:05.607Z",
            "user": {
              "body": {
                "created": "2025-04-21T16:49:05.607Z",
                "updated": "2025-04-21T16:49:05.607Z",
                "active": true,
                "activation_token": "text",
                "full_name": "text",
                "email_opted_in": true,
                "is_service_account": true,
                "is_admin": true,
                "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
              },
              "metadata": {
                "email": "text",
                "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
                "user_metadata": {
                  "ANY_ADDITIONAL_PROPERTY": "anything"
                }
              },
              "resources": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              },
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "permission_denied": true,
              "name": "text"
            },
            "type": "alerter",
            "integration": "text",
            "source": "text",
            "logo_url": "text",
            "is_custom": true
          },
          "metadata": {
            "config_schema": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            },
            "connector_type": "text",
            "connector_resource_type": "text",
            "connector_resource_id_attr": "text",
            "docs_url": "text",
            "sdk_docs_url": "text"
          },
          "resources": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "permission_denied": true,
          "name": "text"
        },
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "permission_denied": true,
      "name": "text"
    }
  ]
}

Get Stack Component

get

Returns the requested stack component.

Args: component_id: ID of the stack component. hydrate: Flag deciding whether to hydrate the output model(s) by including metadata fields in the response.

Returns: The requested stack component.

Authorizations

Path parameters

component_idstring · uuidRequired

Query parameters

hydratebooleanOptionalDefault: true

Responses

application/json

objectOptional

Response model for stack components.

application/json

application/json

application/json

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/components/{component_id} HTTP/1.1
Host: 
Accept: */*

{
  "body": {
    "created": "2025-04-21T16:49:05.607Z",
    "updated": "2025-04-21T16:49:05.607Z",
    "user": {
      "body": {
        "created": "2025-04-21T16:49:05.607Z",
        "updated": "2025-04-21T16:49:05.607Z",
        "active": true,
        "activation_token": "text",
        "full_name": "text",
        "email_opted_in": true,
        "is_service_account": true,
        "is_admin": true,
        "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
      },
      "metadata": {
        "email": "text",
        "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
        "user_metadata": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      },
      "resources": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "permission_denied": true,
      "name": "text"
    },
    "type": "alerter",
    "flavor_name": "text",
    "integration": "text",
    "logo_url": "text"
  },
  "metadata": {
    "configuration": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "labels": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "connector_resource_id": "text",
    "connector": {
      "body": {
        "created": "2025-04-21T16:49:05.607Z",
        "updated": "2025-04-21T16:49:05.607Z",
        "user": {
          "body": {
            "created": "2025-04-21T16:49:05.607Z",
            "updated": "2025-04-21T16:49:05.607Z",
            "active": true,
            "activation_token": "text",
            "full_name": "text",
            "email_opted_in": true,
            "is_service_account": true,
            "is_admin": true,
            "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
          },
          "metadata": {
            "email": "text",
            "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
            "user_metadata": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          },
          "resources": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "permission_denied": true,
          "name": "text"
        },
        "description": "text",
        "connector_type": "text",
        "auth_method": "text",
        "resource_types": [
          "text"
        ],
        "resource_id": "text",
        "supports_instances": true,
        "expires_at": "2025-04-21T16:49:05.607Z",
        "expires_skew_tolerance": 1
      },
      "metadata": {
        "configuration": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "secret_id": "123e4567-e89b-12d3-a456-426614174000",
        "expiration_seconds": 1,
        "secrets": {},
        "labels": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "resources": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "permission_denied": true,
      "name": "text"
    }
  },
  "resources": {
    "flavor": {
      "body": {
        "created": "2025-04-21T16:49:05.607Z",
        "updated": "2025-04-21T16:49:05.607Z",
        "user": {
          "body": {
            "created": "2025-04-21T16:49:05.607Z",
            "updated": "2025-04-21T16:49:05.607Z",
            "active": true,
            "activation_token": "text",
            "full_name": "text",
            "email_opted_in": true,
            "is_service_account": true,
            "is_admin": true,
            "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
          },
          "metadata": {
            "email": "text",
            "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
            "user_metadata": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          },
          "resources": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "permission_denied": true,
          "name": "text"
        },
        "type": "alerter",
        "integration": "text",
        "source": "text",
        "logo_url": "text",
        "is_custom": true
      },
      "metadata": {
        "config_schema": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "connector_type": "text",
        "connector_resource_type": "text",
        "connector_resource_id_attr": "text",
        "docs_url": "text",
        "sdk_docs_url": "text"
      },
      "resources": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "permission_denied": true,
      "name": "text"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "permission_denied": true,
  "name": "text"
}

Update Stack Component

put

Updates a stack component.

Args: component_id: ID of the stack component. component_update: Stack component to use to update.

Returns: Updated stack component.

Authorizations

Path parameters

component_idstring · uuidRequired

Body

Update model for stack components.

nameany ofOptional

configurationany ofOptional

connector_resource_idany ofOptional

The ID of a specific resource instance to gain access to through the connector

labelsany ofOptional

connectorany ofOptional

Responses

application/json

objectOptional

Response model for stack components.

application/json

application/json

application/json

application/json

put

HTTPcURLJavaScriptPython

PUT /api/v1/components/{component_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 200

{
  "name": "text",
  "configuration": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "connector_resource_id": "text",
  "labels": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "connector": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "body": {
    "created": "2025-04-21T16:49:05.607Z",
    "updated": "2025-04-21T16:49:05.607Z",
    "user": {
      "body": {
        "created": "2025-04-21T16:49:05.607Z",
        "updated": "2025-04-21T16:49:05.607Z",
        "active": true,
        "activation_token": "text",
        "full_name": "text",
        "email_opted_in": true,
        "is_service_account": true,
        "is_admin": true,
        "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
      },
      "metadata": {
        "email": "text",
        "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
        "user_metadata": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      },
      "resources": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "permission_denied": true,
      "name": "text"
    },
    "type": "alerter",
    "flavor_name": "text",
    "integration": "text",
    "logo_url": "text"
  },
  "metadata": {
    "configuration": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "labels": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "connector_resource_id": "text",
    "connector": {
      "body": {
        "created": "2025-04-21T16:49:05.607Z",
        "updated": "2025-04-21T16:49:05.607Z",
        "user": {
          "body": {
            "created": "2025-04-21T16:49:05.607Z",
            "updated": "2025-04-21T16:49:05.607Z",
            "active": true,
            "activation_token": "text",
            "full_name": "text",
            "email_opted_in": true,
            "is_service_account": true,
            "is_admin": true,
            "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
          },
          "metadata": {
            "email": "text",
            "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
            "user_metadata": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          },
          "resources": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "permission_denied": true,
          "name": "text"
        },
        "description": "text",
        "connector_type": "text",
        "auth_method": "text",
        "resource_types": [
          "text"
        ],
        "resource_id": "text",
        "supports_instances": true,
        "expires_at": "2025-04-21T16:49:05.607Z",
        "expires_skew_tolerance": 1
      },
      "metadata": {
        "configuration": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "secret_id": "123e4567-e89b-12d3-a456-426614174000",
        "expiration_seconds": 1,
        "secrets": {},
        "labels": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "resources": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "permission_denied": true,
      "name": "text"
    }
  },
  "resources": {
    "flavor": {
      "body": {
        "created": "2025-04-21T16:49:05.607Z",
        "updated": "2025-04-21T16:49:05.607Z",
        "user": {
          "body": {
            "created": "2025-04-21T16:49:05.607Z",
            "updated": "2025-04-21T16:49:05.607Z",
            "active": true,
            "activation_token": "text",
            "full_name": "text",
            "email_opted_in": true,
            "is_service_account": true,
            "is_admin": true,
            "default_project_id": "123e4567-e89b-12d3-a456-426614174000"
          },
          "metadata": {
            "email": "text",
            "external_user_id": "123e4567-e89b-12d3-a456-426614174000",
            "user_metadata": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          },
          "resources": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "permission_denied": true,
          "name": "text"
        },
        "type": "alerter",
        "integration": "text",
        "source": "text",
        "logo_url": "text",
        "is_custom": true
      },
      "metadata": {
        "config_schema": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "connector_type": "text",
        "connector_resource_type": "text",
        "connector_resource_id_attr": "text",
        "docs_url": "text",
        "sdk_docs_url": "text"
      },
      "resources": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "permission_denied": true,
      "name": "text"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "permission_denied": true,
  "name": "text"
}

Deregister Stack Component

delete

Deletes a stack component.

Args: component_id: ID of the stack component.

Authorizations

Path parameters

component_idstring · uuidRequired

Responses

application/json

anyOptional

application/json

application/json

application/json

application/json

delete

HTTPcURLJavaScriptPython

DELETE /api/v1/components/{component_id} HTTP/1.1
Host: 
Accept: */*

No content