Create Bundle Automation

Create a new bundle automation rule for a catalog that automatically syncs catalog membership from a query.

POST /api/v1/catalogs/{request_catalog_id}/bundle_automation/create

CreateBundleAutomation

Go

package main

import(
	"context"
	"github.com/conductorone/conductorone-sdk-go/pkg/models/shared"
	conductoronesdkgo "github.com/conductorone/conductorone-sdk-go"
	"github.com/conductorone/conductorone-sdk-go/pkg/models/operations"
	"log"
)

func main() {
    ctx := context.Background()

    s := conductoronesdkgo.New(
        conductoronesdkgo.WithSecurity(shared.Security{
            BearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
            Oauth: "<YOUR_OAUTH_HERE>",
        }),
    )

    res, err := s.RequestCatalogManagement.CreateBundleAutomation(ctx, operations.C1APIRequestcatalogV1RequestCatalogManagementServiceCreateBundleAutomationRequest{
        RequestCatalogID: "<id>",
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.BundleAutomation != nil {
        // handle response
    }
}

200

{
  "cel": {
    "expression": "<string>"
  },
  "circuitBreaker": {
    "removedMembersThresholdPercentage": "<string>",
    "state": "CIRCUIT_BREAKER_STATE_UNSPECIFIED",
    "updatedAt": "2023-11-07T05:31:56Z",
    "userRef": {
      "id": "<string>"
    }
  },
  "createTasks": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z",
  "disableCircuitBreaker": true,
  "enabled": true,
  "entitlements": {
    "entitlementRefs": [
      {
        "appId": "<string>",
        "id": "<string>"
      }
    ]
  },
  "requestCatalogId": "<string>",
  "state": {
    "celEvaluation": {
      "errorMessage": "<string>",
      "lastEvaluatedAt": "2023-11-07T05:31:56Z",
      "matchedUsers": "<string>",
      "status": "BUNDLE_AUTOMATION_RUN_STATUS_UNSPECIFIED"
    },
    "errorMessage": "<string>",
    "lastRunAt": "2023-11-07T05:31:56Z",
    "status": "BUNDLE_AUTOMATION_RUN_STATUS_UNSPECIFIED"
  },
  "tenantId": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization · string · header · required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Path Parameters

request_catalog_id · string · required

The unique identifier of the access profile to create the automation for.

Body

application/json

The request message for creating a new bundle automation rule on a catalog.

This message contains a oneof named conditions. Only a single field of the following list may be set at a time:

• entitlements
• cel

cel · Bundle Automation Rule Cel · object

The BundleAutomationRuleCEL message.

Show child attributes

createTasks · boolean

Whether to create access request tasks for matched users instead of granting directly.

disableCircuitBreaker · boolean

Whether to disable the circuit breaker that pauses the automation when excessive membership changes are detected.

enabled · boolean

Whether the automation should actively run on its schedule.

entitlements · Bundle Automation Rule Entitlement · object

The BundleAutomationRuleEntitlement message.

Show child attributes

Response

200 - application/json

Successful response

The BundleAutomation message.

This message contains a oneof named conditions. Only a single field of the following list may be set at a time:

• entitlements
• cel

cel · Bundle Automation Rule Cel · object

The BundleAutomationRuleCEL message.

Show child attributes

circuitBreaker · Bundle Automation Circuit Breaker · object

The BundleAutomationCircuitBreaker message.

Show child attributes

createTasks · boolean

The createTasks field.

createdAt · string<date-time>

deletedAt · string<date-time>

disableCircuitBreaker · boolean

The disableCircuitBreaker field.

enabled · boolean

The enabled field.

entitlements · Bundle Automation Rule Entitlement · object

The BundleAutomationRuleEntitlement message.

Show child attributes

requestCatalogId · string

The requestCatalogId field.

state · Bundle Automation Last Run State · object

The BundleAutomationLastRunState message.

Show child attributes

tenantId · string

The tenantId field.

updatedAt · string<date-time>