Skip to content

Discard working-tree changes to files (checkout / clean)

POST
/api/workspaces/{workspaceId}/apps/{id}/git/discard
curl --request POST \
--url http://localhost:8080/api/workspaces/example/apps/example/git/discard \
--header 'Content-Type: application/json' \
--cookie auth_session=<auth_session> \
--data '{ "paths": [ "example" ] }'

Repo-relative paths. The box’s fresh status is pushed to every open window right after, so the Source Control view updates at once.

workspaceId
required
string
id
required
string
Media typeapplication/json
object
paths
required
Array<string>
>= 1 items <= 500 items

Example generated

{
"paths": [
"example"
]
}

Successful response

Media typeapplication/json
object
success

Whether the request succeeded.

boolean
data

Endpoint-specific response payload.

message
string
error
string

Example

{
"message": "Operation completed",
"error": "Error message"
}

Invalid request

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}

Internal server error

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}