---
title: "Update Access Relationship"
method: PUT
path: "/v2/access-relationships/{id}"
tags: ["Access Relationship API"]
---

# Update Access Relationship

`PUT /v2/access-relationships/{id}`

Update an access relationship. You can change the relationship type, target, and target type.

## Path parameters

- `id` string, required — The ID of the access relationship.

## Request body

- object
  - `relationshipType` 'ACCESS_RELATIONSHIP_TYPE_UNSPECIFIED' | 'ACCESS_RELATIONSHIP_TYPE_OWNER'
  - `targetId` string — The ID of the target (user or group).
  - `targetType` 'ACCESS_RELATIONSHIP_TARGET_TYPE_UNSPECIFIED' | 'ACCESS_RELATIONSHIP_TARGET_TYPE_USER' | 'ACCESS_RELATIONSHIP_TARGET_TYPE_GROUP'

## Response `200`

Success

- SvflowPublicapiUpdateAccessRelationshipResponse
  - `data` SvflowPubapimodelsAccessRelationship
    - `id` string — The ID of the access relationship.
    - `relationshipType` 'ACCESS_RELATIONSHIP_TYPE_UNSPECIFIED' | 'ACCESS_RELATIONSHIP_TYPE_OWNER'
    - `targetId` string — The ID of the target (user or group).
    - `targetType` 'ACCESS_RELATIONSHIP_TARGET_TYPE_UNSPECIFIED' | 'ACCESS_RELATIONSHIP_TARGET_TYPE_USER' | 'ACCESS_RELATIONSHIP_TARGET_TYPE_GROUP'
    - `createdAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `subjectType` 'ACCESS_RELATIONSHIP_SUBJECT_TYPE_UNSPECIFIED' | 'ACCESS_RELATIONSHIP_SUBJECT_TYPE_APP_INSTANCE' | 'ACCESS_RELATIONSHIP_SUBJECT_TYPE_RESOURCE' | 'ACCESS_RELATIONSHIP_SUBJECT_TYPE_ENTITLEMENT' | 'ACCESS_RELATIONSHIP_SUBJECT_TYPE_TEAM' — The kind of entity a relationship is on. Generalizes the former app_relationships model (app_instance subjects only) so resources, roles (entitlements), and teams can have owners too.
    - `subjectId` string — The ID of the subject (app_instance_id | resource_id | entitlement_id | team_id), disambiguated by subject_type.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)