Открыть доступ к агенту или изменить роль
PUT
/api/v1/security/agents/{agentId}/access/{subjectType}/{subjectId}AuthorizationBearer <токен>
Access token, привязанный к ключу клиента по RFC 9449: заголовок Authorization: DPoP <token> и заголовок DPoP с доказательством для каждого запроса. Сервер выдаёт DPoP-Nonce, который клиент включает в доказательство.
Передаётся в: header
Параметры пути
agentId*string
Идентификатор агента
Формат
uuidsubjectType*string
Кому открыт доступ: пользователю, группе или всей команде
Значение из
- "user"
- "group"
- "team"
subjectId*string
Идентификатор пользователя, группы или команды
Формат
uuidПараметры заголовков
idempotency-key?string
Ключ идемпотентности для безопасного повтора запроса: 8–255 символов из набора A-Za-z0-9_.:+/=-, ответ кэшируется на 24 ч
Совпадение
^[A-Za-z0-9_.:+/=-]{8,255}$Длина
8 <= length <= 255Тело запроса
application/json
TypeScript-определения
Используйте тип request body в TypeScript.
Тело ответа
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X PUT "https://example.com/api/v1/security/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/access/user/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer <access_token>" \ -H "Content-Type: application/json" \ -d '{ "role": "editor" }'{ "grantedBy": "f4fd0c8b-a7d2-45df-a538-55abc7bde453", "role": "owner", "subjectId": "68460e63-0717-47f9-8fd8-d28f152cb30b", "subjectType": "user", "updatedAt": "string"}