--- title: "Get Automation" method: GET path: "/api/v1/automations/{id}" tags: ["Automations"] --- # Get Automation `GET /api/v1/automations/{id}` Invokes the c1.api.automations.v1.AutomationService.GetAutomation method. ## Path parameters - `id` string, required — The id field. ## Response `200` Successful response - C1ApiAutomationsV1GetAutomationResponse — The GetAutomationResponse message. - `automation` C1ApiAutomationsV1Automation — The Automation message. - `automationSteps` C1ApiAutomationsV1AutomationStep[], nullable — The automationSteps field. - `connectorAction` C1ApiAutomationsV1ConnectorAction, nullable — The ConnectorAction message. This message contains a oneof named connector_identifier. Only a single field of the following list may be set at a time: - connectorRef - `actionName` string — The actionName field. - `argsTemplate` object - `connectorRef` C1ApiAppV1ConnectorRef, nullable — The ConnectorRef message. - `appId` string — The appId field. - `id` string — The id field. - `connectorCreateAccount` C1ApiAutomationsV1ConnectorCreateAccount, nullable — The ConnectorCreateAccount message. This message contains a oneof named create_account_arguments. Only a single field of the following list may be set at a time: - userIdCel - userProperties - `connectorRef` C1ApiAppV1ConnectorRef, nullable — The ConnectorRef message. - `appId` string — The appId field. - `id` string — The id field. - `userIdCel` string, nullable — The userIdCel field. This field is part of the `create_account_arguments` oneof. See the documentation for `c1.api.automations.v1.ConnectorCreateAccount` for more details. - `userProperties` C1ApiAutomationsV1UserProperties, nullable — The UserProperties message. - `displayNameCel` string — The displayNameCel field. - `emailCel` string — The emailCel field. - `profileAttributeCel` string — The profileAttributeCel field. - `usernameCel` string — The usernameCel field. - `createAccessReview` C1ApiAutomationsV1CreateAccessReview, nullable — The CreateAccessReview message. - `accessReviewTemplateCel` string — The accessReviewTemplateCel field. - `accessReviewTemplateId` string — The accessReviewTemplateId field. - `userIdsCel` string — The userIdsCel field. - `userRefs` C1ApiUserV1UserRef[], nullable — The userRefs field. - `id` string — The id of the user. - `createRevokeTasks` C1ApiAutomationsV1CreateRevokeTasks, nullable — The CreateRevokeTasks message. - `appEntitlementRefs` C1ApiAppV1AppEntitlementRef[], nullable — The appEntitlementRefs field. - `appId` string — The appId field. - `id` string — The id field. - `appEntitlementRefsCel` string — The appEntitlementRefsCel field. - `revokeAll` boolean — The revokeAll field. - `userIdCel` string — The userIdCel field. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `removeFromDelegation` C1ApiAutomationsV1RemoveFromDelegation, nullable — RemoveFromDelegation: find all users that have the target user as their delegated user, and clear the delegation. - `userIdCel` string — The userIdCel field. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `runAutomation` C1ApiAutomationsV1RunAutomation, nullable — RunAutomation: kick off the execution of an automation template. This message contains a oneof named automation_template. Only a single field of the following list may be set at a time: - automationTemplateRef - automationTemplateIdCel - `automationTemplateIdCel` string, nullable — The automationTemplateIdCel field. This field is part of the `automation_template` oneof. See the documentation for `c1.api.automations.v1.RunAutomation` for more details. - `automationTemplateRef` C1ApiAutomationsV1AutomationTemplateRef, nullable — The AutomationTemplateRef message. - `id` string — The id field. - `context` C1ApiAutomationsV1AutomationContext — The AutomationContext message. - `context` object - `sendEmail` C1ApiAutomationsV1SendEmail, nullable — The SendEmail message. - `body` string — The body field. - `subject` string — The subject field. - `title` string — The title field. - `userIdsCel` string — The userIdsCel field. - `userRefs` C1ApiUserV1UserRef[], nullable — The userRefs field. - `id` string — The id of the user. - `skipIfTrueCel` string — The skipIfTrueCel field. - `stepName` string — The stepName field. - `taskAction` C1ApiAutomationsV1TaskAction, nullable — The TaskAction message. This message contains a oneof named action. Only a single field of the following list may be set at a time: - close - reassign - `close` C1ApiAutomationsV1CloseAction, nullable — The CloseAction message. This message contains a oneof named user_identifier. Only a single field of the following list may be set at a time: - userIdCel - userRef - `userIdCel` string, nullable — The userIdCel field. This field is part of the `user_identifier` oneof. See the documentation for `c1.api.automations.v1.CloseAction` for more details. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `reassign` C1ApiAutomationsV1ReassignAction, nullable — The ReassignAction message. This message contains a oneof named assignee_user_identifier. Only a single field of the following list may be set at a time: - assigneeUserIdCel - assigneeUserRef This message contains a oneof named subject_user_identifier. Only a single field of the following list may be set at a time: - subjectUserIdCel - subjectUserRef - `assigneeUserIdCel` string, nullable — The assigneeUserIdCel field. This field is part of the `assignee_user_identifier` oneof. See the documentation for `c1.api.automations.v1.ReassignAction` for more details. - `assigneeUserRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `subjectUserIdCel` string, nullable — The subjectUserIdCel field. This field is part of the `subject_user_identifier` oneof. See the documentation for `c1.api.automations.v1.ReassignAction` for more details. - `subjectUserRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `unenrollFromAllAccessProfiles` C1ApiAutomationsV1UnenrollFromAllAccessProfiles, nullable — The UnenrollFromAllAccessProfiles message. - `catalogIds` string[], nullable — Optional list of catalog IDs to unenroll from. If empty, unenroll from all catalogs. - `userIdsCel` string — The userIdsCel field. - `userRefs` C1ApiUserV1UserRef[], nullable — The userRefs field. - `id` string — The id of the user. - `updateUser` C1ApiAutomationsV1UpdateUser, nullable — The UpdateUser message. This message contains a oneof named user. Only a single field of the following list may be set at a time: - userIdCel - userRef This message contains a oneof named user_status. Only a single field of the following list may be set at a time: - userStatusEnum - userStatusCel - `userIdCel` string, nullable — The userIdCel field. This field is part of the `user` oneof. See the documentation for `c1.api.automations.v1.UpdateUser` for more details. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `userStatusCel` string, nullable — The userStatusCel field. This field is part of the `user_status` oneof. See the documentation for `c1.api.automations.v1.UpdateUser` for more details. - `userStatusEnum` 'UNKNOWN' | 'ENABLED' | 'DISABLED' | 'DELETED', nullable — The userStatusEnum field. This field is part of the `user_status` oneof. See the documentation for `c1.api.automations.v1.UpdateUser` for more details. - `waitForDuration` C1ApiAutomationsV1WaitForDuration, nullable — The WaitForDuration message. - `duration` string, duration - `webhook` C1ApiAutomationsV1Webhook, nullable — The Webhook message. This message contains a oneof named webhook_identifier. Only a single field of the following list may be set at a time: - webhookId - webhookIdCel - `payload` object - `webhookId` string, nullable — The webhookId field. This field is part of the `webhook_identifier` oneof. See the documentation for `c1.api.automations.v1.Webhook` for more details. - `webhookIdCel` string, nullable — The webhookIdCel field. This field is part of the `webhook_identifier` oneof. See the documentation for `c1.api.automations.v1.Webhook` for more details. - `context` C1ApiAutomationsV1AutomationContext — The AutomationContext message. - `context` object - `createdAt` string, date-time - `currentVersion` string, int64 — The currentVersion field. - `description` string — The description field. - `displayName` string — The displayName field. - `draftAutomationSteps` C1ApiAutomationsV1AutomationStep[], nullable — The draftAutomationSteps field. - `connectorAction` C1ApiAutomationsV1ConnectorAction, nullable — The ConnectorAction message. This message contains a oneof named connector_identifier. Only a single field of the following list may be set at a time: - connectorRef - `actionName` string — The actionName field. - `argsTemplate` object - `connectorRef` C1ApiAppV1ConnectorRef, nullable — The ConnectorRef message. - `appId` string — The appId field. - `id` string — The id field. - `connectorCreateAccount` C1ApiAutomationsV1ConnectorCreateAccount, nullable — The ConnectorCreateAccount message. This message contains a oneof named create_account_arguments. Only a single field of the following list may be set at a time: - userIdCel - userProperties - `connectorRef` C1ApiAppV1ConnectorRef, nullable — The ConnectorRef message. - `appId` string — The appId field. - `id` string — The id field. - `userIdCel` string, nullable — The userIdCel field. This field is part of the `create_account_arguments` oneof. See the documentation for `c1.api.automations.v1.ConnectorCreateAccount` for more details. - `userProperties` C1ApiAutomationsV1UserProperties, nullable — The UserProperties message. - `displayNameCel` string — The displayNameCel field. - `emailCel` string — The emailCel field. - `profileAttributeCel` string — The profileAttributeCel field. - `usernameCel` string — The usernameCel field. - `createAccessReview` C1ApiAutomationsV1CreateAccessReview, nullable — The CreateAccessReview message. - `accessReviewTemplateCel` string — The accessReviewTemplateCel field. - `accessReviewTemplateId` string — The accessReviewTemplateId field. - `userIdsCel` string — The userIdsCel field. - `userRefs` C1ApiUserV1UserRef[], nullable — The userRefs field. - `id` string — The id of the user. - `createRevokeTasks` C1ApiAutomationsV1CreateRevokeTasks, nullable — The CreateRevokeTasks message. - `appEntitlementRefs` C1ApiAppV1AppEntitlementRef[], nullable — The appEntitlementRefs field. - `appId` string — The appId field. - `id` string — The id field. - `appEntitlementRefsCel` string — The appEntitlementRefsCel field. - `revokeAll` boolean — The revokeAll field. - `userIdCel` string — The userIdCel field. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `removeFromDelegation` C1ApiAutomationsV1RemoveFromDelegation, nullable — RemoveFromDelegation: find all users that have the target user as their delegated user, and clear the delegation. - `userIdCel` string — The userIdCel field. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `runAutomation` C1ApiAutomationsV1RunAutomation, nullable — RunAutomation: kick off the execution of an automation template. This message contains a oneof named automation_template. Only a single field of the following list may be set at a time: - automationTemplateRef - automationTemplateIdCel - `automationTemplateIdCel` string, nullable — The automationTemplateIdCel field. This field is part of the `automation_template` oneof. See the documentation for `c1.api.automations.v1.RunAutomation` for more details. - `automationTemplateRef` C1ApiAutomationsV1AutomationTemplateRef, nullable — The AutomationTemplateRef message. - `id` string — The id field. - `context` C1ApiAutomationsV1AutomationContext — The AutomationContext message. - `context` object - `sendEmail` C1ApiAutomationsV1SendEmail, nullable — The SendEmail message. - `body` string — The body field. - `subject` string — The subject field. - `title` string — The title field. - `userIdsCel` string — The userIdsCel field. - `userRefs` C1ApiUserV1UserRef[], nullable — The userRefs field. - `id` string — The id of the user. - `skipIfTrueCel` string — The skipIfTrueCel field. - `stepName` string — The stepName field. - `taskAction` C1ApiAutomationsV1TaskAction, nullable — The TaskAction message. This message contains a oneof named action. Only a single field of the following list may be set at a time: - close - reassign - `close` C1ApiAutomationsV1CloseAction, nullable — The CloseAction message. This message contains a oneof named user_identifier. Only a single field of the following list may be set at a time: - userIdCel - userRef - `userIdCel` string, nullable — The userIdCel field. This field is part of the `user_identifier` oneof. See the documentation for `c1.api.automations.v1.CloseAction` for more details. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `reassign` C1ApiAutomationsV1ReassignAction, nullable — The ReassignAction message. This message contains a oneof named assignee_user_identifier. Only a single field of the following list may be set at a time: - assigneeUserIdCel - assigneeUserRef This message contains a oneof named subject_user_identifier. Only a single field of the following list may be set at a time: - subjectUserIdCel - subjectUserRef - `assigneeUserIdCel` string, nullable — The assigneeUserIdCel field. This field is part of the `assignee_user_identifier` oneof. See the documentation for `c1.api.automations.v1.ReassignAction` for more details. - `assigneeUserRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `subjectUserIdCel` string, nullable — The subjectUserIdCel field. This field is part of the `subject_user_identifier` oneof. See the documentation for `c1.api.automations.v1.ReassignAction` for more details. - `subjectUserRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `unenrollFromAllAccessProfiles` C1ApiAutomationsV1UnenrollFromAllAccessProfiles, nullable — The UnenrollFromAllAccessProfiles message. - `catalogIds` string[], nullable — Optional list of catalog IDs to unenroll from. If empty, unenroll from all catalogs. - `userIdsCel` string — The userIdsCel field. - `userRefs` C1ApiUserV1UserRef[], nullable — The userRefs field. - `id` string — The id of the user. - `updateUser` C1ApiAutomationsV1UpdateUser, nullable — The UpdateUser message. This message contains a oneof named user. Only a single field of the following list may be set at a time: - userIdCel - userRef This message contains a oneof named user_status. Only a single field of the following list may be set at a time: - userStatusEnum - userStatusCel - `userIdCel` string, nullable — The userIdCel field. This field is part of the `user` oneof. See the documentation for `c1.api.automations.v1.UpdateUser` for more details. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `userStatusCel` string, nullable — The userStatusCel field. This field is part of the `user_status` oneof. See the documentation for `c1.api.automations.v1.UpdateUser` for more details. - `userStatusEnum` 'UNKNOWN' | 'ENABLED' | 'DISABLED' | 'DELETED', nullable — The userStatusEnum field. This field is part of the `user_status` oneof. See the documentation for `c1.api.automations.v1.UpdateUser` for more details. - `waitForDuration` C1ApiAutomationsV1WaitForDuration, nullable — The WaitForDuration message. - `duration` string, duration - `webhook` C1ApiAutomationsV1Webhook, nullable — The Webhook message. This message contains a oneof named webhook_identifier. Only a single field of the following list may be set at a time: - webhookId - webhookIdCel - `payload` object - `webhookId` string, nullable — The webhookId field. This field is part of the `webhook_identifier` oneof. See the documentation for `c1.api.automations.v1.Webhook` for more details. - `webhookIdCel` string, nullable — The webhookIdCel field. This field is part of the `webhook_identifier` oneof. See the documentation for `c1.api.automations.v1.Webhook` for more details. - `draftTriggers` C1ApiAutomationsV1AutomationTrigger[], nullable — The draftTriggers field. - `appUserCreated` C1ApiAutomationsV1AppUserCreatedTrigger, nullable — The AppUserCreatedTrigger message. This message contains a oneof named app_identifier. Only a single field of the following list may be set at a time: - appId - appIdCel - `appId` string, nullable — The appId field. This field is part of the `app_identifier` oneof. See the documentation for `c1.api.automations.v1.AppUserCreatedTrigger` for more details. - `appIdCel` string, nullable — The appIdCel field. This field is part of the `app_identifier` oneof. See the documentation for `c1.api.automations.v1.AppUserCreatedTrigger` for more details. - `appUserUpdated` C1ApiAutomationsV1AppUserUpdatedTrigger, nullable — The AppUserUpdatedTrigger message. This message contains a oneof named app_identifier. Only a single field of the following list may be set at a time: - appId - appIdCel - `appId` string, nullable — The appId field. This field is part of the `app_identifier` oneof. See the documentation for `c1.api.automations.v1.AppUserUpdatedTrigger` for more details. - `appIdCel` string, nullable — The appIdCel field. This field is part of the `app_identifier` oneof. See the documentation for `c1.api.automations.v1.AppUserUpdatedTrigger` for more details. - `condition` string — The condition field. - `manual` C1ApiAutomationsV1ManualAutomationTrigger, nullable — The ManualAutomationTrigger message. - `userProfileChange` C1ApiAutomationsV1UserProfileChangeTrigger, nullable — The UserProfileChangeTrigger message. - `profileAttributeCel` string — The profileAttributeCel field. - `profileAttributeKey` string — The profileAttributeKey field. - `enabled` boolean — The enabled field. - `id` string — The id field. - `isDraft` boolean — The isDraft field. - `lastExecutedAt` string, date-time - `triggers` C1ApiAutomationsV1AutomationTrigger[], nullable — The triggers field. - `appUserCreated` C1ApiAutomationsV1AppUserCreatedTrigger, nullable — The AppUserCreatedTrigger message. This message contains a oneof named app_identifier. Only a single field of the following list may be set at a time: - appId - appIdCel - `appId` string, nullable — The appId field. This field is part of the `app_identifier` oneof. See the documentation for `c1.api.automations.v1.AppUserCreatedTrigger` for more details. - `appIdCel` string, nullable — The appIdCel field. This field is part of the `app_identifier` oneof. See the documentation for `c1.api.automations.v1.AppUserCreatedTrigger` for more details. - `appUserUpdated` C1ApiAutomationsV1AppUserUpdatedTrigger, nullable — The AppUserUpdatedTrigger message. This message contains a oneof named app_identifier. Only a single field of the following list may be set at a time: - appId - appIdCel - `appId` string, nullable — The appId field. This field is part of the `app_identifier` oneof. See the documentation for `c1.api.automations.v1.AppUserUpdatedTrigger` for more details. - `appIdCel` string, nullable — The appIdCel field. This field is part of the `app_identifier` oneof. See the documentation for `c1.api.automations.v1.AppUserUpdatedTrigger` for more details. - `condition` string — The condition field. - `manual` C1ApiAutomationsV1ManualAutomationTrigger, nullable — The ManualAutomationTrigger message. - `userProfileChange` C1ApiAutomationsV1UserProfileChangeTrigger, nullable — The UserProfileChangeTrigger message. - `profileAttributeCel` string — The profileAttributeCel field. - `profileAttributeKey` string — The profileAttributeKey field. ## Changes - **2025-05-30** `d5c56e8615fe` — 1 info - endpoint added [Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/automations/:id/get.md) --- [API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/d5c56e8615fe/schema)