--- title: "Get Workflow" method: GET path: "/api/v1beta/workflows/{id}" tags: ["Workflows"] --- # Get Workflow `GET /api/v1beta/workflows/{id}` Invokes the c1.api.workflows.v1beta.WorkflowService.GetWorkflow method. ## Path parameters - `id` string, required — The id field. ## Response `200` Successful response - C1ApiWorkflowsV1betaGetWorkflowResponse — The GetWorkflowResponse message. - `workflow` C1ApiWorkflowsV1betaWorkflow — The Workflow message. - `context` C1ApiWorkflowsV1betaWorkflowContext — The WorkflowContext message. - `context` object - `createdAt` string, date-time - `description` string — The description field. - `displayName` string — The displayName field. - `enabled` boolean — The enabled field. - `id` string — The id field. - `lastExecutedAt` string, date-time - `triggers` C1ApiWorkflowsV1betaWorkflowTrigger[], nullable — The triggers field. - `appUserCreated` C1ApiWorkflowsV1betaAppUserCreatedTrigger, 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.workflows.v1beta.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.workflows.v1beta.AppUserCreatedTrigger` for more details. - `appUserUpdated` C1ApiWorkflowsV1betaAppUserUpdatedTrigger, 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.workflows.v1beta.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.workflows.v1beta.AppUserUpdatedTrigger` for more details. - `condition` string — The condition field. - `manual` C1ApiWorkflowsV1betaManualWorkflowTrigger, nullable — The ManualWorkflowTrigger message. - `userProfileChange` C1ApiWorkflowsV1betaUserProfileChangeTrigger, nullable — The UserProfileChangeTrigger message. - `profileAttributeKey` string — The profileAttributeKey field. - `workflowSteps` C1ApiWorkflowsV1betaWorkflowStep[], nullable — The workflowSteps field. - `connectorAction` C1ApiWorkflowsV1betaConnectorAction, 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. - `createAccessReview` C1ApiWorkflowsV1betaCreateAccessReview, 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` C1ApiWorkflowsV1betaCreateRevokeTasks, 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` C1ApiWorkflowsV1betaRemoveFromDelegation, 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. - `runWorkflow` C1ApiWorkflowsV1betaRunWorkflow, nullable — RunWorkflow: kick off the execution of a workflow template. This message contains a oneof named workflow_template. Only a single field of the following list may be set at a time: - workflowTemplateRef - workflowTemplateIdCel - `context` C1ApiWorkflowsV1betaWorkflowContext — The WorkflowContext message. - `context` object - `workflowTemplateIdCel` string, nullable — The workflowTemplateIdCel field. This field is part of the `workflow_template` oneof. See the documentation for `c1.api.workflows.v1beta.RunWorkflow` for more details. - `workflowTemplateRef` C1ApiWorkflowsV1betaWorkflowTemplateRef, nullable — The WorkflowTemplateRef message. - `id` string — The id field. - `sendEmail` C1ApiWorkflowsV1betaSendEmail, 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` C1ApiWorkflowsV1betaTaskAction, 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` C1ApiWorkflowsV1betaCloseAction, 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.workflows.v1beta.CloseAction` for more details. - `userRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `reassign` C1ApiWorkflowsV1betaReassignAction, 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.workflows.v1beta.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.workflows.v1beta.ReassignAction` for more details. - `subjectUserRef` C1ApiUserV1UserRef — A reference to a user. - `id` string — The id of the user. - `unenrollFromAllAccessProfiles` C1ApiWorkflowsV1betaUnenrollFromAllAccessProfiles, 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` C1ApiWorkflowsV1betaUpdateUser, 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.workflows.v1beta.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.workflows.v1beta.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.workflows.v1beta.UpdateUser` for more details. - `waitForDuration` C1ApiWorkflowsV1betaWaitForDuration, nullable — The WaitForDuration message. - `duration` string, duration - `webhook` C1ApiWorkflowsV1betaWebhook, 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.workflows.v1beta.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.workflows.v1beta.Webhook` for more details. ## Changes - **2025-04-10** `17f9f3bcedd5` — 1 info - endpoint added [Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1beta/workflows/: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/17f9f3bcedd5/schema)