---
title: "End a relationship episode"
method: POST
path: "/api/v1/ackdb/entity-relationships/{relationshipId}/end"
tags: ["ackDB"]
---

# End a relationship episode

`POST /api/v1/ackdb/entity-relationships/{relationshipId}/end`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/entity-relationships/{relationshipId}/end`
- Auth: HTTP bearer

Idempotent once ended. Emits entity.relationship.ended only when changed=true.

## Path parameters

- `relationshipId` string, required

## Request body

- object
  - `effectiveTo` string, date-time
  - `reason` string
  - `actor` string

## Response `200`

Company relationship mutation result

- object
  - `data` AckdbCompanyRelationship, required: One explicit child-to-parent episode between distinct company entities. Multiple parents, multiple children, and cycles are valid.
    - `relationshipId` string, required
    - `class` string, required
    - `childCompany` AckdbCompanyGraphCompany, required
      - `entityId` string, required
      - `name` string, nullable, required
      - `domain` string, nullable, required
      - `status` string, required
      - `graphOnly` boolean, required
    - `parentCompany` AckdbCompanyGraphCompany, required
      - `entityId` string, required
      - `name` string, nullable, required
      - `domain` string, nullable, required
      - `status` string, required
      - `graphOnly` boolean, required
    - `relationshipType` string, required
    - `childToParentLabel` string, required
    - `parentToChildLabel` string, required
    - `state` 'active' | 'ended' | 'retracted', required
    - `effectiveFrom` string, date-time, required
    - `effectiveTo` string, date-time, nullable, required
    - `retractedAt` string, date-time, nullable, required
    - `provenance` AckdbCompanyRelationshipProvenance, required
      - `source` string, required
      - `workflow` string
      - `externalRecordId` string
      - `evidenceUrl` string, uri
      - `observedAt` string, date-time
      - `metadata` object
    - `createdBy` string, nullable, required
    - `endedBy` string, nullable, required
    - `endedReason` string, nullable, required
    - `retractedBy` string, nullable, required
    - `retractedReason` string, nullable, required
    - `createdEventId` string, nullable, required
    - `endedEventId` string, nullable, required
    - `retractedEventId` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `changed` boolean, required

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)