Return asset

POST

/api/assets/{id}/return

curl --request POST \
  --url http://localhost:3000/api/assets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/return \
  --header 'Content-Type: application/json' \
  --cookie session=<session> \
  --data '{ "notes": "example" }'

• Local development
• Dedicated / self-hosted instance

Close the open assignment for this asset.

Authorizations

• cookieAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body

Media type application/json

object

notes

string

Example ^generated

{
  "notes": "example"
}

Responses

200

Assignment closed

Media type application/json

object

data

object

id

required

string format: uuid

assetId

required

string format: uuid

personId

string format: uuid

nullable

userId

string format: uuid

nullable

assignedAt

required

string format: date-time

returnedAt

string format: date-time

nullable

notes

string

nullable

personName

string

nullable

personEmail

string

nullable

Example ^generated

{
  "data": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "assetId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "personId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "userId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "assignedAt": "2026-04-15T12:00:00Z",
    "returnedAt": "2026-04-15T12:00:00Z",
    "notes": "example",
    "personName": "example",
    "personEmail": "example"
  }
}

401

Not authenticated

Media type application/json

object

error

required

string

Example

{
  "error": "Not found"
}

404

No open assignment for this asset

Media type application/json

object

error

required

string

Example

{
  "error": "Not found"
}