# Clients

## GET /clients

> List Clients

```json
{"openapi":"3.0.3","info":{"title":"MGR Agency API","version":"1.0.0"},"tags":[{"name":"Clients"}],"servers":[{"url":"https://api.moregoodreviews.com/agency"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer"}},"schemas":{"Member":{"type":"object","properties":{"id":{"type":"integer"},"uuid":{"type":"string"},"role_slug":{"type":"string"},"invite_email":{"type":"string"},"invited_at":{"type":"integer","nullable":true},"joined_at":{"type":"integer","nullable":true},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/Section"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}},"Section":{"type":"object","properties":{"id":{"type":"integer"},"slug":{"type":"string"},"uuid":{"type":"string"}}},"Project":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"uuid":{"type":"string"},"is_active":{"type":"boolean"},"is_paused":{"type":"boolean"},"is_suspended":{"type":"boolean"},"features":{"type":"object","description":"Feature flags for the project","additionalProperties":true},"created_at":{"type":"integer"},"updated_at":{"type":"integer"}}}}},"paths":{"/clients":{"get":{"tags":["Clients"],"summary":"List Clients","operationId":"listClients","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Success","properties":{"success":{"type":"boolean"},"code":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Member"}}}}}}}}}}}}
```

## POST /clients

> Create Client

```json
{"openapi":"3.0.3","info":{"title":"MGR Agency API","version":"1.0.0"},"tags":[{"name":"Clients"}],"servers":[{"url":"https://api.moregoodreviews.com/agency"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer"}},"schemas":{"Member":{"type":"object","properties":{"id":{"type":"integer"},"uuid":{"type":"string"},"role_slug":{"type":"string"},"invite_email":{"type":"string"},"invited_at":{"type":"integer","nullable":true},"joined_at":{"type":"integer","nullable":true},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/Section"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}},"Section":{"type":"object","properties":{"id":{"type":"integer"},"slug":{"type":"string"},"uuid":{"type":"string"}}},"Project":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"uuid":{"type":"string"},"is_active":{"type":"boolean"},"is_paused":{"type":"boolean"},"is_suspended":{"type":"boolean"},"features":{"type":"object","description":"Feature flags for the project","additionalProperties":true},"created_at":{"type":"integer"},"updated_at":{"type":"integer"}}}}},"paths":{"/clients":{"post":{"tags":["Clients"],"summary":"Create Client","operationId":"createClient","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","project_ids"],"properties":{"email":{"type":"string","maxLength":100},"role_slug":{"type":"string","nullable":true,"enum":["manager","operator","viewer"]},"project_ids":{"type":"array","items":{"type":"integer"}},"section_ids":{"type":"array","nullable":true,"items":{"type":"integer"}}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Success","properties":{"success":{"type":"boolean"},"code":{"type":"integer"},"data":{"$ref":"#/components/schemas/Member"}}}}}}}}}}}
```

## POST /clients/{client\_id}/resend-invite

> Resend Client Invite

```json
{"openapi":"3.0.3","info":{"title":"MGR Agency API","version":"1.0.0"},"tags":[{"name":"Clients"}],"servers":[{"url":"https://api.moregoodreviews.com/agency"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer"}},"schemas":{"Member":{"type":"object","properties":{"id":{"type":"integer"},"uuid":{"type":"string"},"role_slug":{"type":"string"},"invite_email":{"type":"string"},"invited_at":{"type":"integer","nullable":true},"joined_at":{"type":"integer","nullable":true},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/Section"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}},"Section":{"type":"object","properties":{"id":{"type":"integer"},"slug":{"type":"string"},"uuid":{"type":"string"}}},"Project":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"uuid":{"type":"string"},"is_active":{"type":"boolean"},"is_paused":{"type":"boolean"},"is_suspended":{"type":"boolean"},"features":{"type":"object","description":"Feature flags for the project","additionalProperties":true},"created_at":{"type":"integer"},"updated_at":{"type":"integer"}}}}},"paths":{"/clients/{client_id}/resend-invite":{"post":{"tags":["Clients"],"summary":"Resend Client Invite","operationId":"resendClientInvite","parameters":[{"name":"client_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Success","properties":{"success":{"type":"boolean"},"code":{"type":"integer"},"data":{"$ref":"#/components/schemas/Member"}}}}}}}}}}}
```

## PUT /clients/{client\_id}

> Update Client

```json
{"openapi":"3.0.3","info":{"title":"MGR Agency API","version":"1.0.0"},"tags":[{"name":"Clients"}],"servers":[{"url":"https://api.moregoodreviews.com/agency"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer"}},"schemas":{"Member":{"type":"object","properties":{"id":{"type":"integer"},"uuid":{"type":"string"},"role_slug":{"type":"string"},"invite_email":{"type":"string"},"invited_at":{"type":"integer","nullable":true},"joined_at":{"type":"integer","nullable":true},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/Section"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}},"Section":{"type":"object","properties":{"id":{"type":"integer"},"slug":{"type":"string"},"uuid":{"type":"string"}}},"Project":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"uuid":{"type":"string"},"is_active":{"type":"boolean"},"is_paused":{"type":"boolean"},"is_suspended":{"type":"boolean"},"features":{"type":"object","description":"Feature flags for the project","additionalProperties":true},"created_at":{"type":"integer"},"updated_at":{"type":"integer"}}}}},"paths":{"/clients/{client_id}":{"put":{"tags":["Clients"],"summary":"Update Client","operationId":"updateClient","parameters":[{"name":"client_id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role_slug":{"type":"string","nullable":true,"enum":["manager","operator","viewer"]},"project_ids":{"type":"array","nullable":true,"items":{"type":"integer"}},"section_ids":{"type":"array","nullable":true,"items":{"type":"integer"}}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Success","properties":{"success":{"type":"boolean"},"code":{"type":"integer"},"data":{"$ref":"#/components/schemas/Member"}}}}}}}}}}}
```

## DELETE /clients/{client\_id}

> Delete Client

```json
{"openapi":"3.0.3","info":{"title":"MGR Agency API","version":"1.0.0"},"tags":[{"name":"Clients"}],"servers":[{"url":"https://api.moregoodreviews.com/agency"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer"}}},"paths":{"/clients/{client_id}":{"delete":{"tags":["Clients"],"summary":"Delete Client","operationId":"deleteClient","parameters":[{"name":"client_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Success","properties":{"success":{"type":"boolean"},"code":{"type":"integer"},"data":{"type":"object","nullable":true}}}}}}}}}}}
```