# Remove member from org


[API catalog](/reference/api/) · [Docker Hub overview](/reference/api/hub/latest/) · [Product manual](https://docs.docker.com/docker-hub/) · [OpenAPI specification](/reference/api/hub/latest.yaml)

API version: 2-beta



`DELETE /v2/orgs/{org_name}/members/{username}`

Removes the member from the org, ie. all groups in the org, unless they're the last owner

This operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.


## Connection and access

[API connection and authentication guidance](/reference/api/hub/latest/#authentication)


Server: `https://hub.docker.com`

Effective security: alternatives are OR; schemes within an alternative are AND. An empty array declares no HTTP authentication requirement.

```json
[
  {
    "bearerAuth": []
  }
]
```
## Example request

Replace placeholders and provide the required credentials or request body.

```console
curl \
  --request DELETE \
  --header "Authorization: Bearer ${TOKEN}" \
  'https://hub.docker.com/v2/orgs/myorganization/members/jonsnow'
```

## Parameters

### org_name

Location: path. Required: yes.

Name of the organization (namespace).

```json
{
  "description": "Name of the organization (namespace).",
  "example": "myorganization",
  "in": "path",
  "name": "org_name",
  "pointer": "/paths/~1v2~1orgs~1{org_name}~1members~1{username}/parameters/0",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

### username

Location: path. Required: yes.

Username, identifier for the user (namespace, DockerID).

```json
{
  "description": "Username, identifier for the user (namespace, DockerID).",
  "in": "path",
  "name": "username",
  "pointer": "/paths/~1v2~1orgs~1{org_name}~1members~1{username}/parameters/1",
  "required": true,
  "schema": {
    "example": "jonsnow",
    "type": "string"
  }
}
```

## Request and responses

### Response 204 

Member removed successfully

No response content is declared.






### Response 400 application/json

Bad Request


Schema:

```json
{
  "$ref": "#/components/schemas/error"
}
```




error:
```json
{
  "errinfo": null,
  "message": "bad request"
}
```


### Response 401 application/json

Unauthorized


Schema:

```json
{
  "$ref": "#/components/schemas/error"
}
```




error:
```json
{
  "errinfo": null,
  "message": "unauthorized"
}
```


### Response 403 application/json

Forbidden


Schema:

```json
{
  "$ref": "#/components/schemas/error"
}
```




error:
```json
{
  "errinfo": null,
  "message": "permission denied"
}
```


### Response 404 application/json

Not Found


Schema:

```json
{
  "$ref": "#/components/schemas/error"
}
```




error:
```json
{
  "errinfo": null,
  "message": "not found"
}
```


## Complete operation contract

```json
{
  "description": "Removes the member from the org, ie. all groups in the org, unless they're the last owner\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n",
  "operationId": "deleteV2OrgsByOrgNameMembersByUsername",
  "responses": {
    "204": {
      "description": "Member removed successfully"
    },
    "400": {
      "$ref": "#/components/responses/bad_request"
    },
    "401": {
      "$ref": "#/components/responses/unauthorized"
    },
    "403": {
      "$ref": "#/components/responses/forbidden"
    },
    "404": {
      "$ref": "#/components/responses/not_found"
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "summary": "Remove member from org",
  "tags": [
    "orgs"
  ]
}
```

## Referenced schemas

- `#/components/responses/bad_request`

- `#/components/responses/forbidden`

- `#/components/responses/not_found`

- `#/components/responses/unauthorized`