---
updatedAt: 2026-04-21T16:11:36.000Z
agentTools:
  projectIndex: https://apidoc.factorialhr.com/llms.txt
---

# Performance > ReviewProcess > Toggle archives

Subscription_type: `performance/review_process/toggle_archive`

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Factorial API",
    "description": "",
    "version": "2026-10-01"
  },
  "webhooks": {
    "Webhooks > Performance > ReviewProcess > Toggle archives": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `performance/review_process/toggle_archive`",
        "deprecated": false,
        "summary": "Performance > ReviewProcess > Toggle archives",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/performance_review_process"
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://api.factorialhr.com",
      "description": "Production server"
    },
    {
      "url": "https://api.demo.factorial.dev",
      "description": "Demo server (deprecated)"
    },
    {
      "url": "https://api.eu2.demo.factorial.dev",
      "description": "Demo server"
    }
  ],
  "security": [
    {
      "oauth2": []
    }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://id.factorialhr.com/oauth/authorize",
            "tokenUrl": "https://id.factorialhr.com/api/oauth/token",
            "refreshUrl": "https://id.factorialhr.com/api/oauth/token",
            "scopes": {
              "read": "Required for all operations",
              "write": "Required for write operations",
              "approvals": "Access to approvals",
              "banking": "Access to banking",
              "company_holidays": "Access to company holidays",
              "company_legal_entities": "Access to company legal entities",
              "company_locations": "Access to company locations",
              "compensations": "Access to compensations",
              "contracts": "Access to contracts",
              "custom_fields": "Access to custom fields",
              "documents": "Access to documents",
              "employee_updates": "Access to employee updates",
              "employees": "Access to employees",
              "expenses": "Access to expenses",
              "finance": "Access to finance",
              "integrations": "Access to integrations",
              "it_management": "Access to it management",
              "job_catalog": "Access to job catalog",
              "marketplace": "Access to marketplace",
              "payroll": "Access to payroll",
              "payroll_supplements": "Access to payroll supplements",
              "performance": "Access to performance",
              "posts": "Access to posts",
              "processes": "Access to processes",
              "project_management_expenses": "Access to project management expenses",
              "project_management_projects": "Access to project management projects",
              "project_management_time": "Access to project management time",
              "recruitment": "Access to recruitment",
              "shift_management": "Access to shift management",
              "tasks": "Access to tasks",
              "time_off": "Access to time off",
              "time_tracking": "Access to time tracking",
              "trainings": "Access to trainings"
            }
          }
        }
      }
    },
    "schemas": {
      "performance_review_process": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "status",
          "start_validation_errors",
          "archived",
          "agreements_configuration",
          "competencies_assessments_configuration"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Review process ID",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Company ID",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Review process name",
            "example": "Performance Review - Q1 2024"
          },
          "description": {
            "type": "string",
            "description": "A brief description of the review process",
            "example": "The performance review for the first quarter of 2024 has started!"
          },
          "status": {
            "type": "string",
            "description": "Review process status",
            "enum": [
              "draft",
              "scheduled",
              "starting",
              "active",
              "finished"
            ],
            "example": "draft"
          },
          "target_strategy": {
            "type": "object",
            "description": "Condition that defines the employees that will be evaluated (participants). Calculated when the review process starts",
            "example": {
              "arguments": [],
              "strategy": "all_employees"
            },
            "properties": {
              "strategy": {
                "type": "string",
                "enum": [
                  "all_employees",
                  "by_locations",
                  "by_teams",
                  "by_employees",
                  "manual_selection"
                ]
              },
              "arguments": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "strategy"
            ]
          },
          "reviewer_strategies": {
            "type": "array",
            "description": "Review types that will be assigned to the review process. It'll be used to create the evaluations when the process starts",
            "enum": [
              "self",
              "manager",
              "direct_reports",
              "peers"
            ],
            "example": [
              "self",
              "manager"
            ],
            "items": {
              "type": "string"
            }
          },
          "starts_at": {
            "type": "string",
            "description": "Date when the review process should start",
            "example": "2024-01-01T00:00:00.000Z"
          },
          "ends_at": {
            "type": "string",
            "description": "Date when the review process should end",
            "example": "2024-04-01T00:00:00.000Z"
          },
          "start_validation_errors": {
            "type": "array",
            "description": "Missing or invalid information to be able to start the review process",
            "enum": [
              "missing_deadline",
              "invalid_deadline",
              "missing_title",
              "missing_target_strategy",
              "missing_target_strategy_members",
              "missing_reviewer_strategy",
              "missing_questions",
              "missing_potential_reviewers",
              "invalid_section_weights_sum"
            ],
            "example": [
              "invalid_deadline",
              "missing_target_strategy_members"
            ],
            "items": {
              "type": "string"
            }
          },
          "archived": {
            "type": "boolean",
            "description": "Whether the review process is archived or not",
            "example": false
          },
          "agreements_configuration": {
            "type": "object",
            "description": "Action plans help track goal progress, and facilitate performance review discussions.",
            "example": {
              "enabled": true
            },
            "properties": {
              "enabled": {
                "type": "boolean"
              },
              "esignature_enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled",
              "esignature_enabled"
            ]
          },
          "competencies_assessments_configuration": {
            "type": "object",
            "description": "Assess employees based on their assigned competencies through both manager and self-reviews. Ensure roles with designated competencies are properly set up.",
            "example": {
              "enabled": false
            },
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ]
          },
          "last_bulk_reminder": {
            "type": "string",
            "description": "Date when the last bulk reminder was sent",
            "example": "2024-03-01T00:00:00.000Z"
          }
        }
      }
    }
  }
}
```