Skip to content

participants

participants add

Add a participant to a case in a given role

Usage

bash
pega participants add <caseId> [flags]

Source endpoint: POST /cases/{caseID}/participantsview command source

Arguments

ArgumentRequiredDescription
caseIdYesCase ID

Flags

FlagTypeRequiredDefaultDescription
--formatoptionNojsonOutput format (json, compact, yaml, table)
--fieldsoptionNoComma-separated top-level fields to include in output
--dry-runbooleanNoPrint HTTP request details and exit without executing
--quietbooleanNoSuppress all stderr progress/warning output
--verbosebooleanNoEmit full HTTP request/response details to stderr
--no-cachebooleanNoBypass token file cache; perform fresh OAuth exchange
--profileoptionNodefaultNamed config profile
--roleoptionYesParticipant role ID (e.g. Customer, Owner)
--dataoptionYesJSON content page: {pyFirstName,pyLastName,pyEmail1,pyPhoneNumber,...} (inline, @file, or -)

Examples

sh
pega participants add MYAPP-CASE-1 --role Customer --data '{"pyFirstName":"Jane","pyLastName":"Doe","pyEmail1":"jane@example.com","pyPhoneNumber":""}'

participants delete

Remove a participant from a case

Usage

bash
pega participants delete <caseId> [flags]

Source endpoint: DELETE /cases/{caseID}/participants/{participantID}view command source

Arguments

ArgumentRequiredDescription
caseIdYesCase ID

Flags

FlagTypeRequiredDefaultDescription
--formatoptionNojsonOutput format (json, compact, yaml, table)
--fieldsoptionNoComma-separated top-level fields to include in output
--dry-runbooleanNoPrint HTTP request details and exit without executing
--quietbooleanNoSuppress all stderr progress/warning output
--verbosebooleanNoEmit full HTTP request/response details to stderr
--no-cachebooleanNoBypass token file cache; perform fresh OAuth exchange
--profileoptionNodefaultNamed config profile
--participant-idoptionYesParticipant instance ID

Examples

sh
pega participants delete MYAPP-CASE-1 --participant-id PEGA-PART-X

participants get

Get a specific participant by participant ID

Usage

bash
pega participants get <caseId> [flags]

Source endpoint: GET /cases/{caseID}/participants/{participantID}view command source

Arguments

ArgumentRequiredDescription
caseIdYesCase ID

Flags

FlagTypeRequiredDefaultDescription
--formatoptionNojsonOutput format (json, compact, yaml, table)
--fieldsoptionNoComma-separated top-level fields to include in output
--dry-runbooleanNoPrint HTTP request details and exit without executing
--quietbooleanNoSuppress all stderr progress/warning output
--verbosebooleanNoEmit full HTTP request/response details to stderr
--no-cachebooleanNoBypass token file cache; perform fresh OAuth exchange
--profileoptionNodefaultNamed config profile
--participant-idoptionYesParticipant instance ID

Examples

sh
pega participants get MYAPP-CASE-1 --participant-id PEGA-PART-X

participants get-role

Get details of a specific participant role on a case

Usage

bash
pega participants get-role <caseId> [flags]

Source endpoint: GET /cases/{caseID}/participant_roles/{participant_role_ID}view command source

Arguments

ArgumentRequiredDescription
caseIdYesCase ID

Flags

FlagTypeRequiredDefaultDescription
--formatoptionNojsonOutput format (json, compact, yaml, table)
--fieldsoptionNoComma-separated top-level fields to include in output
--dry-runbooleanNoPrint HTTP request details and exit without executing
--quietbooleanNoSuppress all stderr progress/warning output
--verbosebooleanNoEmit full HTTP request/response details to stderr
--no-cachebooleanNoBypass token file cache; perform fresh OAuth exchange
--profileoptionNodefaultNamed config profile
--role-idoptionYesParticipant role ID

Examples

sh
pega participants get-role MYAPP-CASE-1 --role-id Owner

participants list

List all participants on a case

Usage

bash
pega participants list <caseId> [flags]

Source endpoint: GET /cases/{caseID}/participantsview command source

Arguments

ArgumentRequiredDescription
caseIdYesCase ID

Flags

FlagTypeRequiredDefaultDescription
--formatoptionNojsonOutput format (json, compact, yaml, table)
--fieldsoptionNoComma-separated top-level fields to include in output
--dry-runbooleanNoPrint HTTP request details and exit without executing
--quietbooleanNoSuppress all stderr progress/warning output
--verbosebooleanNoEmit full HTTP request/response details to stderr
--no-cachebooleanNoBypass token file cache; perform fresh OAuth exchange
--profileoptionNodefaultNamed config profile

Examples

sh
pega participants list MYAPP-CASE-1

participants list-roles

List participant roles configured on a case

Usage

bash
pega participants list-roles <caseId> [flags]

Source endpoint: GET /cases/{caseID}/participant_rolesview command source

Arguments

ArgumentRequiredDescription
caseIdYesCase ID

Flags

FlagTypeRequiredDefaultDescription
--formatoptionNojsonOutput format (json, compact, yaml, table)
--fieldsoptionNoComma-separated top-level fields to include in output
--dry-runbooleanNoPrint HTTP request details and exit without executing
--quietbooleanNoSuppress all stderr progress/warning output
--verbosebooleanNoEmit full HTTP request/response details to stderr
--no-cachebooleanNoBypass token file cache; perform fresh OAuth exchange
--profileoptionNodefaultNamed config profile

Examples

sh
pega participants list-roles MYAPP-CASE-1

participants update

Update a participant's details

Usage

bash
pega participants update <caseId> [flags]

Source endpoint: PATCH /cases/{caseID}/participants/{participantID}view command source

Arguments

ArgumentRequiredDescription
caseIdYesCase ID

Flags

FlagTypeRequiredDefaultDescription
--formatoptionNojsonOutput format (json, compact, yaml, table)
--fieldsoptionNoComma-separated top-level fields to include in output
--dry-runbooleanNoPrint HTTP request details and exit without executing
--quietbooleanNoSuppress all stderr progress/warning output
--verbosebooleanNoEmit full HTTP request/response details to stderr
--no-cachebooleanNoBypass token file cache; perform fresh OAuth exchange
--profileoptionNodefaultNamed config profile
--participant-idoptionYesParticipant instance ID
--dataoptionNoJSON content (inline, @file, or -)
--page-instructionsoptionNoJSON page-instructions array
--attachmentsoptionNoJSON attachments array

Examples

sh
pega participants update MYAPP-CASE-1 --participant-id PEGA-PART-X --data '{"email":"a@b.com"}'