---
title: "Remover item"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/remover-item-1"
---
> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md
# Remover item
`DELETE` `/plans/{plan_id}/items/{item_id}`
Operation ID: `remover-item-1`
Com o verbo _HTTP DELETE_, através dos identificadores do item (`plan_item_id`) e do plano (`plan_id`) associado é possível remover um item do plano.
## Path parameters
- `plan_id` (string, required) - Código do plano.
Formato: `plan_XXXXXXXXXXXXXXXX`
- `item_id` (string, required) - Código do item do plano.
Formato: `pi_XXXXXXXXXXXXXXXX`
## Responses
- `200` - 200
- `404` - 404
## OpenAPI definition
```yaml
openapi: 3.1.0
info:
title: Pagar.me v5 API (Legado)
version: 5.0.0
servers:
- url: https://api.stone.com.br/core/v5
paths:
/plans/{plan_id}/items/{item_id}:
delete:
summary: Remover item
description: Com o verbo _HTTP DELETE_, através dos identificadores do item
(`plan_item_id`) e do plano (`plan_id`) associado é possível remover um
item do plano.
operationId: remover-item-1
parameters:
- name: plan_id
in: path
description: "Código do plano.
Formato: `plan_XXXXXXXXXXXXXXXX`"
schema:
type: string
required: true
- name: item_id
in: path
description: "Código do item do plano.
Formato: `pi_XXXXXXXXXXXXXXXX`"
schema:
type: string
required: true
responses:
"200":
description: "200"
content:
application/json:
examples:
Result:
value: |-
{
"id": "pi_eBTaVnXD8Zhb8glr",
"name": "Avaliação física",
"description": "Avaliação + Exame médico",
"cycles": 1,
"status": "deleted",
"created_at": "2016-07-12T18:25:40Z",
"updated_at": "2016-07-12T18:25:40Z",
"deleted_at": "2016-07-15T13:41:02Z",
"pricing_scheme": {
"price": 9990,
"scheme_type": "unit"
},
"plan": {
"id": "plan_21r4CTG0ux77Qv13",
"name": "Plano Gold",
"url": "/plan_21r4CTG0ux77Qv13/academia/plano-gold",
"currency": "BRL",
"interval": "month",
"interval_count": 3,
"billing_type": "prepaid",
"installments": 3,
"status": "active",
"created_at": "2016-07-12T17:25:40Z",
"updated_at": "2016-07-12T17:25:40Z",
"metadata": {
"id": "my_plan_id"
}
}
}
schema:
type: object
properties:
id:
type: string
example: pi_eBTaVnXD8Zhb8glr
name:
type: string
example: Avaliação física
description:
type: string
example: Avaliação + Exame médico
cycles:
type: integer
example: 1
default: 0
status:
type: string
example: deleted
created_at:
type: string
example: 2016-07-12T18:25:40Z
updated_at:
type: string
example: 2016-07-12T18:25:40Z
deleted_at:
type: string
example: 2016-07-15T13:41:02Z
pricing_scheme:
type: object
properties:
price:
type: integer
example: 9990
default: 0
scheme_type:
type: string
example: unit
plan:
type: object
properties:
id:
type: string
example: plan_21r4CTG0ux77Qv13
name:
type: string
example: Plano Gold
url:
type: string
example: /plan_21r4CTG0ux77Qv13/academia/plano-gold
currency:
type: string
example: BRL
interval:
type: string
example: month
interval_count:
type: integer
example: 3
default: 0
billing_type:
type: string
example: prepaid
installments:
type: integer
example: 3
default: 0
status:
type: string
example: active
created_at:
type: string
example: 2016-07-12T17:25:40Z
updated_at:
type: string
example: 2016-07-12T17:25:40Z
metadata:
type: object
properties:
id:
type: string
example: my_plan_id
"404":
description: "404"
content:
application/json:
examples:
Result:
value: |-
{
"message": "Item not found."
}
schema:
type: object
properties:
message:
type: string
example: Item not found.
deprecated: false
security:
- sec0: []
components:
securitySchemes:
sec0:
type: http
scheme: basic
```