Sign in

v3

latestSwagger 2.02026-08-067506752.0 MB
scenario

Create a scenario

post/v1/org/{orgId}/scenario

Path parameters

orgIdstring required

Org identifier (either id or slug)

Query parameters

silentboolean

Suppress notification emails

skipChangeCreationboolean

Skip over change creation for PROMOTION scenarios

Request body

namestring required

scenario name

descriptionstring

scenario description

startDatestring date

date that this scenario diverges from primary

status'OPEN' | 'INACTIVE' | 'MERGED' | 'DRAFT' | 'ARCHIVED'

status of scenario

type'GENERAL' | 'COMP' | 'PROMOTION' | 'TERMINATE' | 'CREATE_JOB' | 'UPDATE_JOB' | 'BUDGET' | 'BACKFILL'

Type of scenario to be created

startDateFixed'FIXED' | 'TODAY' required

whether or not the start date should stay fixed in time, or update to today's date as time passes

querystring

Query for selecting which people/jobs are initially included in the scenario (only applies to promotion scenarios)

validJobIdSetstring[]

This scenario changes are restricted to the following jobIds

entityIdstring

The entity this scenario is associated with

entityType'COMP_REVIEW'

The type of entity associated with this scenario

Example request

{
  "name": "Q4 Conservative Plan",
  "description": "Q4 Conservative Plan",
  "startDate": "2017-01-15",
  "shareAccess": [
    {
      "userId": "5887a7718f138b6a2a0041a7",
      "groupId": "5887a7718f138b6a2a0041a7",
      "fields": "name,image,title"
    }
  ],
  "validJobIdSet": [
    "588f7ee98f138b19220041a7"
  ],
  "entityId": "588f7ee98f138b19220041a7",
  "sharedViewConfig": [
    {
      "updateId": "588f7ee98f138b19220041a7"
    }
  ]
}

Response

scenario created

idstring required

globally unique id

orgIdstring required

parent organization id

namestring required

scenario name

descriptionstring

scenario description

startDatestring date required

date that this scenario diverges from primary

status'OPEN' | 'INACTIVE' | 'MERGED' | 'DRAFT' | 'ARCHIVED' required

status of scenario

changeCountinteger

number of changes contained in scenario

changeCountsobject

number of changes of each type contained in scenario

createIdstring required

created by user id

createBehalfIdstring

created on behalf of user id

createAtstring required

created timestamp

updateIdstring required

last updated by user id

updateBehalfIdstring

last updated on behalf of user id

updateAtstring required

last updated timestamp

deleteIdstring

deleted by user id

deleteBehalfIdstring

deleted on behalf of user id

deleteAtstring

deleted timestamp

mergeIdstring

merged by user id

mergeAtstring

merged timestamp

calcStartAtstring

most recent summary calculation started at timestamp

calcEndAtstring

most recent summary calculation ended at timestamp

changeAtstring

timestamp of most recent changes made to scenario

changeIdstring

user who made the most recent change to scenario

type'GENERAL' | 'COMP' | 'PROMOTION' | 'TERMINATE' | 'CREATE_JOB' | 'UPDATE_JOB' | 'BUDGET' | 'BACKFILL'

Type of scenario to be created

startDateFixed'FIXED' | 'TODAY' required

whether or not the start date should stay fixed in time, or update to today's date as time passes

querystring

Query for selecting which people/jobs are initially included in the scenario (only applies to promotion scenarios)

validJobIdSetstring[]

This scenario changes are restricted to the following jobIds

approvalRequestIdstring

Approval request id, if the scenario has been submitted for approval

entityIdstring

The entity this scenario is associated with

entityType'COMP_REVIEW'

The type of entity associated with this scenario

Example response

{
  "id": "588f7ee98f138b19220041a7",
  "orgId": "588f7ee98f138b19220041a7",
  "name": "Q4 Conservative Plan",
  "description": "Q4 Conservative Plan",
  "startDate": "2017-01-15",
  "shareAccess": [
    {
      "userId": "5887a7718f138b6a2a0041a7",
      "groupId": "5887a7718f138b6a2a0041a7",
      "fields": "name,image,title"
    }
  ],
  "createId": "588f7ee98f138b19220041a7",
  "createBehalfId": "588f7ee98f138b19220041a7",
  "createAttribution": {
    "principalUserId": "588f7ee98f138b19220041a7",
    "agentUserIds": [
      "588f7ee98f138b19220041a7"
    ],
    "eventId": "588f7ee98f138b19220041a7",
    "aiChatId": "588f7ee98f138b19220041a7"
  },
  "createAt": "2017-01-24T13:57:52Z",
  "updateId": "588f7ee98f138b19220041a7",
  "updateBehalfId": "588f7ee98f138b19220041a7",
  "updateAttribution": {
    "principalUserId": "588f7ee98f138b19220041a7",
    "agentUserIds": [
      "588f7ee98f138b19220041a7"
    ],
    "eventId": "588f7ee98f138b19220041a7",
    "aiChatId": "588f7ee98f138b19220041a7"
  },
  "updateAt": "2017-01-24T13:57:52Z",
  "deleteId": "588f7ee98f138b19220041a7",
  "deleteBehalfId": "588f7ee98f138b19220041a7",
  "deleteAttribution": {
    "principalUserId": "588f7ee98f138b19220041a7",
    "agentUserIds": [
      "588f7ee98f138b19220041a7"
    ],
    "eventId": "588f7ee98f138b19220041a7",
    "aiChatId": "588f7ee98f138b19220041a7"
  },
  "deleteAt": "2017-01-24T13:57:52Z",
  "mergeId": "588f7ee98f138b19220041a7",
  "mergeAt": "2017-01-24T13:57:52Z",
  "calcStartAt": "2017-01-24T13:57:52Z",
  "calcEndAt": "2017-01-24T13:57:52Z",
  "changeAt": "2017-01-24T13:57:52Z",
  "changeId": "2017-01-24T13:57:52Z",
  "validJobIdSet": [
    "588f7ee98f138b19220041a7"
  ],
  "approvalRequestId": "588f7ee98f138b19220041a7",
  "entityId": "588f7ee98f138b19220041a7",
  "sharedViewConfig": [
    {
      "updateId": "588f7ee98f138b19220041a7"
    }
  ]
}