---
updatedAt: 2026-05-05T13:44:18.000Z
agentTools:
  projectIndex: https://apidocs.eightfold.ai/llms.txt
---

# Upsert Application Stage

Create or advance application stage for a given profile and position

# OpenAPI definition

```json
{
  "servers": [
    {
      "url": "https://apiv2.{domain}.ai",
      "variables": {
        "domain": {
          "default": "eightfold",
          "enum": [
            "eightfold",
            "eightfold-eu",
            "eightfold-gov",
            "eightfold-ca",
            "eightfold-wu",
            "eightfold-ap"
          ]
        }
      }
    }
  ],
  "paths": {
    "/api/v2/core/profiles/{profileId}/application/stages": {
      "post": {
        "description": "Create or advance application stage for a given profile and position",
        "operationId": "create_profile_stages",
        "parameters": [
          {
            "description": "The secret key to access the api. It starts with the bearer token",
            "in": "header",
            "name": "Authorization",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Profile ID of profile whose application has to be created or stage advanced",
            "in": "path",
            "name": "profileId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateOrAdvanceApplicationStageSchema"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SuccessMessageSchema"
                }
              }
            },
            "description": "OK"
          }
        },
        "summary": "Upsert Application Stage",
        "tags": [
          "Profile"
        ]
      }
    }
  },
  "info": {
    "title": "Api_server_v2_service Service",
    "version": "1.0.0"
  },
  "openapi": "3.0.2",
  "components": {
    "schemas": {
      "ApplicationQuestionAnswers": {
        "type": "object",
        "properties": {
          "answer": {
            "type": "string",
            "nullable": true,
            "description": "Answer of candidate Application question answers"
          },
          "questionId": {
            "type": "string",
            "nullable": true,
            "description": "question ID of candidate Application question answers"
          },
          "displayOrder": {
            "type": "string",
            "writeOnly": true,
            "nullable": true,
            "description": "Display order of the question on the ATS questionnaire; required by Workday to match the answer"
          },
          "question": {
            "type": "string",
            "nullable": true,
            "description": "question of candidate Application question answers"
          }
        },
        "required": [
          "question",
          "questionId"
        ]
      },
      "ApplicationCreationSource": {
        "type": "object",
        "properties": {
          "sourceType": {
            "type": "string",
            "nullable": true,
            "description": "Source type"
          },
          "sourceName": {
            "type": "string",
            "nullable": true,
            "description": "Source name"
          }
        },
        "required": [
          "sourceType"
        ]
      },
      "CreateOrAdvanceApplicationStageSchema": {
        "type": "object",
        "properties": {
          "isReject": {
            "type": "boolean",
            "nullable": true,
            "description": "Is application rejected?"
          },
          "newStage": {
            "type": "string",
            "nullable": true,
            "description": "new stage for the application"
          },
          "actionUserEmail": {
            "type": "string",
            "nullable": true,
            "description": "Email of the user taking this action"
          },
          "scheduledRejectionTime": {
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "description": "Unix epoch timestamp in seconds (UTC) for a scheduled rejection. Must be at least 15 minutes in the future."
          },
          "applicationAnswers": {
            "nullable": true,
            "description": "Candidate questionnaire responses to attach to the application",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApplicationQuestionAnswers"
            }
          },
          "prevSubStage": {
            "type": "string",
            "nullable": true,
            "description": "Previous sub stage for the application"
          },
          "reason": {
            "type": "string",
            "nullable": true,
            "description": "reasons for new stage"
          },
          "newSubStage": {
            "type": "string",
            "nullable": true,
            "description": "New sub stage for the application"
          },
          "prevStage": {
            "type": "string",
            "nullable": true,
            "description": "Previous stage for the application"
          },
          "applicationCreationSource": {
            "nullable": true,
            "description": "Application creation source",
            "allOf": [
              {
                "$ref": "#/components/schemas/ApplicationCreationSource"
              }
            ]
          },
          "positionId": {
            "type": "string",
            "nullable": true,
            "description": "Position Id of the corresponding position"
          },
          "comment": {
            "type": "string",
            "nullable": true,
            "description": "Comments for an application stage"
          },
          "applicationId": {
            "type": "string",
            "nullable": true,
            "description": "Application id of the application"
          }
        },
        "required": [
          "newStage",
          "positionId",
          "reason"
        ]
      },
      "SuccessMessageSchema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "readOnly": true,
            "nullable": true,
            "description": ""
          }
        }
      }
    }
  }
}
```