Ana içeriğe geç

Üye Ekle

Organizasyona üye ekler.

Endpoint

POST /api/v1/organizations/\{uuid\}/members

Authentication

Bu endpoint authentication gerektirir.

Header: Authorization: Bearer \{token\}

Permission

  • organizations.manage.members - Tüm organizasyonların üyelerini yönetme
  • organizations.manage.members.own - Sadece kendi organizasyonlarının üyelerini yönetme

Request

Headers

HeaderDeğerZorunlu
AuthorizationBearer \{token\}Evet
Content-Typeapplication/jsonEvet

Path Parameters

ParametreTipZorunluAçıklama
uuidstringEvetOrganizasyon UUID'si

Request Body

ParametreTipZorunluAçıklama
user_idintegerEvet*Kullanıcı ID'si
user_uuidstringEvet*Kullanıcı UUID'si
rolestringHayırÜye rolü (varsayılan: "member")
is_activebooleanHayırAktif durumu (varsayılan: true)

* user_id veya user_uuid'den biri zorunludur.

Example Request

{
"user_uuid": "550e8400-e29b-41d4-a716-446655440001",
"role": "admin",
"is_active": true
}

Response

Success Response (200 OK)

{
"message": "Member attached",
"member": {
"id": 1,
"uuid": "550e8400-e29b-41d4-a716-446655440001",
"email": "user@example.com",
"pivot": {
"organization_id": 1,
"user_id": 1,
"role": "admin",
"is_active": true
}
}
}

Error Responses

404 Not Found

{
"message": "Organization not found"
}

403 Forbidden

{
"message": "Forbidden"
}

Code Examples

cURL

curl -X POST https://api.example.com/api/v1/organizations/550e8400-e29b-41d4-a716-446655440000/members \
-H "Authorization: Bearer \{token\}" \
-H "Content-Type: application/json" \
-d '{
"user_uuid": "550e8400-e29b-41d4-a716-446655440001",
"role": "admin"
}'

Notes

  • Kullanıcı zaten üyeyse, mevcut üyelik güncellenir
  • role değeri belirtilmemişse varsayılan olarak "member" kullanılır