> ## Documentation Index > Fetch the complete documentation index at: https://docs.stardex.com/llms.txt > Use this file to discover all available pages before exploring further. # Update person activity by ID > Update an existing person activity. You can change the content, the activity type, or both. **Content**: Set `content_type` to `"text"` for plain text (auto-converted to HTML) or `"html"` for raw HTML input. **Activity type**: Pass `activity_type` to change the type. The new type must be registered for the team — discover valid types with `GET /v1/person-activities/types`. At least one of `activity_content` or `activity_type` must be provided. ## OpenAPI ````yaml /api-reference/openapi-v1.json patch /v1/person-activities/{id} openapi: 3.1.0 info: title: Stardex API (v1) version: 1.0.0 description: >- Stardex ATS API — manage candidates, jobs, companies, and recruiting workflows. servers: - url: https://api.stardex.ai description: Production API server security: - bearerAuth: [] tags: - name: Persons description: Manage person records — contacts, work history, and custom fields. - name: Jobs description: Manage job postings — pipeline stages, team members, and custom fields. - name: Candidates description: Manage candidate records and pipeline stage transitions. - name: Companies description: Browse and retrieve company records. - name: Lists description: Create, search, and retrieve saved person and company lists. - name: Person Activities description: Create and manage activity records (notes, emails, meetings) for persons. - name: Team Members description: List team members for use in search filters and assignments. - name: Custom Fields description: Retrieve custom field definitions and tag options for search filters. paths: /v1/person-activities/{id}: patch: tags: - Person Activities summary: Update person activity by ID description: >- Update an existing person activity. You can change the content, the activity type, or both. **Content**: Set `content_type` to `"text"` for plain text (auto-converted to HTML) or `"html"` for raw HTML input. **Activity type**: Pass `activity_type` to change the type. The new type must be registered for the team — discover valid types with `GET /v1/person-activities/types`. At least one of `activity_content` or `activity_type` must be provided. operationId: updatePersonActivityById parameters: - in: path name: id required: true schema: type: string description: Person activity ID requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdatePersonActivityBody' responses: '200': description: Activity updated content: application/json: schema: $ref: '#/components/schemas/UpdatePersonActivityResponse' example: success: true data: id: 123e4567-e89b-12d3-a456-426614174000 activity_type: meeting_note updated_at: '2024-03-15T12:00:00Z' '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '404': description: Resource not found content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error components: schemas: UpdatePersonActivityBody: type: object properties: activity_content: type: string description: New content for the activity. Format depends on content_type. content_type: type: string enum: - text - html default: text description: >- Format of activity_content. "text" for plain text (auto-converted to HTML), "html" for raw HTML. activity_type: type: string minLength: 1 description: >- New activity type key. Must be a valid type registered for the team. Standard values: secondary_note, meeting_note, meeting_transcript, email, interview_note, linkedin_message, text_message, candidate_summary, linkedin_message_response, call_note. Teams can also define custom activity types from Settings → Activity Types; discover the full list with GET /v1/person-activities/types. UpdatePersonActivityResponse: type: object properties: success: type: boolean enum: - true data: type: object properties: id: type: string description: Updated activity UUID. activity_type: type: string description: Current activity type key after the update. updated_at: type: string description: ISO 8601 update timestamp. required: - id - activity_type - updated_at required: - success - data securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Authenticate with a Bearer token: API key, OAuth token, or session token. ````