---
title: "Approve, revoke, or change the role of *subject* (administrators only)."
method: PUT
path: "/api/v1/apps/{app_key}/users/{subject}/access"
---

# Approve, revoke, or change the role of \*subject\* (administrators only).

`PUT /api/v1/apps/{app_key}/users/{subject}/access`

## Request

- Base URL: `https://api.trends.earth/api/v1`
- URL: `https://api.trends.earth/api/v1/api/v1/apps/{app_key}/users/{subject}/access`
- Auth: none declared
- TypeScript: <https://skmtc.dev/trends/apis/trends-earth-api/docs/api/v1/apps/:app_key/users/:subject/access/put.ts> (a function with typed inputs; its response is checked against the schema)

Approve, revoke, or change the role of *subject* (administrators only).

## Path parameters

- `app_key` string, required
- `subject` string, required

## Request body

- object

## Response `200`

Success

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-17** `5b9a4507913b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trends/apis/trends-earth-api/changes/api/v1/apps/:app_key/users/:subject/access/put.md)

---

[API](https://skmtc.dev/trends/apis/trends-earth-api.md) - [All operations](https://skmtc.dev/trends/apis/trends-earth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trends/apis/trends-earth-api/revisions/0b75d1e065e1?raw)