--- title: "Get" method: GET path: "/api/v1/catalogs/{id}" tags: ["Request Catalog"] --- # Get `GET /api/v1/catalogs/{id}` Get a catalog. ## Path parameters - `id` string, required — The id field. ## Response `200` The request catalog management service get response returns a request catalog view with the expanded items in the expanded array indicated by the expand mask in the request. - C1ApiRequestcatalogV1RequestCatalogManagementServiceGetResponse — The request catalog management service get response returns a request catalog view with the expanded items in the expanded array indicated by the expand mask in the request. - `expanded` object[], nullable — List of serialized related objects. - `@type` string — The type of the serialized message. - `requestCatalogView` C1ApiRequestcatalogV1RequestCatalogView — The request catalog view contains the serialized request catalog and paths to objects referenced by the request catalog. - `accessEntitlementsPath` string — JSONPATH expression indicating the location of the access entitlement objects, that the request catalog allows users to request, in the array. - `createdByUserPath` string — JSONPATH expression indicating the location of the User object, that created the request catalog, in the array. - `memberCount` string, int64 — Total number of the members of the catalog - `requestCatalog` C1ApiRequestcatalogV1RequestCatalog — The RequestCatalog is used for managing which entitlements are requestable, and who can request them. - `accessEntitlements` C1ApiAppV1AppEntitlement[], nullable — An array of app entitlements that, if the user has, can view the contents of this catalog. - `alias` string — The alias of the app entitlement used by Cone. Also exact-match queryable. - `annotations` object — Bounded key/value metadata bag for IaC marking and customer tags. See .rfcs/object-annotations.md §2. Limits: ≤16 entries; keys 1–128 chars matching ^[A-Za-z][A-Za-z0-9._/-]{0,127}$; values 0–256 chars URL-safe ASCII; total serialized ≤ 4096 bytes. Keys matching ^c1/ are reserved. Well-known keys: `managed_by`, `iac_workspace`, `iac_resource_address`, `iac_tool_version`. - `appId` string — The ID of the app that is associated with the app entitlement. - `appResourceId` string — The ID of the app resource that is associated with the app entitlement - `appResourceTypeId` string — The ID of the app resource type that is associated with the app entitlement - `certifyPolicyId` string — The ID of the policy that will be used for certify tickets related to the app entitlement. - `complianceFrameworkValueIds` string[], nullable — The IDs of different compliance frameworks associated with this app entitlement ex (SOX, HIPAA, PCI, etc.) - `createdAt` string, date-time - `defaultValuesApplied` boolean — Flag to indicate if app-level access request defaults have been applied to the entitlement - `deletedAt` string, date-time - `deprovisionerPolicy` C1ApiPolicyV1ProvisionPolicy — ProvisionPolicy is a oneOf that indicates how a provision step should be processed. This message contains a oneof named typ. Only a single field of the following list may be set at a time: - connector - manual - delegated - webhook - multiStep - externalTicket - unconfigured - action - `action` C1ApiPolicyV1ActionProvision, nullable — This provision step indicates that account lifecycle action should be called to provision this entitlement. - `actionName` string — The actionName field. - `appId` string — The appId field. - `connectorId` string — The connectorId field. - `displayName` string — The displayName field. - `connector` C1ApiPolicyV1ConnectorProvision, nullable — Indicates that a connector should perform the provisioning. This object has no fields. This message contains a oneof named provision_type. Only a single field of the following list may be set at a time: - defaultBehavior - account - deleteAccount - `account` C1ApiPolicyV1ConnectorProvisionAccountProvision, nullable — The AccountProvision message. This message contains a oneof named storage_type. Only a single field of the following list may be set at a time: - saveToVault - doNotSave - … - `defaultBehavior` C1ApiPolicyV1ConnectorProvisionDefaultBehavior, nullable — The DefaultBehavior message. - … - `deleteAccount` C1ApiPolicyV1ConnectorProvisionDeleteAccount, nullable — The DeleteAccount message. - … - `delegated` C1ApiPolicyV1DelegatedProvision, nullable — This provision step indicates that we should delegate provisioning to the configuration of another app entitlement. This app entitlement does not have to be one from the same app, but MUST be configured as a proxy binding leading into this entitlement. - `appId` string — The AppID of the entitlement to delegate provisioning to. - `entitlementId` string — The ID of the entitlement we are delegating provisioning to. - `implicit` boolean — If true, a binding will be automatically created from the entitlement of the parent app. - `externalTicket` C1ApiPolicyV1ExternalTicketProvision, nullable — This provision step indicates that we should check an external ticket to provision this entitlement - `appId` string — The appId field. - `connectorId` string — The connectorId field. - `externalTicketProvisionerConfigId` string — The externalTicketProvisionerConfigId field. - `instructions` string — This field indicates a text body of instructions for the provisioner to indicate. - `manual` C1ApiPolicyV1ManualProvision, nullable — Manual provisioning indicates that a human must intervene for the provisioning of this step. - `assignee` C1ApiPolicyV1ProvisionerAssignment — ProvisionerAssignment defines how a provisioner is dynamically assigned. This message contains a oneof named typ. Only a single field of the following list may be set at a time: - users - appOwners - group - manager - expression - entitlementOwners - … - `instructions` string — This field indicates a text body of instructions for the provisioner to indicate. - `userIds` string[], nullable — An array of users that are required to provision during this step. Deprecated: Use assignee field instead for dynamic provisioner assignment. - `multiStep` C1ApiPolicyV1MultiStep, nullable — MultiStep indicates that this provision step has multiple steps to process. - `provisionSteps` C1ApiPolicyV1ProvisionPolicy[], nullable — The array of provision steps to process. - `unconfigured` C1ApiPolicyV1UnconfiguredProvision, nullable — The UnconfiguredProvision message. - `webhook` C1ApiPolicyV1WebhookProvision, nullable — This provision step indicates that a webhook should be called to provision this entitlement. - `webhookId` string — The ID of the webhook to call for provisioning. - `description` string — The description of the app entitlement. - `displayName` string — The display name of the app entitlement. - `durationGrant` string, duration - `durationUnset` object, nullable - `emergencyGrantEnabled` boolean — This enables tasks to be created in an emergency and use a selected emergency access policy. - `emergencyGrantPolicyId` string — The ID of the policy that will be used for emergency access grant tasks. - `externalId` string — The upstream product's native external ID for this entitlement (e.g. an Okta group ID). Populated from the connector's external ID during sync. - `grantCount` string, int64 — The amount of grants open for this entitlement - `grantPolicyId` string — The ID of the policy that will be used for grant tickets related to the app entitlement. - `id` string — The unique ID for the App Entitlement. - `isAutomationEnabled` boolean — Flag to indicate whether automation (for adding users to entitlement based on rules) has been enabled. - `isManuallyManaged` boolean — Flag to indicate if the app entitlement is manually managed. - `matchBatonId` string — An identifier used to match this entitlement to a connector-synced entitlement during sync. - `overrideAccessRequestsDefaults` boolean — Flag to indicate if the app-level access request settings have been overridden for the entitlement - `provisionerPolicy` C1ApiPolicyV1ProvisionPolicy — ProvisionPolicy is a oneOf that indicates how a provision step should be processed. This message contains a oneof named typ. Only a single field of the following list may be set at a time: - connector - manual - delegated - webhook - multiStep - externalTicket - unconfigured - action - `action` C1ApiPolicyV1ActionProvision, nullable — This provision step indicates that account lifecycle action should be called to provision this entitlement. - `actionName` string — The actionName field. - `appId` string — The appId field. - `connectorId` string — The connectorId field. - `displayName` string — The displayName field. - `connector` C1ApiPolicyV1ConnectorProvision, nullable — Indicates that a connector should perform the provisioning. This object has no fields. This message contains a oneof named provision_type. Only a single field of the following list may be set at a time: - defaultBehavior - account - deleteAccount - `account` C1ApiPolicyV1ConnectorProvisionAccountProvision, nullable — The AccountProvision message. This message contains a oneof named storage_type. Only a single field of the following list may be set at a time: - saveToVault - doNotSave - … - `defaultBehavior` C1ApiPolicyV1ConnectorProvisionDefaultBehavior, nullable — The DefaultBehavior message. - … - `deleteAccount` C1ApiPolicyV1ConnectorProvisionDeleteAccount, nullable — The DeleteAccount message. - … - `delegated` C1ApiPolicyV1DelegatedProvision, nullable — This provision step indicates that we should delegate provisioning to the configuration of another app entitlement. This app entitlement does not have to be one from the same app, but MUST be configured as a proxy binding leading into this entitlement. - `appId` string — The AppID of the entitlement to delegate provisioning to. - `entitlementId` string — The ID of the entitlement we are delegating provisioning to. - `implicit` boolean — If true, a binding will be automatically created from the entitlement of the parent app. - `externalTicket` C1ApiPolicyV1ExternalTicketProvision, nullable — This provision step indicates that we should check an external ticket to provision this entitlement - `appId` string — The appId field. - `connectorId` string — The connectorId field. - `externalTicketProvisionerConfigId` string — The externalTicketProvisionerConfigId field. - `instructions` string — This field indicates a text body of instructions for the provisioner to indicate. - `manual` C1ApiPolicyV1ManualProvision, nullable — Manual provisioning indicates that a human must intervene for the provisioning of this step. - `assignee` C1ApiPolicyV1ProvisionerAssignment — ProvisionerAssignment defines how a provisioner is dynamically assigned. This message contains a oneof named typ. Only a single field of the following list may be set at a time: - users - appOwners - group - manager - expression - entitlementOwners - … - `instructions` string — This field indicates a text body of instructions for the provisioner to indicate. - `userIds` string[], nullable — An array of users that are required to provision during this step. Deprecated: Use assignee field instead for dynamic provisioner assignment. - `multiStep` C1ApiPolicyV1MultiStep, nullable — MultiStep indicates that this provision step has multiple steps to process. - `provisionSteps` C1ApiPolicyV1ProvisionPolicy[], nullable — The array of provision steps to process. - `unconfigured` C1ApiPolicyV1UnconfiguredProvision, nullable — The UnconfiguredProvision message. - `webhook` C1ApiPolicyV1WebhookProvision, nullable — This provision step indicates that a webhook should be called to provision this entitlement. - `webhookId` string — The ID of the webhook to call for provisioning. - `purpose` 'APP_ENTITLEMENT_PURPOSE_VALUE_UNSPECIFIED' | 'APP_ENTITLEMENT_PURPOSE_VALUE_ASSIGNMENT' | 'APP_ENTITLEMENT_PURPOSE_VALUE_PERMISSION' | 'APP_ENTITLEMENT_PURPOSE_VALUE_OWNERSHIP' — The purpose of this entitlement (e.g., assignment, permission, ownership). - `requestSchemaId` string — The ID of the request schema associated with this app entitlement. - `revokePolicyId` string — The ID of the policy that will be used for revoke tickets related to the app entitlement - `riskLevelValueId` string — The ID of the risk level assigned to this entitlement. - `slug` string — The slug is displayed as an oval next to the name in the frontend of C1, it tells you what permission the entitlement grants. See https://www.conductorone.com/docs/product/admin/entitlements/ - `sourceConnectorIds` object — Map to tell us which connector the entitlement came from. - `systemBuiltin` boolean — This field indicates if this is a system builtin entitlement. - `updatedAt` string, date-time - `userEditedMask` string, nullable - `annotations` object — Bounded key/value metadata bag for IaC marking and customer tags. See .rfcs/object-annotations.md §2. Limits: ≤16 entries; keys 1–128 chars matching ^[A-Za-z][A-Za-z0-9._/-]{0,127}$; values 0–256 chars URL-safe ASCII; total serialized ≤ 4096 bytes. Keys matching ^c1/ are reserved. Well-known keys: `managed_by`, `iac_workspace`, `iac_resource_address`, `iac_tool_version`. - `createdAt` string, date-time - `createdByUserId` string — The id of the user this request catalog was created by. - `deletedAt` string, date-time - `description` string — The description of the request catalog. - `displayName` string — The display name of the request catalog. - `enrollmentBehavior` 'REQUEST_CATALOG_ENROLLMENT_BEHAVIOR_UNSPECIFIED' | 'REQUEST_CATALOG_ENROLLMENT_BEHAVIOR_BYPASS_ENTITLEMENT_REQUEST_POLICY' | 'REQUEST_CATALOG_ENROLLMENT_BEHAVIOR_ENFORCE_ENTITLEMENT_REQUEST_POLICY' — Defines how to handle the request policies of the entitlements in the catalog during enrollment. - `id` string — The id of the request catalog. - `published` boolean — Whether or not this catalog is published. - `requestBundle` boolean — Whether all the entitlements in the catalog can be requests at once. Your tenant must have the bundles feature to use this. - `unenrollmentBehavior` 'REQUEST_CATALOG_UNENROLLMENT_BEHAVIOR_UNSPECIFIED' | 'REQUEST_CATALOG_UNENROLLMENT_BEHAVIOR_LEAVE_ACCESS_AS_IS' | 'REQUEST_CATALOG_UNENROLLMENT_BEHAVIOR_REVOKE_ALL' | 'REQUEST_CATALOG_UNENROLLMENT_BEHAVIOR_REVOKE_UNJUSTIFIED' — Defines how to handle the revocation of the entitlements in the catalog during unenrollment. - `unenrollmentEntitlementBehavior` 'REQUEST_CATALOG_UNENROLLMENT_ENTITLEMENT_BEHAVIOR_UNSPECIFIED' | 'REQUEST_CATALOG_UNENROLLMENT_ENTITLEMENT_BEHAVIOR_BYPASS' | 'REQUEST_CATALOG_UNENROLLMENT_ENTITLEMENT_BEHAVIOR_ENFORCE' — Defines how to handle the revoke policies of the entitlements in the catalog during unenrollment. - `updatedAt` string, date-time - `visibleToEveryone` boolean — If this is true, the access entitlement requirement is ignored. --- [API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/d391405a35d3/schema)