---
title: "Manage stewardship of an entity"
method: POST
path: "/catalog/v1/stewardship/manage"
tags: ["Stewardship"]
---

# Manage stewardship of an entity

`POST /catalog/v1/stewardship/manage`

## Request

- Base URL: `https://your-environment.ataccama.one/api`
- URL: `https://your-environment.ataccama.one/api/catalog/v1/stewardship/manage`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/docs/catalog/v1/stewardship/manage/post.ts> (a function with typed inputs; its response is checked against the schema)

Assign, transfer, or clear the stewardship of a single entity.

Stewardship is a configurable trait, so this endpoint accepts any entity type that carries it: catalog items,
terms, sources, and custom entity types alike.

Managing stewardship performs sharing, the same way as [transferring stewardship](https://docs.ataccama.com/ataccama-one-agentic/latest/user-management/assign-stewardship.html#transfer-stewardship) in the web application:

- The entity is shared with the new stewardship group.
- The previous stewardship group keeps access only at the access level given in `previousStewardAccessLevel`.
- Stewardship overrides are removed where needed.

The change is always published: it cannot be applied to a draft.

The response returns the stewardship of the entity after the change was applied.
When the assigned stewardship was cleared, `effectiveStewardship` contains the stewardship inherited from an ancestor, or `null` when no ancestor assigns one.

A request without `groupUrn` applies no change and simply returns the entity's current effective stewardship.

## Request body

- ManageStewardshipRequest: Stewardship change to apply to a single entity.
  - `entityUrn` string, uri, required: A URN identifying a resource in any realm of the Public API. URNs follow RFC 8141. Format: urn:ata:{tenant}:{realm}:{resource-type}:{uuid} Components: - `urn` — fixed scheme - `ata` — Ataccama namespace - `{tenant}` — tenant identifier from the authentication context - `{realm}` — API realm, for example `catalog` or `reference-data` - `{resource-type}` — resource type within the realm, for example `catalog-item` or `table` - `{uuid}` — UUID (v4 or v7) of the resource Example: urn:ata:acme-corp:reference-data:table:123e4567-e89b-12d3-a456-426614174000.
  - `groupUrn` string, uri: A URN identifying a group resource in the IAM API. To find a group's URN, use the Groups endpoints of the IAM API. Format: urn:ata:{tenant}:iam:group:{uuid} Example: urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000.
  - `previousStewardAccessLevel` string: Access level at which the entity is shared with the previous stewardship group so that it doesn't lose access, for example, `viewMetadata`. Must be one of the access levels configured for the entity type in the metadata model. For details, see [Access levels](https://docs.ataccama.com/ataccama-one-agentic/latest/user-management/access-levels.html). When omitted, the previous stewardship group loses access.

## Response `200`

Stewardship change applied.

- ManageStewardshipResult: Stewardship of the entity after the change was applied.
  - `entityUrn` string, uri, required: A URN identifying a resource in any realm of the Public API. URNs follow RFC 8141. Format: urn:ata:{tenant}:{realm}:{resource-type}:{uuid} Components: - `urn` — fixed scheme - `ata` — Ataccama namespace - `{tenant}` — tenant identifier from the authentication context - `{realm}` — API realm, for example `catalog` or `reference-data` - `{resource-type}` — resource type within the realm, for example `catalog-item` or `table` - `{uuid}` — UUID (v4 or v7) of the resource Example: urn:ata:acme-corp:reference-data:table:123e4567-e89b-12d3-a456-426614174000.
  - `effectiveStewardship` EffectiveStewardship, required: The stewardship that applies to an entity: either assigned directly to the entity or inherited from an ancestor, such as the source of a catalog item. Resolving effective stewardship takes additional processing time, so request it only when you need it.
    - `groupUrn` string, uri, required: A URN identifying a group resource in the IAM API. To find a group's URN, use the Groups endpoints of the IAM API. Format: urn:ata:{tenant}:iam:group:{uuid} Example: urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000.
    - `originUrn` string, uri, required: A URN identifying a resource in any realm of the Public API. URNs follow RFC 8141. Format: urn:ata:{tenant}:{realm}:{resource-type}:{uuid} Components: - `urn` — fixed scheme - `ata` — Ataccama namespace - `{tenant}` — tenant identifier from the authentication context - `{realm}` — API realm, for example `catalog` or `reference-data` - `{resource-type}` — resource type within the realm, for example `catalog-item` or `table` - `{uuid}` — UUID (v4 or v7) of the resource Example: urn:ata:acme-corp:reference-data:table:123e4567-e89b-12d3-a456-426614174000.

## Other responses

- `400`: Bad request. The request parameters or body are invalid.
- `403`: Forbidden. You do not have permission to access the requested resource.
- `404`: Not found. The requested resource does not exist.

---

[API](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api.md) - [All operations](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ataccama/apis/ataccama-one-agentic-data-trust-platform-public-api/revisions/46f16e0487f8?raw)