---
title: "Manage stewardship of entities in batch"
method: POST
path: "/catalog/v1/stewardship/batch/manage"
tags: ["Stewardship"]
---

# Manage stewardship of entities in batch

`POST /catalog/v1/stewardship/batch/manage`

## Request

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

Change the stewardship of up to 100 entities in one call.

Each item carries its own entity, group, and access level, so a single request can transfer different entities to different groups.

Each item accepts the same fields and behaves the same way as a single-entity request: 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, and the change is published immediately.
Omitting `groupUrn` leaves that entity's assigned stewardship unchanged.

Each item is processed independently: a failure on one item, for example, because the entity doesn't exist or you
don't have access to it, doesn't affect the other items.

Results are returned in the same order as the request items. Each item can also include an optional `id`, which
is returned in the corresponding result so that you can match results to request items.

At least one entity is required, and at most 100 entities can be changed per request.

## Request body

- object
  - `data` ManageStewardshipBatchItem[], required
    - `id` string: Caller-supplied correlation identifier echoed back in the corresponding result item.
    - `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 `207`

Batch request processed. The `meta` summary reports the totals (`total`, `success`, `fail`), and `results` reports the per-item outcomes in the same order as the request items.

Each result reports its own `status`: `OK` when the stewardship change was applied. Any other value indicates failure
and is accompanied by an `error` whose `type` matches the status, for example, `RESOURCE_NOT_FOUND`, `STEWARDSHIP_NOT_SUPPORTED`, or `INVALID_ACCESS_LEVEL`.

Unlike the single-entity endpoint, the batch results don't return the resulting effective stewardship.
To verify the outcome, retrieve the entities with `include=effectiveStewardship`.

- object
  - `meta` BatchOperationMeta, required: Summary of a batch operation outcome. Lets clients assess batch health without iterating every item.
    - `total` integer, required: Number of items in the request.
    - `success` integer, required: Number of items with `OK` status.
    - `fail` integer, required: Number of items with non-`OK` status. `success + fail` equals `total`.
  - `results` ManageStewardshipBatchResultItem[], required
    - `id` string: Caller-supplied correlation identifier echoed back in the corresponding result item.
    - `status` string, required: @ExtensibleEnum Outcome status for this item. `OK` indicates success; any non-`OK` value indicates failure and equals the `type` of the accompanying `error`.
    - `error` ProblemDetail
      - `type` string, required: Error type identifier.
      - `title` string, required: Short, human-readable summary of the problem type.
      - `detail` string, required: Detailed specific explanation of the problem.

## Other responses

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

---

[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)