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

# Trainings > Training > Update statuses

Subscription_type: `trainings/training/update_status`

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Factorial API",
    "description": "",
    "version": "2026-10-01"
  },
  "webhooks": {
    "Webhooks > Trainings > Training > Update statuses": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `trainings/training/update_status`",
        "deprecated": false,
        "summary": "Trainings > Training > Update statuses",
        "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/trainings_training"
              }
            }
          }
        }
      }
    }
  },
  "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": {
      "trainings_training": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "author_id",
          "name",
          "description",
          "external",
          "fundae_subsidized",
          "subsidized",
          "cost",
          "subsidized_cost",
          "cost_decimal",
          "subsidized_cost_decimal",
          "year",
          "catalog",
          "competency_ids",
          "total_training_cost",
          "total_training_indirect_cost",
          "total_training_salary_cost",
          "total_training_subsidized_cost",
          "total_participants",
          "training_attendance_status",
          "total_duration",
          "is_mandatory"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier of the course",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Company identifier",
            "example": "1"
          },
          "author_id": {
            "type": "string",
            "description": "The person that creates the training",
            "example": "20"
          },
          "author_employee_id": {
            "type": "string",
            "description": "Employee identifier of the training author",
            "example": "15"
          },
          "name": {
            "type": "string",
            "description": "Name of the training",
            "example": "Communication Course"
          },
          "code": {
            "type": "string",
            "description": "Code of the training",
            "example": "COM-101"
          },
          "description": {
            "type": "string",
            "description": "Description of the training",
            "example": "Intermediate-level communication course that focuses on building and enhancing language skills."
          },
          "created_at": {
            "type": "string",
            "description": "Creation date of the course",
            "example": "2025-02-04T10:31:48.000Z"
          },
          "updated_at": {
            "type": "string",
            "description": "Last modification date of the course",
            "example": "2025-02-04T10:31:48.000Z"
          },
          "external_provider": {
            "type": "string",
            "description": "The name of the provider if any"
          },
          "external": {
            "type": "boolean",
            "description": "External training",
            "example": false
          },
          "total_cost": {
            "type": "integer",
            "example": 0
          },
          "fundae_subsidized": {
            "type": "boolean",
            "description": "Subsidized by Fundae",
            "example": false
          },
          "subsidized": {
            "type": "boolean",
            "description": "Marked as subsidized",
            "example": false
          },
          "cost": {
            "type": "integer",
            "example": 0
          },
          "subsidized_cost": {
            "type": "integer",
            "example": 0
          },
          "total_cost_decimal": {
            "type": "string",
            "example": "0.0"
          },
          "cost_decimal": {
            "type": "string",
            "example": "0.0"
          },
          "subsidized_cost_decimal": {
            "type": "string",
            "example": "0.0"
          },
          "category_ids": {
            "type": "array",
            "description": "List of ids of training categories",
            "example": [
              "1",
              "20"
            ],
            "items": {
              "type": "string"
            }
          },
          "status": {
            "type": "string",
            "description": "Training status. Can be one of the following values",
            "enum": [
              "draft",
              "active",
              "deleted"
            ],
            "example": "active"
          },
          "year": {
            "type": "integer",
            "description": "Year of the training",
            "example": 2025
          },
          "catalog": {
            "type": "boolean",
            "description": "Visible in catalog",
            "example": true
          },
          "competency_ids": {
            "type": "array",
            "description": "List of ids of training competencies",
            "example": [
              "1",
              "3"
            ],
            "items": {
              "type": "string"
            }
          },
          "total_training_cost": {
            "type": "string",
            "description": "The total direct cost of all course's groups",
            "example": "0.0"
          },
          "total_training_indirect_cost": {
            "type": "string",
            "description": "The total indirect cost of all course's groups",
            "example": "0.0"
          },
          "total_training_salary_cost": {
            "type": "string",
            "description": "The total salary cost of all course's groups",
            "example": "0.0"
          },
          "total_training_subsidized_cost": {
            "type": "string",
            "description": "The total subsidized cost of all course's groups",
            "example": "0.0"
          },
          "total_participants": {
            "type": "integer",
            "description": "Number of participants of all course's groups",
            "example": 0
          },
          "training_attendance_status": {
            "type": "string",
            "enum": [
              "notassigned",
              "notstarted",
              "missing",
              "started",
              "partiallycompleted",
              "completed"
            ],
            "example": "completed"
          },
          "valid_for": {
            "type": "integer",
            "description": "Number of years this course is valid for"
          },
          "objectives": {
            "type": "string",
            "description": "Objectives of the course",
            "example": "Build and enhance language skills."
          },
          "number_of_expired_participants": {
            "type": "integer",
            "description": "Number of participants that have the course expired or about to expire in the next 3 months. Only applicable to trainings with validity period.",
            "example": 2
          },
          "total_duration": {
            "type": "number",
            "description": "The total duration in hours and minutes of the course",
            "example": 2.5
          },
          "is_mandatory": {
            "type": "boolean",
            "description": "This field is used to define if the training is mandatory or not",
            "example": false
          }
        }
      }
    }
  }
}
```