> For the complete documentation index, see [llms.txt](https://api-docs.myhappyforce.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.myhappyforce.com/docs/api-reference/action-plans.md).

# Action Plans

Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan.

## List action plans

> Returns a paginated slice of action plans, sorted newest-first. Each plan includes its actions — filtered when any filter param is set. \*\*With filters:\*\* only plans with at least one matching action are returned; each plan's \`actions\[]\` contains only matching actions; \`total\` counts matching plans. \*\*Without filters:\*\* all plans, all actions. \`from\` / \`to\` are zero-based offset / exclusive end index.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"PaginableGenericResultListActionPlanDTO":{"type":"object","properties":{"from":{"type":"integer","format":"int32"},"to":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64"},"result":{"type":"array","items":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"ActionPlanDTO":{"type":"object","description":"Action plan — a named container grouping one or more improvement actions under a shared goal","properties":{"id":{"type":"string","description":"Unique plan identifier"},"companyId":{"type":"string","description":"Company that owns this plan"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the plan's goal (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed description of the plan's objective (multilingual)"},"actions":{"type":"array","description":"Actions belonging to this plan","items":{"$ref":"#/components/schemas/ActionDTO"}},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to the plan creator.","enum":["PUBLIC","PRIVATE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of actions in this plan that have reached COMPLETED status (0–100). Computed on-the-fly; never stored."},"createdBy":{"type":"string","description":"User who created this plan; may be the system for coordinator-proposed plans"},"kind":{"type":"string","description":"Who this plan belongs to.","enum":["MANAGER","HAPPYFORCE"]},"ownerId":{"type":"string","description":"The person accountable for this plan — distinct from createdBy. Legacy plans report the creator here."},"state":{"type":"string","description":"Lifecycle state. Legacy plans report APPROVED.","enum":["PROPOSED","APPROVED","REJECTED","UNATTENDED","IN_PROGRESS","CLOSED"]},"period":{"type":"string","format":"date-time","description":"First day of the month this plan belongs to."},"objective":{"$ref":"#/components/schemas/Objective","description":"What the plan is trying to move, and by when."},"scope":{"type":"array","description":"Hierarchies this plan's audience is scoped to. Empty or null means company-wide.","items":{"type":"string"},"uniqueItems":true},"origin":{"$ref":"#/components/schemas/Origin","description":"Where this plan came from."},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting the objective — never free prose.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the owner's scope (multilingual)."},"changeLog":{"type":"array","description":"Edits the owner made against the original proposal, oldest first. Only populated while editing a PROPOSED plan — see action-plan-lifecycle.","items":{"$ref":"#/components/schemas/ChangeLogEntry"}},"rejectionReason":{"type":"string","description":"Reason recorded when the owner rejected this plan; null otherwise."},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"ActionDTO":{"type":"object","description":"Complete action payload returned by the API","properties":{"id":{"type":"string","description":"Unique action identifier"},"companyId":{"type":"string","description":"Company that owns this action"},"planId":{"type":"string","description":"Parent action plan identifier. Every action belongs to a plan."},"plan":{"$ref":"#/components/schemas/PlanSummary","description":"Lightweight plan summary (id, title, description)."},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the action (multilingual: defaultValue = main language, langValues = translations)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed execution plan describing how and when (multilingual)"},"focusItems":{"type":"array","description":"One or more focus indicators this action is anchored to. At least one is always present.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"assigneeStatuses":{"type":"array","description":"Per-assignee lifecycle states. Each entry tracks one manager's individual progress. The global status field is the aggregate of all entries.","items":{"$ref":"#/components/schemas/AssigneeStatusDTO"}},"hierarchyIds":{"type":"array","description":"Areas/hierarchies this action targets. Empty means company-wide scope.","items":{"type":"string"},"uniqueItems":true},"groupIds":{"type":"array","description":"Groups this action targets.","items":{"type":"string"},"uniqueItems":true},"characteristics":{"type":"array","description":"Employee characteristic segments this action targets.","items":{"oneOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBoolean"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueDate"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueList"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueTree"}]},"uniqueItems":true},"actionType":{"type":"string","description":"Scope of the action. MANAGER = individual manager action; COMPANY = cross-team action initiated by an admin.","enum":["MANAGER","COMPANY"]},"source":{"type":"string","description":"How the action was originated. MANUAL = created by the user; SUGGESTION = proposed by a company action; AI = generated by the AI assistant.","enum":["MANUAL","SUGGESTION","AI"]},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to assignees/creator.","enum":["PUBLIC","PRIVATE"]},"role":{"type":"string","description":"The part this action plays within its plan.","enum":["EXECUTE","COORDINATE","ACCOMPANY","ENABLE"]},"status":{"type":"string","description":"Aggregate lifecycle status (computed from all assignee states).","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of assignees who have individually reached COMPLETED status (0–100). Computed on-the-fly from assigneeStatuses; never stored."},"dueDate":{"type":"string","format":"date-time","description":"Target completion date"},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when the first assignee moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when all assignees reached a terminal status"},"createdBy":{"type":"string","description":"User who created this action"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"},"notes":{"type":"array","description":"Execution log notes (bitácora). Visibility-filtered: PRIVATE notes are only returned when the caller is the author. Not populated in list responses — only in single-action detail (GET /actions/{id}).","items":{"$ref":"#/components/schemas/ActionNoteDTO"}},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting this action, when it was proposed by the coordinator — never free prose. Empty for actions created directly by a person.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the assignee's own scope, when this action was proposed by the coordinator; null otherwise."}}},"PlanSummary":{"type":"object","description":"Lightweight plan reference — id, title and description only","properties":{"id":{"type":"string","description":"Plan identifier"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan title (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan goal description (multilingual)"}}},"ActionFocusItem":{"type":"object","discriminator":{"propertyName":"focusType"},"properties":{"focusType":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"focusId":{"type":"string"},"targetValue":{"type":"number","format":"double"},"targetTimestamp":{"type":"string","format":"date-time"},"noTargetReason":{"type":"string"}}},"CommentThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"commentIds":{"type":"array","items":{"type":"string"}},"linkedIndicators":{"type":"array","items":{"$ref":"#/components/schemas/LinkedIndicator"}},"noLinkReason":{"type":"string"}}}]},"LinkedIndicator":{"type":"object","properties":{"type":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"indicatorId":{"type":"string"}}},"ENPSFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"FactorFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"HIFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"InferredThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"anchorQuestionIds":{"type":"array","items":{"type":"string"}}}}]},"QuestionFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ScoreFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"AssigneeStatusDTO":{"type":"object","description":"Per-assignee lifecycle state within an action","properties":{"assigneeId":{"type":"string","description":"Assignee (manager) identifier"},"status":{"type":"string","description":"This assignee's current lifecycle status","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee first moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee reached a terminal status"},"notApplicableReason":{"type":"string","description":"Reason this assignee recorded when moving to NOT_APPLICABLE; null otherwise."},"notApplicableAt":{"type":"string","format":"date-time","description":"Timestamp when notApplicableReason was recorded; null otherwise."}}},"EmployeeCharacteristicValueBoolean":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"boolean"}}}]},"EmployeeCharacteristicValueBase":{"type":"object","description":"Base class for employee characteristic values","discriminator":{"propertyName":"questionType","mapping":{"LIST":"#/components/schemas/EmployeeCharacteristicValueList","DATE":"#/components/schemas/EmployeeCharacteristicValueDate","BOOLEAN":"#/components/schemas/EmployeeCharacteristicValueBoolean","TREE":"#/components/schemas/EmployeeCharacteristicValueTree"}},"properties":{"characteristicId":{"type":"string"},"id":{"type":"string"},"questionType":{"$ref":"#/components/schemas/CharacteristicType"}}},"CharacteristicType":{"type":"string","description":"Type of segmentation characteristic","enum":["DATE","LIST","BOOLEAN","TREE"]},"EmployeeCharacteristicValueDate":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"string"}}}]},"EmployeeCharacteristicValueList":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"}}}]},"EmployeeCharacteristicValueTree":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"},"assignedPath":{"type":"array","items":{"type":"string"}},"assignedOn":{"type":"string","format":"date-time"}}}]},"ActionNoteDTO":{"type":"object","description":"A single note appended to the action execution log","properties":{"id":{"type":"string","description":"Note identifier (unique within the parent action)"},"authorId":{"type":"string","description":"User who wrote the note"},"content":{"type":"string","description":"Note body text"},"visibility":{"type":"string","description":"Who can see this note. PRIVATE = only the author; SHARED = all action participants.","enum":["PRIVATE","SHARED"]},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"}}},"Objective":{"type":"object","description":"What the plan is trying to move, and by when","properties":{"focusItems":{"type":"array","description":"Focus indicators (with target values) the plan aims to move.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"horizon":{"type":"string","format":"date-time","description":"Date by which the objective is expected to be reached."}}},"Origin":{"type":"object","description":"Where the plan came from","properties":{"source":{"type":"string","description":"How the plan was originated.","enum":["MANUAL","SUGGESTION","AI","TEMPLATE","COORDINATOR"]},"candidateIds":{"type":"array","description":"Candidate ids this plan was built from; empty for plans created directly by a person.","items":{"type":"string"}}}},"ChangeLogEntry":{"type":"object","description":"One recorded edit against the plan's original proposal","properties":{"changedBy":{"type":"string","description":"Who made the change."},"changedAt":{"type":"string","format":"date-time","description":"When the change was made."},"field":{"type":"string","description":"Which field changed."},"before":{"type":"string","description":"The value before the change, as text."},"after":{"type":"string","description":"The value after the change, as text."}}}}},"paths":{"/api/v1/company/action-plans":{"get":{"tags":["Action Plans"],"summary":"List action plans","description":"Returns a paginated slice of action plans, sorted newest-first. Each plan includes its actions — filtered when any filter param is set. **With filters:** only plans with at least one matching action are returned; each plan's `actions[]` contains only matching actions; `total` counts matching plans. **Without filters:** all plans, all actions. `from` / `to` are zero-based offset / exclusive end index.","operationId":"listPlans","parameters":[{"name":"from","in":"query","description":"Zero-based start index (default 0)","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"to","in":"query","description":"Exclusive end index (default 10)","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"name":"status","in":"query","description":"Filter plans whose actions have this status","required":false,"schema":{"type":"string","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]}},{"name":"focusType","in":"query","description":"Filter plans whose actions target this focus type","required":false,"schema":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]}},{"name":"hierarchyId","in":"query","description":"Filter plans whose actions target this hierarchy","required":false,"schema":{"type":"string"}},{"name":"assigneeId","in":"query","description":"Filter plans whose actions include this assignee","required":false,"schema":{"type":"string"}},{"name":"actionType","in":"query","description":"Filter plans whose actions target this action type","required":false,"schema":{"type":"string","enum":["MANAGER","COMPANY"]}},{"name":"q","in":"query","description":"Free-text search on action title and description (case-insensitive contains)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paginated plan list, each with their (filtered) actions","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaginableGenericResultListActionPlanDTO"}}}}}}}}}
```

## Create a new action plan

> Creates an empty action plan. Once created, actions can be added by creating them with the plan's ID.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CreateActionPlanRequestDTO":{"type":"object","description":"Request payload for creating a new action plan","properties":{"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the plan's goal (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed description of the plan's objective (multilingual)"},"visibility":{"type":"string","description":"Visibility for the plan. Defaults to PRIVATE when omitted.","enum":["PUBLIC","PRIVATE"]},"kind":{"type":"string","description":"Who this plan belongs to. Defaults to MANAGER when omitted.","enum":["MANAGER","HAPPYFORCE"]},"ownerId":{"type":"string","description":"The person accountable for this plan. Defaults to the authenticated creator when omitted."}},"required":["description","title"]},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"ActionPlanDTO":{"type":"object","description":"Action plan — a named container grouping one or more improvement actions under a shared goal","properties":{"id":{"type":"string","description":"Unique plan identifier"},"companyId":{"type":"string","description":"Company that owns this plan"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the plan's goal (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed description of the plan's objective (multilingual)"},"actions":{"type":"array","description":"Actions belonging to this plan","items":{"$ref":"#/components/schemas/ActionDTO"}},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to the plan creator.","enum":["PUBLIC","PRIVATE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of actions in this plan that have reached COMPLETED status (0–100). Computed on-the-fly; never stored."},"createdBy":{"type":"string","description":"User who created this plan; may be the system for coordinator-proposed plans"},"kind":{"type":"string","description":"Who this plan belongs to.","enum":["MANAGER","HAPPYFORCE"]},"ownerId":{"type":"string","description":"The person accountable for this plan — distinct from createdBy. Legacy plans report the creator here."},"state":{"type":"string","description":"Lifecycle state. Legacy plans report APPROVED.","enum":["PROPOSED","APPROVED","REJECTED","UNATTENDED","IN_PROGRESS","CLOSED"]},"period":{"type":"string","format":"date-time","description":"First day of the month this plan belongs to."},"objective":{"$ref":"#/components/schemas/Objective","description":"What the plan is trying to move, and by when."},"scope":{"type":"array","description":"Hierarchies this plan's audience is scoped to. Empty or null means company-wide.","items":{"type":"string"},"uniqueItems":true},"origin":{"$ref":"#/components/schemas/Origin","description":"Where this plan came from."},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting the objective — never free prose.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the owner's scope (multilingual)."},"changeLog":{"type":"array","description":"Edits the owner made against the original proposal, oldest first. Only populated while editing a PROPOSED plan — see action-plan-lifecycle.","items":{"$ref":"#/components/schemas/ChangeLogEntry"}},"rejectionReason":{"type":"string","description":"Reason recorded when the owner rejected this plan; null otherwise."},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"}}},"ActionDTO":{"type":"object","description":"Complete action payload returned by the API","properties":{"id":{"type":"string","description":"Unique action identifier"},"companyId":{"type":"string","description":"Company that owns this action"},"planId":{"type":"string","description":"Parent action plan identifier. Every action belongs to a plan."},"plan":{"$ref":"#/components/schemas/PlanSummary","description":"Lightweight plan summary (id, title, description)."},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the action (multilingual: defaultValue = main language, langValues = translations)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed execution plan describing how and when (multilingual)"},"focusItems":{"type":"array","description":"One or more focus indicators this action is anchored to. At least one is always present.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"assigneeStatuses":{"type":"array","description":"Per-assignee lifecycle states. Each entry tracks one manager's individual progress. The global status field is the aggregate of all entries.","items":{"$ref":"#/components/schemas/AssigneeStatusDTO"}},"hierarchyIds":{"type":"array","description":"Areas/hierarchies this action targets. Empty means company-wide scope.","items":{"type":"string"},"uniqueItems":true},"groupIds":{"type":"array","description":"Groups this action targets.","items":{"type":"string"},"uniqueItems":true},"characteristics":{"type":"array","description":"Employee characteristic segments this action targets.","items":{"oneOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBoolean"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueDate"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueList"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueTree"}]},"uniqueItems":true},"actionType":{"type":"string","description":"Scope of the action. MANAGER = individual manager action; COMPANY = cross-team action initiated by an admin.","enum":["MANAGER","COMPANY"]},"source":{"type":"string","description":"How the action was originated. MANUAL = created by the user; SUGGESTION = proposed by a company action; AI = generated by the AI assistant.","enum":["MANUAL","SUGGESTION","AI"]},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to assignees/creator.","enum":["PUBLIC","PRIVATE"]},"role":{"type":"string","description":"The part this action plays within its plan.","enum":["EXECUTE","COORDINATE","ACCOMPANY","ENABLE"]},"status":{"type":"string","description":"Aggregate lifecycle status (computed from all assignee states).","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of assignees who have individually reached COMPLETED status (0–100). Computed on-the-fly from assigneeStatuses; never stored."},"dueDate":{"type":"string","format":"date-time","description":"Target completion date"},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when the first assignee moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when all assignees reached a terminal status"},"createdBy":{"type":"string","description":"User who created this action"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"},"notes":{"type":"array","description":"Execution log notes (bitácora). Visibility-filtered: PRIVATE notes are only returned when the caller is the author. Not populated in list responses — only in single-action detail (GET /actions/{id}).","items":{"$ref":"#/components/schemas/ActionNoteDTO"}},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting this action, when it was proposed by the coordinator — never free prose. Empty for actions created directly by a person.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the assignee's own scope, when this action was proposed by the coordinator; null otherwise."}}},"PlanSummary":{"type":"object","description":"Lightweight plan reference — id, title and description only","properties":{"id":{"type":"string","description":"Plan identifier"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan title (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan goal description (multilingual)"}}},"ActionFocusItem":{"type":"object","discriminator":{"propertyName":"focusType"},"properties":{"focusType":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"focusId":{"type":"string"},"targetValue":{"type":"number","format":"double"},"targetTimestamp":{"type":"string","format":"date-time"},"noTargetReason":{"type":"string"}}},"CommentThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"commentIds":{"type":"array","items":{"type":"string"}},"linkedIndicators":{"type":"array","items":{"$ref":"#/components/schemas/LinkedIndicator"}},"noLinkReason":{"type":"string"}}}]},"LinkedIndicator":{"type":"object","properties":{"type":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"indicatorId":{"type":"string"}}},"ENPSFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"FactorFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"HIFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"InferredThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"anchorQuestionIds":{"type":"array","items":{"type":"string"}}}}]},"QuestionFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ScoreFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"AssigneeStatusDTO":{"type":"object","description":"Per-assignee lifecycle state within an action","properties":{"assigneeId":{"type":"string","description":"Assignee (manager) identifier"},"status":{"type":"string","description":"This assignee's current lifecycle status","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee first moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee reached a terminal status"},"notApplicableReason":{"type":"string","description":"Reason this assignee recorded when moving to NOT_APPLICABLE; null otherwise."},"notApplicableAt":{"type":"string","format":"date-time","description":"Timestamp when notApplicableReason was recorded; null otherwise."}}},"EmployeeCharacteristicValueBoolean":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"boolean"}}}]},"EmployeeCharacteristicValueBase":{"type":"object","description":"Base class for employee characteristic values","discriminator":{"propertyName":"questionType","mapping":{"LIST":"#/components/schemas/EmployeeCharacteristicValueList","DATE":"#/components/schemas/EmployeeCharacteristicValueDate","BOOLEAN":"#/components/schemas/EmployeeCharacteristicValueBoolean","TREE":"#/components/schemas/EmployeeCharacteristicValueTree"}},"properties":{"characteristicId":{"type":"string"},"id":{"type":"string"},"questionType":{"$ref":"#/components/schemas/CharacteristicType"}}},"CharacteristicType":{"type":"string","description":"Type of segmentation characteristic","enum":["DATE","LIST","BOOLEAN","TREE"]},"EmployeeCharacteristicValueDate":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"string"}}}]},"EmployeeCharacteristicValueList":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"}}}]},"EmployeeCharacteristicValueTree":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"},"assignedPath":{"type":"array","items":{"type":"string"}},"assignedOn":{"type":"string","format":"date-time"}}}]},"ActionNoteDTO":{"type":"object","description":"A single note appended to the action execution log","properties":{"id":{"type":"string","description":"Note identifier (unique within the parent action)"},"authorId":{"type":"string","description":"User who wrote the note"},"content":{"type":"string","description":"Note body text"},"visibility":{"type":"string","description":"Who can see this note. PRIVATE = only the author; SHARED = all action participants.","enum":["PRIVATE","SHARED"]},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"}}},"Objective":{"type":"object","description":"What the plan is trying to move, and by when","properties":{"focusItems":{"type":"array","description":"Focus indicators (with target values) the plan aims to move.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"horizon":{"type":"string","format":"date-time","description":"Date by which the objective is expected to be reached."}}},"Origin":{"type":"object","description":"Where the plan came from","properties":{"source":{"type":"string","description":"How the plan was originated.","enum":["MANUAL","SUGGESTION","AI","TEMPLATE","COORDINATOR"]},"candidateIds":{"type":"array","description":"Candidate ids this plan was built from; empty for plans created directly by a person.","items":{"type":"string"}}}},"ChangeLogEntry":{"type":"object","description":"One recorded edit against the plan's original proposal","properties":{"changedBy":{"type":"string","description":"Who made the change."},"changedAt":{"type":"string","format":"date-time","description":"When the change was made."},"field":{"type":"string","description":"Which field changed."},"before":{"type":"string","description":"The value before the change, as text."},"after":{"type":"string","description":"The value after the change, as text."}}}}},"paths":{"/api/v1/company/action-plans":{"post":{"tags":["Action Plans"],"summary":"Create a new action plan","description":"Creates an empty action plan. Once created, actions can be added by creating them with the plan's ID.","operationId":"createPlan","requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/CreateActionPlanRequestDTO"}}},"required":true},"responses":{"200":{"description":"Plan created successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"400":{"description":"Validation failed: missing title or description","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}}}}}}}
```

## Reject a proposed action plan

> Rejects a PROPOSED plan with a mandatory reason: it moves to REJECTED, the reason is stored, and every pending (not yet started) action in it is withdrawn. Assignees whose coordinated action was rejected keep any separate "for now" action they already have. Only the plan's owner or an admin may call this.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"RejectActionPlanRequestDTO":{"type":"object","description":"Request payload to reject a PROPOSED action plan","properties":{"reason":{"type":"string","description":"Mandatory free-text reason for the rejection.","minLength":1}},"required":["reason"]},"ActionPlanDTO":{"type":"object","description":"Action plan — a named container grouping one or more improvement actions under a shared goal","properties":{"id":{"type":"string","description":"Unique plan identifier"},"companyId":{"type":"string","description":"Company that owns this plan"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the plan's goal (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed description of the plan's objective (multilingual)"},"actions":{"type":"array","description":"Actions belonging to this plan","items":{"$ref":"#/components/schemas/ActionDTO"}},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to the plan creator.","enum":["PUBLIC","PRIVATE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of actions in this plan that have reached COMPLETED status (0–100). Computed on-the-fly; never stored."},"createdBy":{"type":"string","description":"User who created this plan; may be the system for coordinator-proposed plans"},"kind":{"type":"string","description":"Who this plan belongs to.","enum":["MANAGER","HAPPYFORCE"]},"ownerId":{"type":"string","description":"The person accountable for this plan — distinct from createdBy. Legacy plans report the creator here."},"state":{"type":"string","description":"Lifecycle state. Legacy plans report APPROVED.","enum":["PROPOSED","APPROVED","REJECTED","UNATTENDED","IN_PROGRESS","CLOSED"]},"period":{"type":"string","format":"date-time","description":"First day of the month this plan belongs to."},"objective":{"$ref":"#/components/schemas/Objective","description":"What the plan is trying to move, and by when."},"scope":{"type":"array","description":"Hierarchies this plan's audience is scoped to. Empty or null means company-wide.","items":{"type":"string"},"uniqueItems":true},"origin":{"$ref":"#/components/schemas/Origin","description":"Where this plan came from."},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting the objective — never free prose.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the owner's scope (multilingual)."},"changeLog":{"type":"array","description":"Edits the owner made against the original proposal, oldest first. Only populated while editing a PROPOSED plan — see action-plan-lifecycle.","items":{"$ref":"#/components/schemas/ChangeLogEntry"}},"rejectionReason":{"type":"string","description":"Reason recorded when the owner rejected this plan; null otherwise."},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"ActionDTO":{"type":"object","description":"Complete action payload returned by the API","properties":{"id":{"type":"string","description":"Unique action identifier"},"companyId":{"type":"string","description":"Company that owns this action"},"planId":{"type":"string","description":"Parent action plan identifier. Every action belongs to a plan."},"plan":{"$ref":"#/components/schemas/PlanSummary","description":"Lightweight plan summary (id, title, description)."},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the action (multilingual: defaultValue = main language, langValues = translations)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed execution plan describing how and when (multilingual)"},"focusItems":{"type":"array","description":"One or more focus indicators this action is anchored to. At least one is always present.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"assigneeStatuses":{"type":"array","description":"Per-assignee lifecycle states. Each entry tracks one manager's individual progress. The global status field is the aggregate of all entries.","items":{"$ref":"#/components/schemas/AssigneeStatusDTO"}},"hierarchyIds":{"type":"array","description":"Areas/hierarchies this action targets. Empty means company-wide scope.","items":{"type":"string"},"uniqueItems":true},"groupIds":{"type":"array","description":"Groups this action targets.","items":{"type":"string"},"uniqueItems":true},"characteristics":{"type":"array","description":"Employee characteristic segments this action targets.","items":{"oneOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBoolean"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueDate"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueList"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueTree"}]},"uniqueItems":true},"actionType":{"type":"string","description":"Scope of the action. MANAGER = individual manager action; COMPANY = cross-team action initiated by an admin.","enum":["MANAGER","COMPANY"]},"source":{"type":"string","description":"How the action was originated. MANUAL = created by the user; SUGGESTION = proposed by a company action; AI = generated by the AI assistant.","enum":["MANUAL","SUGGESTION","AI"]},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to assignees/creator.","enum":["PUBLIC","PRIVATE"]},"role":{"type":"string","description":"The part this action plays within its plan.","enum":["EXECUTE","COORDINATE","ACCOMPANY","ENABLE"]},"status":{"type":"string","description":"Aggregate lifecycle status (computed from all assignee states).","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of assignees who have individually reached COMPLETED status (0–100). Computed on-the-fly from assigneeStatuses; never stored."},"dueDate":{"type":"string","format":"date-time","description":"Target completion date"},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when the first assignee moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when all assignees reached a terminal status"},"createdBy":{"type":"string","description":"User who created this action"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"},"notes":{"type":"array","description":"Execution log notes (bitácora). Visibility-filtered: PRIVATE notes are only returned when the caller is the author. Not populated in list responses — only in single-action detail (GET /actions/{id}).","items":{"$ref":"#/components/schemas/ActionNoteDTO"}},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting this action, when it was proposed by the coordinator — never free prose. Empty for actions created directly by a person.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the assignee's own scope, when this action was proposed by the coordinator; null otherwise."}}},"PlanSummary":{"type":"object","description":"Lightweight plan reference — id, title and description only","properties":{"id":{"type":"string","description":"Plan identifier"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan title (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan goal description (multilingual)"}}},"ActionFocusItem":{"type":"object","discriminator":{"propertyName":"focusType"},"properties":{"focusType":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"focusId":{"type":"string"},"targetValue":{"type":"number","format":"double"},"targetTimestamp":{"type":"string","format":"date-time"},"noTargetReason":{"type":"string"}}},"CommentThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"commentIds":{"type":"array","items":{"type":"string"}},"linkedIndicators":{"type":"array","items":{"$ref":"#/components/schemas/LinkedIndicator"}},"noLinkReason":{"type":"string"}}}]},"LinkedIndicator":{"type":"object","properties":{"type":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"indicatorId":{"type":"string"}}},"ENPSFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"FactorFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"HIFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"InferredThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"anchorQuestionIds":{"type":"array","items":{"type":"string"}}}}]},"QuestionFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ScoreFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"AssigneeStatusDTO":{"type":"object","description":"Per-assignee lifecycle state within an action","properties":{"assigneeId":{"type":"string","description":"Assignee (manager) identifier"},"status":{"type":"string","description":"This assignee's current lifecycle status","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee first moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee reached a terminal status"},"notApplicableReason":{"type":"string","description":"Reason this assignee recorded when moving to NOT_APPLICABLE; null otherwise."},"notApplicableAt":{"type":"string","format":"date-time","description":"Timestamp when notApplicableReason was recorded; null otherwise."}}},"EmployeeCharacteristicValueBoolean":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"boolean"}}}]},"EmployeeCharacteristicValueBase":{"type":"object","description":"Base class for employee characteristic values","discriminator":{"propertyName":"questionType","mapping":{"LIST":"#/components/schemas/EmployeeCharacteristicValueList","DATE":"#/components/schemas/EmployeeCharacteristicValueDate","BOOLEAN":"#/components/schemas/EmployeeCharacteristicValueBoolean","TREE":"#/components/schemas/EmployeeCharacteristicValueTree"}},"properties":{"characteristicId":{"type":"string"},"id":{"type":"string"},"questionType":{"$ref":"#/components/schemas/CharacteristicType"}}},"CharacteristicType":{"type":"string","description":"Type of segmentation characteristic","enum":["DATE","LIST","BOOLEAN","TREE"]},"EmployeeCharacteristicValueDate":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"string"}}}]},"EmployeeCharacteristicValueList":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"}}}]},"EmployeeCharacteristicValueTree":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"},"assignedPath":{"type":"array","items":{"type":"string"}},"assignedOn":{"type":"string","format":"date-time"}}}]},"ActionNoteDTO":{"type":"object","description":"A single note appended to the action execution log","properties":{"id":{"type":"string","description":"Note identifier (unique within the parent action)"},"authorId":{"type":"string","description":"User who wrote the note"},"content":{"type":"string","description":"Note body text"},"visibility":{"type":"string","description":"Who can see this note. PRIVATE = only the author; SHARED = all action participants.","enum":["PRIVATE","SHARED"]},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"}}},"Objective":{"type":"object","description":"What the plan is trying to move, and by when","properties":{"focusItems":{"type":"array","description":"Focus indicators (with target values) the plan aims to move.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"horizon":{"type":"string","format":"date-time","description":"Date by which the objective is expected to be reached."}}},"Origin":{"type":"object","description":"Where the plan came from","properties":{"source":{"type":"string","description":"How the plan was originated.","enum":["MANUAL","SUGGESTION","AI","TEMPLATE","COORDINATOR"]},"candidateIds":{"type":"array","description":"Candidate ids this plan was built from; empty for plans created directly by a person.","items":{"type":"string"}}}},"ChangeLogEntry":{"type":"object","description":"One recorded edit against the plan's original proposal","properties":{"changedBy":{"type":"string","description":"Who made the change."},"changedAt":{"type":"string","format":"date-time","description":"When the change was made."},"field":{"type":"string","description":"Which field changed."},"before":{"type":"string","description":"The value before the change, as text."},"after":{"type":"string","description":"The value after the change, as text."}}}}},"paths":{"/api/v1/company/action-plans/{planId}/reject":{"post":{"tags":["Action Plans"],"summary":"Reject a proposed action plan","description":"Rejects a PROPOSED plan with a mandatory reason: it moves to REJECTED, the reason is stored, and every pending (not yet started) action in it is withdrawn. Assignees whose coordinated action was rejected keep any separate \"for now\" action they already have. Only the plan's owner or an admin may call this.","operationId":"rejectPlan","parameters":[{"name":"planId","in":"path","description":"Plan identifier","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/RejectActionPlanRequestDTO"}}},"required":true},"responses":{"200":{"description":"Plan rejected","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"400":{"description":"Blank reason, or the plan is not currently PROPOSED","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"403":{"description":"Caller is neither the plan owner nor an admin","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"404":{"description":"Plan not found in this company","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}}}}}}}
```

## Export action plan to Excel

> Triggers an asynchronous Excel export of this action plan. The workbook contains a summary sheet followed by one sheet per action. The file will be delivered to your e-mail address as a time-limited download link. The response is empty — the file arrives via e-mail within seconds.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}}},"paths":{"/api/v1/company/action-plans/{planId}/excel":{"post":{"tags":["Action Plans"],"summary":"Export action plan to Excel","description":"Triggers an asynchronous Excel export of this action plan. The workbook contains a summary sheet followed by one sheet per action. The file will be delivered to your e-mail address as a time-limited download link. The response is empty — the file arrives via e-mail within seconds.","operationId":"exportPlanToExcel","parameters":[{"name":"planId","in":"path","description":"Plan identifier","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Export triggered — file will be sent by e-mail"}}}}}}
```

## Approve a proposed action plan

> Approves a PROPOSED plan: it moves to APPROVED and every PENDING\_APPROVAL action in it is released to DRAFT, available to its assignees. Only the plan's owner or an admin may call this — the AI never does this for a human.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"ActionPlanDTO":{"type":"object","description":"Action plan — a named container grouping one or more improvement actions under a shared goal","properties":{"id":{"type":"string","description":"Unique plan identifier"},"companyId":{"type":"string","description":"Company that owns this plan"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the plan's goal (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed description of the plan's objective (multilingual)"},"actions":{"type":"array","description":"Actions belonging to this plan","items":{"$ref":"#/components/schemas/ActionDTO"}},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to the plan creator.","enum":["PUBLIC","PRIVATE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of actions in this plan that have reached COMPLETED status (0–100). Computed on-the-fly; never stored."},"createdBy":{"type":"string","description":"User who created this plan; may be the system for coordinator-proposed plans"},"kind":{"type":"string","description":"Who this plan belongs to.","enum":["MANAGER","HAPPYFORCE"]},"ownerId":{"type":"string","description":"The person accountable for this plan — distinct from createdBy. Legacy plans report the creator here."},"state":{"type":"string","description":"Lifecycle state. Legacy plans report APPROVED.","enum":["PROPOSED","APPROVED","REJECTED","UNATTENDED","IN_PROGRESS","CLOSED"]},"period":{"type":"string","format":"date-time","description":"First day of the month this plan belongs to."},"objective":{"$ref":"#/components/schemas/Objective","description":"What the plan is trying to move, and by when."},"scope":{"type":"array","description":"Hierarchies this plan's audience is scoped to. Empty or null means company-wide.","items":{"type":"string"},"uniqueItems":true},"origin":{"$ref":"#/components/schemas/Origin","description":"Where this plan came from."},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting the objective — never free prose.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the owner's scope (multilingual)."},"changeLog":{"type":"array","description":"Edits the owner made against the original proposal, oldest first. Only populated while editing a PROPOSED plan — see action-plan-lifecycle.","items":{"$ref":"#/components/schemas/ChangeLogEntry"}},"rejectionReason":{"type":"string","description":"Reason recorded when the owner rejected this plan; null otherwise."},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"ActionDTO":{"type":"object","description":"Complete action payload returned by the API","properties":{"id":{"type":"string","description":"Unique action identifier"},"companyId":{"type":"string","description":"Company that owns this action"},"planId":{"type":"string","description":"Parent action plan identifier. Every action belongs to a plan."},"plan":{"$ref":"#/components/schemas/PlanSummary","description":"Lightweight plan summary (id, title, description)."},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the action (multilingual: defaultValue = main language, langValues = translations)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed execution plan describing how and when (multilingual)"},"focusItems":{"type":"array","description":"One or more focus indicators this action is anchored to. At least one is always present.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"assigneeStatuses":{"type":"array","description":"Per-assignee lifecycle states. Each entry tracks one manager's individual progress. The global status field is the aggregate of all entries.","items":{"$ref":"#/components/schemas/AssigneeStatusDTO"}},"hierarchyIds":{"type":"array","description":"Areas/hierarchies this action targets. Empty means company-wide scope.","items":{"type":"string"},"uniqueItems":true},"groupIds":{"type":"array","description":"Groups this action targets.","items":{"type":"string"},"uniqueItems":true},"characteristics":{"type":"array","description":"Employee characteristic segments this action targets.","items":{"oneOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBoolean"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueDate"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueList"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueTree"}]},"uniqueItems":true},"actionType":{"type":"string","description":"Scope of the action. MANAGER = individual manager action; COMPANY = cross-team action initiated by an admin.","enum":["MANAGER","COMPANY"]},"source":{"type":"string","description":"How the action was originated. MANUAL = created by the user; SUGGESTION = proposed by a company action; AI = generated by the AI assistant.","enum":["MANUAL","SUGGESTION","AI"]},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to assignees/creator.","enum":["PUBLIC","PRIVATE"]},"role":{"type":"string","description":"The part this action plays within its plan.","enum":["EXECUTE","COORDINATE","ACCOMPANY","ENABLE"]},"status":{"type":"string","description":"Aggregate lifecycle status (computed from all assignee states).","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of assignees who have individually reached COMPLETED status (0–100). Computed on-the-fly from assigneeStatuses; never stored."},"dueDate":{"type":"string","format":"date-time","description":"Target completion date"},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when the first assignee moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when all assignees reached a terminal status"},"createdBy":{"type":"string","description":"User who created this action"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"},"notes":{"type":"array","description":"Execution log notes (bitácora). Visibility-filtered: PRIVATE notes are only returned when the caller is the author. Not populated in list responses — only in single-action detail (GET /actions/{id}).","items":{"$ref":"#/components/schemas/ActionNoteDTO"}},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting this action, when it was proposed by the coordinator — never free prose. Empty for actions created directly by a person.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the assignee's own scope, when this action was proposed by the coordinator; null otherwise."}}},"PlanSummary":{"type":"object","description":"Lightweight plan reference — id, title and description only","properties":{"id":{"type":"string","description":"Plan identifier"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan title (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan goal description (multilingual)"}}},"ActionFocusItem":{"type":"object","discriminator":{"propertyName":"focusType"},"properties":{"focusType":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"focusId":{"type":"string"},"targetValue":{"type":"number","format":"double"},"targetTimestamp":{"type":"string","format":"date-time"},"noTargetReason":{"type":"string"}}},"CommentThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"commentIds":{"type":"array","items":{"type":"string"}},"linkedIndicators":{"type":"array","items":{"$ref":"#/components/schemas/LinkedIndicator"}},"noLinkReason":{"type":"string"}}}]},"LinkedIndicator":{"type":"object","properties":{"type":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"indicatorId":{"type":"string"}}},"ENPSFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"FactorFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"HIFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"InferredThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"anchorQuestionIds":{"type":"array","items":{"type":"string"}}}}]},"QuestionFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ScoreFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"AssigneeStatusDTO":{"type":"object","description":"Per-assignee lifecycle state within an action","properties":{"assigneeId":{"type":"string","description":"Assignee (manager) identifier"},"status":{"type":"string","description":"This assignee's current lifecycle status","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee first moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee reached a terminal status"},"notApplicableReason":{"type":"string","description":"Reason this assignee recorded when moving to NOT_APPLICABLE; null otherwise."},"notApplicableAt":{"type":"string","format":"date-time","description":"Timestamp when notApplicableReason was recorded; null otherwise."}}},"EmployeeCharacteristicValueBoolean":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"boolean"}}}]},"EmployeeCharacteristicValueBase":{"type":"object","description":"Base class for employee characteristic values","discriminator":{"propertyName":"questionType","mapping":{"LIST":"#/components/schemas/EmployeeCharacteristicValueList","DATE":"#/components/schemas/EmployeeCharacteristicValueDate","BOOLEAN":"#/components/schemas/EmployeeCharacteristicValueBoolean","TREE":"#/components/schemas/EmployeeCharacteristicValueTree"}},"properties":{"characteristicId":{"type":"string"},"id":{"type":"string"},"questionType":{"$ref":"#/components/schemas/CharacteristicType"}}},"CharacteristicType":{"type":"string","description":"Type of segmentation characteristic","enum":["DATE","LIST","BOOLEAN","TREE"]},"EmployeeCharacteristicValueDate":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"string"}}}]},"EmployeeCharacteristicValueList":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"}}}]},"EmployeeCharacteristicValueTree":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"},"assignedPath":{"type":"array","items":{"type":"string"}},"assignedOn":{"type":"string","format":"date-time"}}}]},"ActionNoteDTO":{"type":"object","description":"A single note appended to the action execution log","properties":{"id":{"type":"string","description":"Note identifier (unique within the parent action)"},"authorId":{"type":"string","description":"User who wrote the note"},"content":{"type":"string","description":"Note body text"},"visibility":{"type":"string","description":"Who can see this note. PRIVATE = only the author; SHARED = all action participants.","enum":["PRIVATE","SHARED"]},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"}}},"Objective":{"type":"object","description":"What the plan is trying to move, and by when","properties":{"focusItems":{"type":"array","description":"Focus indicators (with target values) the plan aims to move.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"horizon":{"type":"string","format":"date-time","description":"Date by which the objective is expected to be reached."}}},"Origin":{"type":"object","description":"Where the plan came from","properties":{"source":{"type":"string","description":"How the plan was originated.","enum":["MANUAL","SUGGESTION","AI","TEMPLATE","COORDINATOR"]},"candidateIds":{"type":"array","description":"Candidate ids this plan was built from; empty for plans created directly by a person.","items":{"type":"string"}}}},"ChangeLogEntry":{"type":"object","description":"One recorded edit against the plan's original proposal","properties":{"changedBy":{"type":"string","description":"Who made the change."},"changedAt":{"type":"string","format":"date-time","description":"When the change was made."},"field":{"type":"string","description":"Which field changed."},"before":{"type":"string","description":"The value before the change, as text."},"after":{"type":"string","description":"The value after the change, as text."}}}}},"paths":{"/api/v1/company/action-plans/{planId}/approve":{"post":{"tags":["Action Plans"],"summary":"Approve a proposed action plan","description":"Approves a PROPOSED plan: it moves to APPROVED and every PENDING_APPROVAL action in it is released to DRAFT, available to its assignees. Only the plan's owner or an admin may call this — the AI never does this for a human.","operationId":"approvePlan","parameters":[{"name":"planId","in":"path","description":"Plan identifier","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Plan approved","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"400":{"description":"The plan is not currently PROPOSED","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"403":{"description":"Caller is neither the plan owner nor an admin","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"404":{"description":"Plan not found in this company","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}}}}}}}
```

## Update action plan (also reachable as PATCH .../{planId}/proposal)

> Applies a partial update to an action plan. Only non-null fields are updated. This is also how the owner edits a PROPOSED plan before approving it — title, description, objective (focus items and horizon) and period — with every applied change appended to the plan's change log while it is still PROPOSED. The \`.../{planId}/proposal\` path is the same operation under the explicit name the pre-approval editing flow uses. To add, remove or reassign the plan's actions, use the action endpoints (POST/PATCH/DELETE /v1/company/actions) with this plan's id — they apply the same owner-or-admin check and change log.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"UpdateActionPlanRequestDTO":{"type":"object","description":"Request payload for updating an action plan. Only non-null fields are applied.","properties":{"title":{"$ref":"#/components/schemas/MultiLanguage","description":"New title for the plan (multilingual, null = no change)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"New description for the plan (multilingual, null = no change)"},"visibility":{"type":"string","description":"New visibility. Null means no change.","enum":["PUBLIC","PRIVATE"]},"objective":{"$ref":"#/components/schemas/Objective","description":"New objective — what the plan is trying to move, and by when. Null means no change; replaces the objective wholesale when provided."},"period":{"type":"string","format":"date-time","description":"New period (first day of the plan's month). Null means no change."}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"Objective":{"type":"object","description":"What the plan is trying to move, and by when","properties":{"focusItems":{"type":"array","description":"Focus indicators (with target values) the plan aims to move.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"horizon":{"type":"string","format":"date-time","description":"Date by which the objective is expected to be reached."}}},"ActionFocusItem":{"type":"object","discriminator":{"propertyName":"focusType"},"properties":{"focusType":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"focusId":{"type":"string"},"targetValue":{"type":"number","format":"double"},"targetTimestamp":{"type":"string","format":"date-time"},"noTargetReason":{"type":"string"}}},"CommentThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"commentIds":{"type":"array","items":{"type":"string"}},"linkedIndicators":{"type":"array","items":{"$ref":"#/components/schemas/LinkedIndicator"}},"noLinkReason":{"type":"string"}}}]},"LinkedIndicator":{"type":"object","properties":{"type":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"indicatorId":{"type":"string"}}},"ENPSFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"FactorFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"HIFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"InferredThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"anchorQuestionIds":{"type":"array","items":{"type":"string"}}}}]},"QuestionFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ScoreFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ActionPlanDTO":{"type":"object","description":"Action plan — a named container grouping one or more improvement actions under a shared goal","properties":{"id":{"type":"string","description":"Unique plan identifier"},"companyId":{"type":"string","description":"Company that owns this plan"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the plan's goal (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed description of the plan's objective (multilingual)"},"actions":{"type":"array","description":"Actions belonging to this plan","items":{"$ref":"#/components/schemas/ActionDTO"}},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to the plan creator.","enum":["PUBLIC","PRIVATE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of actions in this plan that have reached COMPLETED status (0–100). Computed on-the-fly; never stored."},"createdBy":{"type":"string","description":"User who created this plan; may be the system for coordinator-proposed plans"},"kind":{"type":"string","description":"Who this plan belongs to.","enum":["MANAGER","HAPPYFORCE"]},"ownerId":{"type":"string","description":"The person accountable for this plan — distinct from createdBy. Legacy plans report the creator here."},"state":{"type":"string","description":"Lifecycle state. Legacy plans report APPROVED.","enum":["PROPOSED","APPROVED","REJECTED","UNATTENDED","IN_PROGRESS","CLOSED"]},"period":{"type":"string","format":"date-time","description":"First day of the month this plan belongs to."},"objective":{"$ref":"#/components/schemas/Objective","description":"What the plan is trying to move, and by when."},"scope":{"type":"array","description":"Hierarchies this plan's audience is scoped to. Empty or null means company-wide.","items":{"type":"string"},"uniqueItems":true},"origin":{"$ref":"#/components/schemas/Origin","description":"Where this plan came from."},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting the objective — never free prose.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the owner's scope (multilingual)."},"changeLog":{"type":"array","description":"Edits the owner made against the original proposal, oldest first. Only populated while editing a PROPOSED plan — see action-plan-lifecycle.","items":{"$ref":"#/components/schemas/ChangeLogEntry"}},"rejectionReason":{"type":"string","description":"Reason recorded when the owner rejected this plan; null otherwise."},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"}}},"ActionDTO":{"type":"object","description":"Complete action payload returned by the API","properties":{"id":{"type":"string","description":"Unique action identifier"},"companyId":{"type":"string","description":"Company that owns this action"},"planId":{"type":"string","description":"Parent action plan identifier. Every action belongs to a plan."},"plan":{"$ref":"#/components/schemas/PlanSummary","description":"Lightweight plan summary (id, title, description)."},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the action (multilingual: defaultValue = main language, langValues = translations)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed execution plan describing how and when (multilingual)"},"focusItems":{"type":"array","description":"One or more focus indicators this action is anchored to. At least one is always present.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"assigneeStatuses":{"type":"array","description":"Per-assignee lifecycle states. Each entry tracks one manager's individual progress. The global status field is the aggregate of all entries.","items":{"$ref":"#/components/schemas/AssigneeStatusDTO"}},"hierarchyIds":{"type":"array","description":"Areas/hierarchies this action targets. Empty means company-wide scope.","items":{"type":"string"},"uniqueItems":true},"groupIds":{"type":"array","description":"Groups this action targets.","items":{"type":"string"},"uniqueItems":true},"characteristics":{"type":"array","description":"Employee characteristic segments this action targets.","items":{"oneOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBoolean"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueDate"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueList"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueTree"}]},"uniqueItems":true},"actionType":{"type":"string","description":"Scope of the action. MANAGER = individual manager action; COMPANY = cross-team action initiated by an admin.","enum":["MANAGER","COMPANY"]},"source":{"type":"string","description":"How the action was originated. MANUAL = created by the user; SUGGESTION = proposed by a company action; AI = generated by the AI assistant.","enum":["MANUAL","SUGGESTION","AI"]},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to assignees/creator.","enum":["PUBLIC","PRIVATE"]},"role":{"type":"string","description":"The part this action plays within its plan.","enum":["EXECUTE","COORDINATE","ACCOMPANY","ENABLE"]},"status":{"type":"string","description":"Aggregate lifecycle status (computed from all assignee states).","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of assignees who have individually reached COMPLETED status (0–100). Computed on-the-fly from assigneeStatuses; never stored."},"dueDate":{"type":"string","format":"date-time","description":"Target completion date"},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when the first assignee moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when all assignees reached a terminal status"},"createdBy":{"type":"string","description":"User who created this action"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"},"notes":{"type":"array","description":"Execution log notes (bitácora). Visibility-filtered: PRIVATE notes are only returned when the caller is the author. Not populated in list responses — only in single-action detail (GET /actions/{id}).","items":{"$ref":"#/components/schemas/ActionNoteDTO"}},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting this action, when it was proposed by the coordinator — never free prose. Empty for actions created directly by a person.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the assignee's own scope, when this action was proposed by the coordinator; null otherwise."}}},"PlanSummary":{"type":"object","description":"Lightweight plan reference — id, title and description only","properties":{"id":{"type":"string","description":"Plan identifier"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan title (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan goal description (multilingual)"}}},"AssigneeStatusDTO":{"type":"object","description":"Per-assignee lifecycle state within an action","properties":{"assigneeId":{"type":"string","description":"Assignee (manager) identifier"},"status":{"type":"string","description":"This assignee's current lifecycle status","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee first moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee reached a terminal status"},"notApplicableReason":{"type":"string","description":"Reason this assignee recorded when moving to NOT_APPLICABLE; null otherwise."},"notApplicableAt":{"type":"string","format":"date-time","description":"Timestamp when notApplicableReason was recorded; null otherwise."}}},"EmployeeCharacteristicValueBoolean":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"boolean"}}}]},"EmployeeCharacteristicValueBase":{"type":"object","description":"Base class for employee characteristic values","discriminator":{"propertyName":"questionType","mapping":{"LIST":"#/components/schemas/EmployeeCharacteristicValueList","DATE":"#/components/schemas/EmployeeCharacteristicValueDate","BOOLEAN":"#/components/schemas/EmployeeCharacteristicValueBoolean","TREE":"#/components/schemas/EmployeeCharacteristicValueTree"}},"properties":{"characteristicId":{"type":"string"},"id":{"type":"string"},"questionType":{"$ref":"#/components/schemas/CharacteristicType"}}},"CharacteristicType":{"type":"string","description":"Type of segmentation characteristic","enum":["DATE","LIST","BOOLEAN","TREE"]},"EmployeeCharacteristicValueDate":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"string"}}}]},"EmployeeCharacteristicValueList":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"}}}]},"EmployeeCharacteristicValueTree":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"},"assignedPath":{"type":"array","items":{"type":"string"}},"assignedOn":{"type":"string","format":"date-time"}}}]},"ActionNoteDTO":{"type":"object","description":"A single note appended to the action execution log","properties":{"id":{"type":"string","description":"Note identifier (unique within the parent action)"},"authorId":{"type":"string","description":"User who wrote the note"},"content":{"type":"string","description":"Note body text"},"visibility":{"type":"string","description":"Who can see this note. PRIVATE = only the author; SHARED = all action participants.","enum":["PRIVATE","SHARED"]},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"}}},"Origin":{"type":"object","description":"Where the plan came from","properties":{"source":{"type":"string","description":"How the plan was originated.","enum":["MANUAL","SUGGESTION","AI","TEMPLATE","COORDINATOR"]},"candidateIds":{"type":"array","description":"Candidate ids this plan was built from; empty for plans created directly by a person.","items":{"type":"string"}}}},"ChangeLogEntry":{"type":"object","description":"One recorded edit against the plan's original proposal","properties":{"changedBy":{"type":"string","description":"Who made the change."},"changedAt":{"type":"string","format":"date-time","description":"When the change was made."},"field":{"type":"string","description":"Which field changed."},"before":{"type":"string","description":"The value before the change, as text."},"after":{"type":"string","description":"The value after the change, as text."}}}}},"paths":{"/api/v1/company/action-plans/{planId}/proposal":{"patch":{"tags":["Action Plans"],"summary":"Update action plan (also reachable as PATCH .../{planId}/proposal)","description":"Applies a partial update to an action plan. Only non-null fields are updated. This is also how the owner edits a PROPOSED plan before approving it — title, description, objective (focus items and horizon) and period — with every applied change appended to the plan's change log while it is still PROPOSED. The `.../{planId}/proposal` path is the same operation under the explicit name the pre-approval editing flow uses. To add, remove or reassign the plan's actions, use the action endpoints (POST/PATCH/DELETE /v1/company/actions) with this plan's id — they apply the same owner-or-admin check and change log.","operationId":"updatePlan","parameters":[{"name":"planId","in":"path","description":"Plan identifier","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/UpdateActionPlanRequestDTO"}}},"required":true},"responses":{"200":{"description":"Plan updated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"400":{"description":"No updatable fields provided, or plan not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"404":{"description":"Plan not found in this company","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}}}}}}}
```

## Get action plan details

> Returns the full action plan with its actions.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"ActionPlanDTO":{"type":"object","description":"Action plan — a named container grouping one or more improvement actions under a shared goal","properties":{"id":{"type":"string","description":"Unique plan identifier"},"companyId":{"type":"string","description":"Company that owns this plan"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the plan's goal (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed description of the plan's objective (multilingual)"},"actions":{"type":"array","description":"Actions belonging to this plan","items":{"$ref":"#/components/schemas/ActionDTO"}},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to the plan creator.","enum":["PUBLIC","PRIVATE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of actions in this plan that have reached COMPLETED status (0–100). Computed on-the-fly; never stored."},"createdBy":{"type":"string","description":"User who created this plan; may be the system for coordinator-proposed plans"},"kind":{"type":"string","description":"Who this plan belongs to.","enum":["MANAGER","HAPPYFORCE"]},"ownerId":{"type":"string","description":"The person accountable for this plan — distinct from createdBy. Legacy plans report the creator here."},"state":{"type":"string","description":"Lifecycle state. Legacy plans report APPROVED.","enum":["PROPOSED","APPROVED","REJECTED","UNATTENDED","IN_PROGRESS","CLOSED"]},"period":{"type":"string","format":"date-time","description":"First day of the month this plan belongs to."},"objective":{"$ref":"#/components/schemas/Objective","description":"What the plan is trying to move, and by when."},"scope":{"type":"array","description":"Hierarchies this plan's audience is scoped to. Empty or null means company-wide.","items":{"type":"string"},"uniqueItems":true},"origin":{"$ref":"#/components/schemas/Origin","description":"Where this plan came from."},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting the objective — never free prose.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the owner's scope (multilingual)."},"changeLog":{"type":"array","description":"Edits the owner made against the original proposal, oldest first. Only populated while editing a PROPOSED plan — see action-plan-lifecycle.","items":{"$ref":"#/components/schemas/ChangeLogEntry"}},"rejectionReason":{"type":"string","description":"Reason recorded when the owner rejected this plan; null otherwise."},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"ActionDTO":{"type":"object","description":"Complete action payload returned by the API","properties":{"id":{"type":"string","description":"Unique action identifier"},"companyId":{"type":"string","description":"Company that owns this action"},"planId":{"type":"string","description":"Parent action plan identifier. Every action belongs to a plan."},"plan":{"$ref":"#/components/schemas/PlanSummary","description":"Lightweight plan summary (id, title, description)."},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the action (multilingual: defaultValue = main language, langValues = translations)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed execution plan describing how and when (multilingual)"},"focusItems":{"type":"array","description":"One or more focus indicators this action is anchored to. At least one is always present.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"assigneeStatuses":{"type":"array","description":"Per-assignee lifecycle states. Each entry tracks one manager's individual progress. The global status field is the aggregate of all entries.","items":{"$ref":"#/components/schemas/AssigneeStatusDTO"}},"hierarchyIds":{"type":"array","description":"Areas/hierarchies this action targets. Empty means company-wide scope.","items":{"type":"string"},"uniqueItems":true},"groupIds":{"type":"array","description":"Groups this action targets.","items":{"type":"string"},"uniqueItems":true},"characteristics":{"type":"array","description":"Employee characteristic segments this action targets.","items":{"oneOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBoolean"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueDate"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueList"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueTree"}]},"uniqueItems":true},"actionType":{"type":"string","description":"Scope of the action. MANAGER = individual manager action; COMPANY = cross-team action initiated by an admin.","enum":["MANAGER","COMPANY"]},"source":{"type":"string","description":"How the action was originated. MANUAL = created by the user; SUGGESTION = proposed by a company action; AI = generated by the AI assistant.","enum":["MANUAL","SUGGESTION","AI"]},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to assignees/creator.","enum":["PUBLIC","PRIVATE"]},"role":{"type":"string","description":"The part this action plays within its plan.","enum":["EXECUTE","COORDINATE","ACCOMPANY","ENABLE"]},"status":{"type":"string","description":"Aggregate lifecycle status (computed from all assignee states).","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of assignees who have individually reached COMPLETED status (0–100). Computed on-the-fly from assigneeStatuses; never stored."},"dueDate":{"type":"string","format":"date-time","description":"Target completion date"},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when the first assignee moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when all assignees reached a terminal status"},"createdBy":{"type":"string","description":"User who created this action"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"},"notes":{"type":"array","description":"Execution log notes (bitácora). Visibility-filtered: PRIVATE notes are only returned when the caller is the author. Not populated in list responses — only in single-action detail (GET /actions/{id}).","items":{"$ref":"#/components/schemas/ActionNoteDTO"}},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting this action, when it was proposed by the coordinator — never free prose. Empty for actions created directly by a person.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the assignee's own scope, when this action was proposed by the coordinator; null otherwise."}}},"PlanSummary":{"type":"object","description":"Lightweight plan reference — id, title and description only","properties":{"id":{"type":"string","description":"Plan identifier"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan title (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan goal description (multilingual)"}}},"ActionFocusItem":{"type":"object","discriminator":{"propertyName":"focusType"},"properties":{"focusType":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"focusId":{"type":"string"},"targetValue":{"type":"number","format":"double"},"targetTimestamp":{"type":"string","format":"date-time"},"noTargetReason":{"type":"string"}}},"CommentThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"commentIds":{"type":"array","items":{"type":"string"}},"linkedIndicators":{"type":"array","items":{"$ref":"#/components/schemas/LinkedIndicator"}},"noLinkReason":{"type":"string"}}}]},"LinkedIndicator":{"type":"object","properties":{"type":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"indicatorId":{"type":"string"}}},"ENPSFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"FactorFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"HIFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"InferredThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"anchorQuestionIds":{"type":"array","items":{"type":"string"}}}}]},"QuestionFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ScoreFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"AssigneeStatusDTO":{"type":"object","description":"Per-assignee lifecycle state within an action","properties":{"assigneeId":{"type":"string","description":"Assignee (manager) identifier"},"status":{"type":"string","description":"This assignee's current lifecycle status","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee first moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee reached a terminal status"},"notApplicableReason":{"type":"string","description":"Reason this assignee recorded when moving to NOT_APPLICABLE; null otherwise."},"notApplicableAt":{"type":"string","format":"date-time","description":"Timestamp when notApplicableReason was recorded; null otherwise."}}},"EmployeeCharacteristicValueBoolean":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"boolean"}}}]},"EmployeeCharacteristicValueBase":{"type":"object","description":"Base class for employee characteristic values","discriminator":{"propertyName":"questionType","mapping":{"LIST":"#/components/schemas/EmployeeCharacteristicValueList","DATE":"#/components/schemas/EmployeeCharacteristicValueDate","BOOLEAN":"#/components/schemas/EmployeeCharacteristicValueBoolean","TREE":"#/components/schemas/EmployeeCharacteristicValueTree"}},"properties":{"characteristicId":{"type":"string"},"id":{"type":"string"},"questionType":{"$ref":"#/components/schemas/CharacteristicType"}}},"CharacteristicType":{"type":"string","description":"Type of segmentation characteristic","enum":["DATE","LIST","BOOLEAN","TREE"]},"EmployeeCharacteristicValueDate":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"string"}}}]},"EmployeeCharacteristicValueList":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"}}}]},"EmployeeCharacteristicValueTree":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"},"assignedPath":{"type":"array","items":{"type":"string"}},"assignedOn":{"type":"string","format":"date-time"}}}]},"ActionNoteDTO":{"type":"object","description":"A single note appended to the action execution log","properties":{"id":{"type":"string","description":"Note identifier (unique within the parent action)"},"authorId":{"type":"string","description":"User who wrote the note"},"content":{"type":"string","description":"Note body text"},"visibility":{"type":"string","description":"Who can see this note. PRIVATE = only the author; SHARED = all action participants.","enum":["PRIVATE","SHARED"]},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"}}},"Objective":{"type":"object","description":"What the plan is trying to move, and by when","properties":{"focusItems":{"type":"array","description":"Focus indicators (with target values) the plan aims to move.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"horizon":{"type":"string","format":"date-time","description":"Date by which the objective is expected to be reached."}}},"Origin":{"type":"object","description":"Where the plan came from","properties":{"source":{"type":"string","description":"How the plan was originated.","enum":["MANUAL","SUGGESTION","AI","TEMPLATE","COORDINATOR"]},"candidateIds":{"type":"array","description":"Candidate ids this plan was built from; empty for plans created directly by a person.","items":{"type":"string"}}}},"ChangeLogEntry":{"type":"object","description":"One recorded edit against the plan's original proposal","properties":{"changedBy":{"type":"string","description":"Who made the change."},"changedAt":{"type":"string","format":"date-time","description":"When the change was made."},"field":{"type":"string","description":"Which field changed."},"before":{"type":"string","description":"The value before the change, as text."},"after":{"type":"string","description":"The value after the change, as text."}}}}},"paths":{"/api/v1/company/action-plans/{planId}":{"get":{"tags":["Action Plans"],"summary":"Get action plan details","description":"Returns the full action plan with its actions.","operationId":"getPlan","parameters":[{"name":"planId","in":"path","description":"Plan identifier","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Plan found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"404":{"description":"Plan not found in this company","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}}}}}}}
```

## Delete an action plan

> Permanently removes an action plan \*\*and all of its actions\*\* (cascade delete). Only the plan owner or an admin can delete (BREAKING: previously the creator); legacy plans without a recorded owner report their creator as the owner. Returns 204 on success, 403 when the caller is not allowed, 404 when not found.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}}},"paths":{"/api/v1/company/action-plans/{planId}":{"delete":{"tags":["Action Plans"],"summary":"Delete an action plan","description":"Permanently removes an action plan **and all of its actions** (cascade delete). Only the plan owner or an admin can delete (BREAKING: previously the creator); legacy plans without a recorded owner report their creator as the owner. Returns 204 on success, 403 when the caller is not allowed, 404 when not found.","operationId":"deletePlan","parameters":[{"name":"planId","in":"path","description":"Plan identifier","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Plan and all its actions deleted"},"403":{"description":"Caller is neither the owner nor an admin"},"404":{"description":"Plan not found in this company"}}}}}}
```

## Update action plan (also reachable as PATCH .../{planId}/proposal)

> Applies a partial update to an action plan. Only non-null fields are updated. This is also how the owner edits a PROPOSED plan before approving it — title, description, objective (focus items and horizon) and period — with every applied change appended to the plan's change log while it is still PROPOSED. The \`.../{planId}/proposal\` path is the same operation under the explicit name the pre-approval editing flow uses. To add, remove or reassign the plan's actions, use the action endpoints (POST/PATCH/DELETE /v1/company/actions) with this plan's id — they apply the same owner-or-admin check and change log.

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[{"name":"Action Plans","description":"Create and manage action plans — named containers that group improvement actions under a shared goal. Every action must belong to a plan."}],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"UpdateActionPlanRequestDTO":{"type":"object","description":"Request payload for updating an action plan. Only non-null fields are applied.","properties":{"title":{"$ref":"#/components/schemas/MultiLanguage","description":"New title for the plan (multilingual, null = no change)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"New description for the plan (multilingual, null = no change)"},"visibility":{"type":"string","description":"New visibility. Null means no change.","enum":["PUBLIC","PRIVATE"]},"objective":{"$ref":"#/components/schemas/Objective","description":"New objective — what the plan is trying to move, and by when. Null means no change; replaces the objective wholesale when provided."},"period":{"type":"string","format":"date-time","description":"New period (first day of the plan's month). Null means no change."}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"Objective":{"type":"object","description":"What the plan is trying to move, and by when","properties":{"focusItems":{"type":"array","description":"Focus indicators (with target values) the plan aims to move.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"horizon":{"type":"string","format":"date-time","description":"Date by which the objective is expected to be reached."}}},"ActionFocusItem":{"type":"object","discriminator":{"propertyName":"focusType"},"properties":{"focusType":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"focusId":{"type":"string"},"targetValue":{"type":"number","format":"double"},"targetTimestamp":{"type":"string","format":"date-time"},"noTargetReason":{"type":"string"}}},"CommentThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"commentIds":{"type":"array","items":{"type":"string"}},"linkedIndicators":{"type":"array","items":{"$ref":"#/components/schemas/LinkedIndicator"}},"noLinkReason":{"type":"string"}}}]},"LinkedIndicator":{"type":"object","properties":{"type":{"type":"string","enum":["SCORE","FACTOR","QUESTION","ENPS","HI","INFERRED_THEME","COMMENT_THEME"]},"indicatorId":{"type":"string"}}},"ENPSFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"FactorFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"HIFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"InferredThemeFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"type":"object","properties":{"label":{"type":"string"},"anchorQuestionIds":{"type":"array","items":{"type":"string"}}}}]},"QuestionFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ScoreFocusItem":{"allOf":[{"$ref":"#/components/schemas/ActionFocusItem"}]},"ActionPlanDTO":{"type":"object","description":"Action plan — a named container grouping one or more improvement actions under a shared goal","properties":{"id":{"type":"string","description":"Unique plan identifier"},"companyId":{"type":"string","description":"Company that owns this plan"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the plan's goal (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed description of the plan's objective (multilingual)"},"actions":{"type":"array","description":"Actions belonging to this plan","items":{"$ref":"#/components/schemas/ActionDTO"}},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to the plan creator.","enum":["PUBLIC","PRIVATE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of actions in this plan that have reached COMPLETED status (0–100). Computed on-the-fly; never stored."},"createdBy":{"type":"string","description":"User who created this plan; may be the system for coordinator-proposed plans"},"kind":{"type":"string","description":"Who this plan belongs to.","enum":["MANAGER","HAPPYFORCE"]},"ownerId":{"type":"string","description":"The person accountable for this plan — distinct from createdBy. Legacy plans report the creator here."},"state":{"type":"string","description":"Lifecycle state. Legacy plans report APPROVED.","enum":["PROPOSED","APPROVED","REJECTED","UNATTENDED","IN_PROGRESS","CLOSED"]},"period":{"type":"string","format":"date-time","description":"First day of the month this plan belongs to."},"objective":{"$ref":"#/components/schemas/Objective","description":"What the plan is trying to move, and by when."},"scope":{"type":"array","description":"Hierarchies this plan's audience is scoped to. Empty or null means company-wide.","items":{"type":"string"},"uniqueItems":true},"origin":{"$ref":"#/components/schemas/Origin","description":"Where this plan came from."},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting the objective — never free prose.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the owner's scope (multilingual)."},"changeLog":{"type":"array","description":"Edits the owner made against the original proposal, oldest first. Only populated while editing a PROPOSED plan — see action-plan-lifecycle.","items":{"$ref":"#/components/schemas/ChangeLogEntry"}},"rejectionReason":{"type":"string","description":"Reason recorded when the owner rejected this plan; null otherwise."},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"}}},"ActionDTO":{"type":"object","description":"Complete action payload returned by the API","properties":{"id":{"type":"string","description":"Unique action identifier"},"companyId":{"type":"string","description":"Company that owns this action"},"planId":{"type":"string","description":"Parent action plan identifier. Every action belongs to a plan."},"plan":{"$ref":"#/components/schemas/PlanSummary","description":"Lightweight plan summary (id, title, description)."},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Short title describing the action (multilingual: defaultValue = main language, langValues = translations)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Detailed execution plan describing how and when (multilingual)"},"focusItems":{"type":"array","description":"One or more focus indicators this action is anchored to. At least one is always present.","items":{"oneOf":[{"$ref":"#/components/schemas/ActionFocusItem"},{"$ref":"#/components/schemas/CommentThemeFocusItem"},{"$ref":"#/components/schemas/ENPSFocusItem"},{"$ref":"#/components/schemas/FactorFocusItem"},{"$ref":"#/components/schemas/HIFocusItem"},{"$ref":"#/components/schemas/InferredThemeFocusItem"},{"$ref":"#/components/schemas/QuestionFocusItem"},{"$ref":"#/components/schemas/ScoreFocusItem"}]}},"assigneeStatuses":{"type":"array","description":"Per-assignee lifecycle states. Each entry tracks one manager's individual progress. The global status field is the aggregate of all entries.","items":{"$ref":"#/components/schemas/AssigneeStatusDTO"}},"hierarchyIds":{"type":"array","description":"Areas/hierarchies this action targets. Empty means company-wide scope.","items":{"type":"string"},"uniqueItems":true},"groupIds":{"type":"array","description":"Groups this action targets.","items":{"type":"string"},"uniqueItems":true},"characteristics":{"type":"array","description":"Employee characteristic segments this action targets.","items":{"oneOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBoolean"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueDate"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueList"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueTree"}]},"uniqueItems":true},"actionType":{"type":"string","description":"Scope of the action. MANAGER = individual manager action; COMPANY = cross-team action initiated by an admin.","enum":["MANAGER","COMPANY"]},"source":{"type":"string","description":"How the action was originated. MANUAL = created by the user; SUGGESTION = proposed by a company action; AI = generated by the AI assistant.","enum":["MANUAL","SUGGESTION","AI"]},"visibility":{"type":"string","description":"Visibility scope — PUBLIC means readable by any company manager; PRIVATE restricts to assignees/creator.","enum":["PUBLIC","PRIVATE"]},"role":{"type":"string","description":"The part this action plays within its plan.","enum":["EXECUTE","COORDINATE","ACCOMPANY","ENABLE"]},"status":{"type":"string","description":"Aggregate lifecycle status (computed from all assignee states).","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"completionPercent":{"type":"integer","format":"int32","description":"Percentage of assignees who have individually reached COMPLETED status (0–100). Computed on-the-fly from assigneeStatuses; never stored."},"dueDate":{"type":"string","format":"date-time","description":"Target completion date"},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when the first assignee moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when all assignees reached a terminal status"},"createdBy":{"type":"string","description":"User who created this action"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Last modification timestamp"},"notes":{"type":"array","description":"Execution log notes (bitácora). Visibility-filtered: PRIVATE notes are only returned when the caller is the author. Not populated in list responses — only in single-action detail (GET /actions/{id}).","items":{"$ref":"#/components/schemas/ActionNoteDTO"}},"evidence":{"type":"array","description":"Data references (brief/metric refs) supporting this action, when it was proposed by the coordinator — never free prose. Empty for actions created directly by a person.","items":{"type":"string"}},"whyCard":{"$ref":"#/components/schemas/MultiLanguage","description":"Three-sentence rationale built from data in the assignee's own scope, when this action was proposed by the coordinator; null otherwise."}}},"PlanSummary":{"type":"object","description":"Lightweight plan reference — id, title and description only","properties":{"id":{"type":"string","description":"Plan identifier"},"title":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan title (multilingual)"},"description":{"$ref":"#/components/schemas/MultiLanguage","description":"Plan goal description (multilingual)"}}},"AssigneeStatusDTO":{"type":"object","description":"Per-assignee lifecycle state within an action","properties":{"assigneeId":{"type":"string","description":"Assignee (manager) identifier"},"status":{"type":"string","description":"This assignee's current lifecycle status","enum":["PENDING_APPROVAL","DRAFT","IN_PROGRESS","COMPLETED","PARTIALLY_COMPLETED","FAILED","EXPIRED","NOT_APPLICABLE"]},"startedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee first moved to IN_PROGRESS"},"completedAt":{"type":"string","format":"date-time","description":"Timestamp when this assignee reached a terminal status"},"notApplicableReason":{"type":"string","description":"Reason this assignee recorded when moving to NOT_APPLICABLE; null otherwise."},"notApplicableAt":{"type":"string","format":"date-time","description":"Timestamp when notApplicableReason was recorded; null otherwise."}}},"EmployeeCharacteristicValueBoolean":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"boolean"}}}]},"EmployeeCharacteristicValueBase":{"type":"object","description":"Base class for employee characteristic values","discriminator":{"propertyName":"questionType","mapping":{"LIST":"#/components/schemas/EmployeeCharacteristicValueList","DATE":"#/components/schemas/EmployeeCharacteristicValueDate","BOOLEAN":"#/components/schemas/EmployeeCharacteristicValueBoolean","TREE":"#/components/schemas/EmployeeCharacteristicValueTree"}},"properties":{"characteristicId":{"type":"string"},"id":{"type":"string"},"questionType":{"$ref":"#/components/schemas/CharacteristicType"}}},"CharacteristicType":{"type":"string","description":"Type of segmentation characteristic","enum":["DATE","LIST","BOOLEAN","TREE"]},"EmployeeCharacteristicValueDate":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"string"}}}]},"EmployeeCharacteristicValueList":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"}}}]},"EmployeeCharacteristicValueTree":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"},"assignedPath":{"type":"array","items":{"type":"string"}},"assignedOn":{"type":"string","format":"date-time"}}}]},"ActionNoteDTO":{"type":"object","description":"A single note appended to the action execution log","properties":{"id":{"type":"string","description":"Note identifier (unique within the parent action)"},"authorId":{"type":"string","description":"User who wrote the note"},"content":{"type":"string","description":"Note body text"},"visibility":{"type":"string","description":"Who can see this note. PRIVATE = only the author; SHARED = all action participants.","enum":["PRIVATE","SHARED"]},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp"}}},"Origin":{"type":"object","description":"Where the plan came from","properties":{"source":{"type":"string","description":"How the plan was originated.","enum":["MANUAL","SUGGESTION","AI","TEMPLATE","COORDINATOR"]},"candidateIds":{"type":"array","description":"Candidate ids this plan was built from; empty for plans created directly by a person.","items":{"type":"string"}}}},"ChangeLogEntry":{"type":"object","description":"One recorded edit against the plan's original proposal","properties":{"changedBy":{"type":"string","description":"Who made the change."},"changedAt":{"type":"string","format":"date-time","description":"When the change was made."},"field":{"type":"string","description":"Which field changed."},"before":{"type":"string","description":"The value before the change, as text."},"after":{"type":"string","description":"The value after the change, as text."}}}}},"paths":{"/api/v1/company/action-plans/{planId}":{"patch":{"tags":["Action Plans"],"summary":"Update action plan (also reachable as PATCH .../{planId}/proposal)","description":"Applies a partial update to an action plan. Only non-null fields are updated. This is also how the owner edits a PROPOSED plan before approving it — title, description, objective (focus items and horizon) and period — with every applied change appended to the plan's change log while it is still PROPOSED. The `.../{planId}/proposal` path is the same operation under the explicit name the pre-approval editing flow uses. To add, remove or reassign the plan's actions, use the action endpoints (POST/PATCH/DELETE /v1/company/actions) with this plan's id — they apply the same owner-or-admin check and change log.","operationId":"updatePlan_1","parameters":[{"name":"planId","in":"path","description":"Plan identifier","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/UpdateActionPlanRequestDTO"}}},"required":true},"responses":{"200":{"description":"Plan updated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"400":{"description":"No updatable fields provided, or plan not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}},"404":{"description":"Plan not found in this company","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ActionPlanDTO"}}}}}}}}}
```
