# Move a project card

From **GitHub v3 REST API**.

`POST /projects/columns/cards/{card_id}/moves`

Move a project card

## Parameters

### `card_id`

- Location: path
- Required: true
- Type: `integer`

card_id parameter

## Request body

- Required: true
### `application/json`

- Type: `object`

```json
{"properties":{"column_id":{"description":"The unique identifier of the column the card should be moved to","example":42,"type":"integer"},"position":{"description":"The position of the card in a column. Can be one of: `top`, `bottom`, or `after:\u003ccard_id\u003e` to place after the specified card.","example":"bottom","pattern":"^(?:top|bottom|after:\\d+)$","type":"string"}},"required":["position"],"type":"object"}
```

## Responses

### `201`

Response

### `application/json`

- Type: `object`

```json
{"additionalProperties":false,"type":"object"}
```

### `304`

Not modified

### `401`

Requires authentication

### `application/json`

- Type: `object`

Basic Error

```json
{"description":"Basic Error","properties":{"documentation_url":{"type":"string"},"message":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}},"title":"Basic Error","type":"object"}
```

### `403`

Forbidden

### `application/json`

- Type: `object`

```json
{"properties":{"documentation_url":{"type":"string"},"errors":{"items":{"properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"},"resource":{"type":"string"}},"type":"object"},"type":"array"},"message":{"type":"string"}},"type":"object"}
```

### `422`

Validation failed

### `application/json`

- Type: `object`

Validation Error

```json
{"description":"Validation Error","properties":{"documentation_url":{"type":"string"},"errors":{"items":{"properties":{"code":{"type":"string"},"field":{"type":"string"},"index":{"type":"integer"},"message":{"type":"string"},"resource":{"type":"string"},"value":{"oneOf":[{"nullable":true,"type":"string"},{"nullable":true,"type":"integer"},{"items":{"type":"string"},"nullable":true,"type":"array"}]}},"required":["code"],"type":"object"},"type":"array"},"message":{"type":"string"}},"required":["message","documentation_url"],"title":"Validation Error","type":"object"}
```

### `503`

Response

### `application/json`

- Type: `object`

```json
{"properties":{"code":{"type":"string"},"documentation_url":{"type":"string"},"errors":{"items":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"},"type":"array"},"message":{"type":"string"}},"type":"object"}
```

## Request examples

### cURL

```shell
curl --request POST \
  --url {protocol}://{hostname}/api/v3/projects/columns/cards/{card_id}/moves \
  --header 'content-type: application/json' \
  --data '{
  "column_id": 1,
  "position": "string"
}'
```