المصادقة
مصادقة جلسة التشغيل وإنهاؤها وفحصها. تستخدم الأمثلة وضع الكود في A2A. يتيح MCP وضع الكود نفسه عبر أداةexecute.
الوظائف
auth.authorizations.grant
auth.authorizations.grant.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/authorizations |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
grant_kind | "capability" | "account_owner" | "super_admin" | نعم |
subject_id | str | نعم |
subject_type | "user" | "group" | "service_account" | نعم |
capability_key | str | null | لا |
resource_id | str | null | لا |
resource_type | "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
grant_kind | str | نعم |
id | str | نعم |
subject_id | str | نعم |
subject_type | str | نعم |
capability_key | str | null | لا |
created_at | str | null | لا |
resource_id | str | null | لا |
resource_type | str | null | لا |
revoked_at | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.authorizations.list
auth.authorizations.list.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | GET /v1/public/accounts/{account_id}/auth/authorizations |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
capability_key | str | null | لا |
grant_kind | "capability" | "account_owner" | "super_admin" | null | لا |
include_revoked | bool | لا |
subject_id | str | null | لا |
subject_type | "user" | "group" | "service_account" | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
grant_kind | str | نعم |
id | str | نعم |
subject_id | str | نعم |
subject_type | str | نعم |
capability_key | str | null | لا |
created_at | str | null | لا |
resource_id | str | null | لا |
resource_type | str | null | لا |
revoked_at | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.authorizations.revoke
auth.authorizations.revoke.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | DELETE /v1/public/accounts/{account_id}/auth/authorizations/{grant_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
grant_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
result | {} | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.create
auth.groups.create.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/groups |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
name | str | نعم |
attributes | {} | null | لا |
description | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
id | str | نعم |
keycloak_name | str | نعم |
name | str | نعم |
attributes | {} | لا |
description | str | null | لا |
keycloak_account_id | str | null | لا |
linked_scopes | [{"resource_id": str, "resource_type": str}] | لا |
parent_id | str | null | لا |
path | str | null | لا |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | لا |
subgroup_ids | [str] | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.delete
auth.groups.delete.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
result | {} | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.get
auth.groups.get.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | GET /v1/public/accounts/{account_id}/auth/groups/{group_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
id | str | نعم |
keycloak_name | str | نعم |
name | str | نعم |
attributes | {} | لا |
description | str | null | لا |
keycloak_account_id | str | null | لا |
linked_scopes | [{"resource_id": str, "resource_type": str}] | لا |
parent_id | str | null | لا |
path | str | null | لا |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | لا |
subgroup_ids | [str] | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.invitations.create
auth.groups.invitations.create.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/invitations |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
email | str | نعم |
locale | str | null | لا |
note | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
result | {"assignments": [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}], "email": str, "id": str, "permission_context": {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "status": str, "accepted_at"?: str | null, "accepted_subject_id"?: str | null, "created_at"?: str | null, "expires_at"?: str | null, "note"?: str | null} | {"accepted_subject_id": str, "assignment_count": int, "email": str, "grant_count": int, "group_membership_count": int, "permission_context": {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "role_assignment_count": int, "mode"?: str, "status"?: str} | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.list
auth.groups.list.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | GET /v1/public/accounts/{account_id}/auth/groups |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
id | str | نعم |
keycloak_name | str | نعم |
name | str | نعم |
attributes | {} | لا |
description | str | null | لا |
keycloak_account_id | str | null | لا |
linked_scopes | [{"resource_id": str, "resource_type": str}] | لا |
parent_id | str | null | لا |
path | str | null | لا |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | لا |
subgroup_ids | [str] | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.members.add_group
auth.groups.members.add_group.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/groups |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
child_group_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
group_edges | int | نعم |
groups_seen | int | نعم |
total_edges | int | نعم |
user_edges | int | نعم |
group_id | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.members.add_user
auth.groups.members.add_user.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/users |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
user_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
group_edges | int | نعم |
groups_seen | int | نعم |
total_edges | int | نعم |
user_edges | int | نعم |
group_id | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.members.list
auth.groups.members.list.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | GET /v1/public/accounts/{account_id}/auth/groups/{group_id}/members |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
page | int | لا |
page_size | int | لا |
search | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
page | int | نعم |
page_size | int | نعم |
total | int | نعم |
groups | [{"account_id": str, "id": str, "keycloak_name": str, "name": str, "attributes"?: {}, "description"?: str | null, "keycloak_account_id"?: str | null, "linked_scopes"?: [{"resource_id": str, "resource_type": str}], "parent_id"?: str | null, "path"?: str | null, "permission_context"?: {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "subgroup_ids"?: [str]}] | لا |
linked_scopes | [{"resource_id": str, "resource_type": str}] | لا |
members | [{"resolved": bool, "subject_id": str, "subject_type": str, "group"?: {"account_id": str, "id": str, "keycloak_name": str, "name": str, "attributes"?: {}, "description"?: str | null, "keycloak_account_id"?: str | null, "linked_scopes"?: [{"resource_id": str, "resource_type": str}], "parent_id"?: str | null, "path"?: str | null, "permission_context"?: {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "subgroup_ids"?: [str]} | null, "user"?: {"id": str, "email"?: str | null, "first_name"?: str | null, "last_name"?: str | null, "username"?: str | null} | null}] | لا |
search | str | null | لا |
users | [{"id": str, "email"?: str | null, "first_name"?: str | null, "last_name"?: str | null, "username"?: str | null}] | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.members.remove_group
auth.groups.members.remove_group.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/groups/{child_group_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
child_group_id | str | نعم |
group_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
group_edges | int | نعم |
groups_seen | int | نعم |
total_edges | int | نعم |
user_edges | int | نعم |
group_id | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.members.remove_user
auth.groups.members.remove_user.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | DELETE /v1/public/accounts/{account_id}/auth/groups/{group_id}/members/users/{user_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
user_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
group_edges | int | نعم |
groups_seen | int | نعم |
total_edges | int | نعم |
user_edges | int | نعم |
group_id | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.groups.update
auth.groups.update.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | PATCH /v1/public/accounts/{account_id}/auth/groups/{group_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
group_id | str | نعم |
attributes | {} | null | لا |
description | str | null | لا |
name | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
id | str | نعم |
keycloak_name | str | نعم |
name | str | نعم |
attributes | {} | لا |
description | str | null | لا |
keycloak_account_id | str | null | لا |
linked_scopes | [{"resource_id": str, "resource_type": str}] | لا |
parent_id | str | null | لا |
path | str | null | لا |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | لا |
subgroup_ids | [str] | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.invitations.create
auth.invitations.create.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/invitations |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
assignments | [{"capability_key"?: str | null, "grant_kind"?: "capability" | "account_owner" | "super_admin" | null, "group_id"?: str | null, "resource_id"?: str | null, "resource_type"?: "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null, "role_key"?: str | null}] | نعم |
email | str | نعم |
locale | str | null | لا |
note | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
result | {"assignments": [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}], "email": str, "id": str, "permission_context": {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "status": str, "accepted_at"?: str | null, "accepted_subject_id"?: str | null, "created_at"?: str | null, "expires_at"?: str | null, "note"?: str | null} | {"accepted_subject_id": str, "assignment_count": int, "email": str, "grant_count": int, "group_membership_count": int, "permission_context": {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str}, "role_assignment_count": int, "mode"?: str, "status"?: str} | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.invitations.delete
auth.invitations.delete.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | DELETE /v1/public/accounts/{account_id}/auth/invitations/{invitation_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
invitation_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
result | {} | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.invitations.list
auth.invitations.list.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | GET /v1/public/accounts/{account_id}/auth/invitations |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
email | str | null | لا |
status | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
assignments | [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}] | نعم |
email | str | نعم |
id | str | نعم |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | نعم |
status | str | نعم |
accepted_at | str | null | لا |
accepted_subject_id | str | null | لا |
created_at | str | null | لا |
expires_at | str | null | لا |
note | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.invitations.resend
auth.invitations.resend.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/invitations/{invitation_id}/resend |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
invitation_id | str | نعم |
payload | {"locale"?: str | null} | null | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
assignments | [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}] | نعم |
email | str | نعم |
id | str | نعم |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | نعم |
status | str | نعم |
accepted_at | str | null | لا |
accepted_subject_id | str | null | لا |
created_at | str | null | لا |
expires_at | str | null | لا |
note | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.invitations.update
auth.invitations.update.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | PATCH /v1/public/accounts/{account_id}/auth/invitations/{invitation_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
invitation_id | str | نعم |
assignments | [{"capability_key"?: str | null, "grant_kind"?: "capability" | "account_owner" | "super_admin" | null, "group_id"?: str | null, "resource_id"?: str | null, "resource_type"?: "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | null, "role_key"?: str | null}] | نعم |
note | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
assignments | [{"assignment_kind": str, "position": int, "capability_key"?: str | null, "grant_kind"?: str | null, "group_id"?: str | null, "id"?: str | null, "resource_id"?: str | null, "resource_type"?: str | null, "role_key"?: str | null}] | نعم |
email | str | نعم |
id | str | نعم |
permission_context | {"assigned_bundle_keys"?: [str], "direct_capability_keys"?: [str], "owner_assignments"?: [{"account_id": str}], "resolved_capability_keys"?: [str], "status"?: str, "subject_id"?: str, "subject_type"?: str} | نعم |
status | str | نعم |
accepted_at | str | null | لا |
accepted_subject_id | str | null | لا |
created_at | str | null | لا |
expires_at | str | null | لا |
note | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.login
auth.login.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | لا شيء | المصادقة مطلوبة | لا |
| وضع التنفيذ | sync |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
identifier | str | لا |
email | str | لا |
username | str | لا |
password | str | لا |
service_account_token | str | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
authenticated | bool | نعم |
principal_type | str | نعم |
user_id | str | لا |
service_account_id | str | لا |
email | str | لا |
username | str | لا |
expires_at | str | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.logout
auth.logout.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | لا شيء | المصادقة مطلوبة | لا |
| وضع التنفيذ | sync |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
logged_out | bool | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.role_assignments.create
auth.role_assignments.create.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/role-assignments |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
resource_id | str | نعم |
resource_type | "client" | "account" | "workspace" | "domain" | "dns_record" | "mailbox" | "redirect" | "forwarding" | "credential" | "tenant" | "route" | "proxy" | نعم |
role_key | "viewer" | "editor" | "domain_manager" | "manager" | "dns_manager" | "ip_manager" | "billing_viewer" | "billing_admin" | "credential_manager" | نعم |
subject_id | str | نعم |
subject_type | "user" | "group" | "service_account" | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
expanded_capability_keys | [str] | نعم |
id | str | نعم |
resource_id | str | نعم |
resource_type | str | نعم |
role_key | str | نعم |
subject_id | str | نعم |
subject_type | str | نعم |
created_at | str | null | لا |
revoked_at | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.role_assignments.delete
auth.role_assignments.delete.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | DELETE /v1/public/accounts/{account_id}/auth/role-assignments/{assignment_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
assignment_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
result | {} | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.role_assignments.list
auth.role_assignments.list.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | GET /v1/public/accounts/{account_id}/auth/role-assignments |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
include_revoked | bool | لا |
role_key | "viewer" | "editor" | "domain_manager" | "manager" | "dns_manager" | "ip_manager" | "billing_viewer" | "billing_admin" | "credential_manager" | null | لا |
subject_id | str | null | لا |
subject_type | "user" | "group" | "service_account" | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
expanded_capability_keys | [str] | نعم |
id | str | نعم |
resource_id | str | نعم |
resource_type | str | نعم |
role_key | str | نعم |
subject_id | str | نعم |
subject_type | str | نعم |
created_at | str | null | لا |
revoked_at | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.service_accounts.create
auth.service_accounts.create.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/service-accounts |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
name | str | نعم |
expires_at | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
created_at | str | نعم |
id | str | نعم |
name | str | نعم |
token | str | نعم |
token_last4 | str | نعم |
token_prefix | str | نعم |
token_public_id | str | نعم |
updated_at | str | نعم |
created_by_user_id | str | null | لا |
expires_at | str | null | لا |
last_used_at | str | null | لا |
revoked_at | str | null | لا |
revoked_by_user_id | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.service_accounts.list
auth.service_accounts.list.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | GET /v1/public/accounts/{account_id}/auth/service-accounts |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
include_revoked | bool | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
created_at | str | نعم |
id | str | نعم |
name | str | نعم |
token_last4 | str | نعم |
token_prefix | str | نعم |
token_public_id | str | نعم |
updated_at | str | نعم |
created_by_user_id | str | null | لا |
expires_at | str | null | لا |
last_used_at | str | null | لا |
revoked_at | str | null | لا |
revoked_by_user_id | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.service_accounts.revoke
auth.service_accounts.revoke.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | DELETE /v1/public/accounts/{account_id}/auth/service-accounts/{service_account_id} |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
service_account_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
result | {} | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.service_accounts.rotate
auth.service_accounts.rotate.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | POST /v1/public/accounts/{account_id}/auth/service-accounts/{service_account_id}/rotate |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
service_account_id | str | نعم |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
created_at | str | نعم |
id | str | نعم |
name | str | نعم |
token | str | نعم |
token_last4 | str | نعم |
token_prefix | str | نعم |
token_public_id | str | نعم |
updated_at | str | نعم |
created_by_user_id | str | null | لا |
expires_at | str | null | لا |
last_used_at | str | null | لا |
revoked_at | str | null | لا |
revoked_by_user_id | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.users.list
auth.users.list.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | auth.manage | المصادقة مطلوبة | نعم |
| وضع التنفيذ | sync | الصلاحية | auth.manage |
| نوع المورد | account | حقل معرف المورد | account_id |
| مسار API العام | GET /v1/public/accounts/{account_id}/auth/users |
الوسيطات
الوسيطات
| الاسم | النوع | مطلوب |
|---|---|---|
account_id | str | نعم |
limit | int | لا |
search | str | null | لا |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
id | str | نعم |
email | str | null | لا |
first_name | str | null | لا |
last_name | str | null | لا |
username | str | null | لا |
مثال A2A
مثال A2A
مثال MCP
مثال MCP
auth.whoami
auth.whoami.
| الخاصية | القيمة | الخاصية | القيمة |
|---|---|---|---|
| الإذن المطلوب | لا شيء | المصادقة مطلوبة | لا |
| وضع التنفيذ | sync |
القيم المرجعة
القيم المرجعة
| الحقل | النوع | مطلوب |
|---|---|---|
authenticated | bool | نعم |
user_id | str | لا |
email | str | لا |
username | str | لا |
expires_at | str | نعم |
مثال A2A
مثال A2A
مثال MCP
مثال MCP